Collection.first()
Syntax
Parameters
callback: Function
function (item) { }
optional
Callback Parameters
item: Object
First item in the collection if any. Otherwise undefined
Return Value
Promise
Remarks
If callback is omitted and operation succeeds, returned Promise will resolve with the result of the operation, calling any Promise.then() callback.
If callback is specified and operation succeeds, given callback will be called and the returned Promise will resolve with the return value of given callback.
If operation fails, returned promise will be rejected, calling any Promise.catch() callback.