Collection.first()

Syntax

collection.first(callback)

Parameters

callback: Function

[optional] function (item) { }

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 reject, calling any Promise.catch() callback.