Repository files navigation

Check if anIterable is empty

More efficient thanArray.from(iterable).length, as it only iterates the first item, which can make a big difference for dynamic iterators, like aGenerator doing an expensive operation.

npm install is-empty-iterable

importisEmptyIterablefrom'is-empty-iterable';isEmptyIterable([]);//=> trueisEmptyIterable(newSet([1,2]));//=> false

Returns aboolean.

Type:Iterable

When using with generators, be aware that generators are consumed after being iterated. This means callingisEmptyIterable() on the same generator instance multiple times will return different results:

function*myGenerator(){yield1;yield2;}constgenerator=myGenerator();isEmptyIterable(generator);//=> falseisEmptyIterable(generator);// Generator is now consumed//=> true

If you need to check the same generator multiple times, create a new generator instance for each check:

function*myGenerator(){yield1;yield2;}isEmptyIterable(myGenerator());//=> falseisEmptyIterable(myGenerator());//=> false