Skip to main content
Home

Built and signed on GitHub Actions

Well-tested utility functions dealing with async iterables

This package works with Cloudflare Workers, Node.js, Deno, Bun, Browsers
This package works with Cloudflare Workers
This package works with Node.js
This package works with Deno
This package works with Bun
This package works with Browsers
JSR Score
88%
Published
2 years ago (0.6.0)
function drop
drop<T>(
source: Iterable<T> | AsyncIterable<T>,
count: number,
): AsyncIterableIterator<T>

Drops a specified number of elements from the beginning of an async iterable, and yields the remaining elements.

import { drop } from "./drop.ts";

async function* gen() { yield "foo"; yield "bar"; yield "baz"; yield "qux" }
const iterable = drop(gen(), 2);
for await (const value of iterable) {
  console.log(value);
}

The above example will print the following 2 lines:

baz
qux

If the iterable is shorter than or equal to the specified number, no elements are yielded.

import { drop } from "./drop.ts";

async function* gen() { yield "foo"; yield "bar"; yield "baz"; yield "qux" }
const iterable = drop(gen(), 4);
for await (const value of iterable) {
  console.log(value);
}

The above example will print nothing.

Type Parameters

The type of the elements in the source and the returned async iterable.

Parameters

source: Iterable<T> | AsyncIterable<T>

The async iterable to drop elements from. It can be either finite or infinite.

count: number

The number of elements to drop.

Return Type

AsyncIterableIterator<T>

An async iterable that yields the remaining elements after dropping the first count elements from the source iterable.

New Ticket: Report package

Please provide a reason for reporting this package. We will review your report and take appropriate action.

Please review the JSR usage policy before submitting a report.

Add Package

deno add jsr:@hongminhee/aitertools

Import symbol

import { drop } from "@hongminhee/aitertools";
or

Import directly with a jsr specifier

import { drop } from "jsr:@hongminhee/aitertools";

Add Package

pnpm i jsr:@hongminhee/aitertools
or (using pnpm 10.8 or older)
pnpm dlx jsr add @hongminhee/aitertools

Import symbol

import { drop } from "@hongminhee/aitertools";

Add Package

yarn add jsr:@hongminhee/aitertools
or (using Yarn 4.8 or older)
yarn dlx jsr add @hongminhee/aitertools

Import symbol

import { drop } from "@hongminhee/aitertools";

Add Package

vlt install jsr:@hongminhee/aitertools

Import symbol

import { drop } from "@hongminhee/aitertools";

Add Package

npx jsr add @hongminhee/aitertools

Import symbol

import { drop } from "@hongminhee/aitertools";

Add Package

bunx jsr add @hongminhee/aitertools

Import symbol

import { drop } from "@hongminhee/aitertools";