Lúcuma, or eggfruit (Pouteria lucuma) is a subtropical fruit commonly found in Peru, Ecuador, and Chile. It belongs to the same order as the kiwi, brazil nut, and blueberry. This orange-green fruit is quite nutritous, containg a great deal of vitamins and minerals. Although you may not have heard of it, Lúcuma is actually the most popular flavor of ice cream in Peru, exceeding strawberry, chocolate, and vanilla.

Want to get started?

first you need to declare an instance of Lucuma, `connection = new Lucuma("url");`
The result is an object with the below data members:

• (function) _uri
  encodes the queries object into a GET uri string i.e. ?one=two&red=blue
• (unsigned int) attempts
  the number of times a connection to the server was attempted
• (boolean) cache
  whether or not the result should be cached
• (function) callback
  called when data is returned from the server, however do NOT override this, this calls onresponse as well as some other functions
• (object) connection
  establish, terminate, suspend, and resume. Note: terminate cannot be undone, while suspend can by resume
• (float) duration
  the time that should be waited for another call to be made to the server
• (function) getConnectionById
  has one parameter, the id. returns the instance of lucuma with that id
• (int) id
  this instance's id
• (function) onresponse
  called when data is returned from the server
• (function) ontermination
  called with the instance is terminated
• (function) passes
  the number of times a connection was successfully made
• (boolean) paused
  whether or not the instance is paused. Note: use this.connection.suspend, do NOT set paused to true
• (object) queries
  the object that contains all of the queries to be encoded in the url","(function) request
• (function) request
  do not override, this function calls CSSHttpRequest for the given url with queries
• (boolean) terminated
  whether or not the connection if terminated
• (string) url
  passed in the declaration of the instance, but editable, the url to be polled

Lets see it in action!

Here are two examples, one is a BBC Breaking News Agigator and the other is a chat web app.

Need to see some code?

It is this simple:

window.onload = function () { Connection = new Lucuma("news.php"); Connection.onresponse = function (response) { alert(response); }; Connection.connection.establish(); };

So why should I use Lúcuma?