Skip to main content

Function: dropWhile()

dropWhile(iterable, callbackFn)

dropWhile<ElementType, FilteredType>(iterable: IterableResolvable<ElementType>, callbackFn: (element: ElementType, index: number) => element is FilteredType): IterableIterator <Exclude<ElementType, FilteredType>>

Creates a new iterator without the elements that satisfy the specified test.

Type parameters

Type parameter
ElementType
FilteredType

Parameters

ParameterTypeDescription
iterableIterableResolvable<ElementType>An iterator to drop values from.
callbackFn(element: ElementType, index: number) => element is FilteredTypeA function to execute for each element produced by the iterator. It should return a falsy value to make the element yielded by the iterator helper, and a truthy value otherwise.

Returns

IterableIterator <Exclude<ElementType, FilteredType>>

An iterator that produces elements from the given iterator that don't satisfy the specified test.

Example

import { dropWhile } from '@sapphire/iterator-utilities';

const iterable = dropWhile([1, 2, 3, 4, 5], (value) => value < 3);
console.log([...iterable]);
// Output: [3, 4, 5]

Seealso

filter or takeWhile for the opposite behavior.

Source

projects/utilities/packages/iterator-utilities/src/lib/dropWhile.ts:23

dropWhile(iterable, callbackFn)

dropWhile<ElementType>(iterable: IterableResolvable<ElementType>, callbackFn: (element: ElementType, index: number) => boolean): IterableIterator<ElementType>

Type parameters

Type parameter
ElementType

Parameters

ParameterType
iterableIterableResolvable<ElementType>
callbackFn(element: ElementType, index: number) => boolean

Returns

IterableIterator<ElementType>

Source

projects/utilities/packages/iterator-utilities/src/lib/dropWhile.ts:27