javascriptvline

JavaScript return value: What does <> mean?


I am trying to use the API in this page.

The definition is like this below:

vline.Promise.<vline.Collection> getMessages([Number opt_limit])

I want to use the return value of this API, however I don't understand what the <> means. I have researched about the JavaScript language but I couldn't find any clues.

My script is:

vlinesession.getPerson(userId).done(function(person) {       
    person.postMessage(msg); //it works.
    var log = person.getMessages(20); //how can I parse 'log'?
}

Can anyone give me a hint or some samples on how to use this API?


Solution

  • @cbuckley is correct in his description, but I want to expand on it and give an example.

    vline.Promise.<vline.Collection> getMessages([Number opt_limit])
    

    This indicates that it is returning a vline.Promise with the result to the success callback being of type vline.Collection.

    Here's an example:

    vlinesession.getPerson(userId).done(function(person) {       
        person.getMessages().done(function(msgCollection) {   // msgCollection is a vline.Collection of vline.Message's
            for (var i = 0; i < msgCollection.getSize(); i++) {
                var msg = msgCollection.getAt(i);       // this is the vline.Message
                console.log('Message from: ' + msg.getSender() + 
                            ' with body: ' + msg.getBody());
            }
        }); 
    });
    

    Note that I left out the fail handlers for brevity, but you should include those as well to make your code robust.