|
|
||
|---|---|---|
| .. | ||
| docs | ||
| lib | ||
| package.json | ||
| README.md | ||
isIterableLike
Test if a value is
iterable-like.
Usage
var isIterableLike = require( '@stdlib/assert/is-iterable-like' );
isIterableLike( value )
Tests if a value is iterable-like.
var bool = isIterableLike( [] );
// returns <boolean>
bool = isIterableLike( {} );
// returns false
Notes
- In order to be iterable, an
objectmust implement the@@iteratormethod, which, when called, returns an iterator protocol-compliant object. - An iterator protocol-compliant object is an
objecthaving anextmethod following the iterator protocol. - As full iterator compliance is impossible to achieve without evaluating an iterator, this function checks only for interface compliance.
- In environments lacking
Symbol.iteratorsupport, this function always returnsfalse.
Examples
var isIterableLike = require( '@stdlib/assert/is-iterable-like' );
var bool = isIterableLike( [] );
// returns <boolean>
bool = isIterableLike( {} );
// returns false
bool = isIterableLike( null );
// returns false