For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /reference/fp/difference.md.
Install massaman

    difference (Functional Programming) es-toolkit

    Creates a function that excludes values found in another array. Use it with pipe.

    const result = pipe(array, difference(secondArray));
    Info

    Prefer the original es-toolkit difference in ordinary code. Use this fp variant when composing transformations with pipe.

    Usage

    difference keeps values from the piped array that are not present in secondArray. It preserves the order of the piped array.

    import { difference, pipe } from 'es-toolkit/fp';

pipe([1, 2, 3, 4], difference([2, 4])); // => [1, 3]

    Parameters

    secondArrayreadonly T[]required

    The array containing values to exclude.

    Returns

    A function that maps a readonly T[] to values not found in secondArray.

    (array: readonly T[]) => T[]
    Source: es-toolkit

    Re-exported verbatim from es-toolkit. Implementation, edge cases, and performance behavior are owned upstream. This page mirrors the documentation at the pinned version; the linked source is authoritative.