@stdlib/utils
Version:
Standard utilities.
46 lines (33 loc) • 1.14 kB
Plain Text
{{alias}}( obj, n, predicate[, thisArg ] )
Tests whether an object contains at least `n` properties
(own and inherited) which pass a test
implemented by a predicate function.
The predicate function is provided three arguments:
- value: object value.
- key: object key.
- obj: the input object.
The function immediately returns upon finding `n` successful properties.
If provided an empty object, the function returns `false`.
Parameters
----------
obj: Object
Input object over which to iterate.
n: number
Minimum number of successful properties.
predicate: Function
Test function.
thisArg: any (optional)
Execution context.
Returns
-------
bool: boolean
The function returns `true` if an object contains at least `n`
successful properties; otherwise, the function returns `false`.
Examples
--------
> function negative( v ) { return ( v < 0 ); };
> var obj = { 'a': 1, 'b': 2, 'c': -3, 'd': 4, 'e': -1 };
> var bool = {{alias}}( obj, 2, negative )
true
See Also
--------