concat

The concat() function concatenates multiple iterables into a single generator, preserving the order of inputs.

Interactive example

Syntax

function concat<
	const GenericElement extends unknown,
>(
	elements: Iterable<GenericElement>,
): (
	iterator: Iterable<GenericElement>
) => Generator<GenericElement, unknown, unknown>;

function concat<
	const GenericElement extends unknown,
>(
	iterator: Iterable<GenericElement>,
	elements: Iterable<GenericElement>,
	...elementsRest: Iterable<GenericElement>[]
): Generator<GenericElement, unknown, unknown>;

Parameters

• iterator: Source iterable (classic style only).
• elements: Iterable to append at the end.
• elementsRest: Additional iterables appended in order.

Return value

A lazy Generator emitting values from iterator, then elements, then elementsRest in order.

See also

• asyncConcat - Async version supporting AsyncIterable
• flat - Flattens nested iterables
• map - Transforms each emitted value