Mangler.findOne()

Returns the first item of an iterable that passes the test.

Mangler.findOne(collection[, test])

Parameter	Type	Default	Description
collection	Iterable		The collection of values to search.
test	Test	{}	The test expression to check against.

Returns

Returns the first item that passes the test.

---

If called without a test parameter, it returns the first item of the collection.

The collection iterable could be an object, array or mangler object by default. Please note that even though a JavaScript object is iterable, it is not guaranteed that its properties will be evaluated in any particular order.

For more information on test expressions, see Mangler.test().

Example

a = [1, 2, 3, 4];

Mangler.findOne(a);                // Returns 1
Mangler.findOne(a, { $gt: 2 });    // Returns 3