without

function without<T>(array: T[], ...values: T[]): T[];

La comparaison suit SameValueZero: without([NaN], NaN) renvoie [], ce qu'un parcours par indexOf ne sait pas faire puisque l'égalité stricte ne correspond jamais à NaN. -0 et 0 se correspondent.

Les exclusions sont rassemblées une fois dans un ensemble, si bien que le coût reste linéaire en la longueur du tableau au lieu du parcours quadratique qu'imposerait filter combiné à includes. Un nouveau tableau est renvoyé ; l'entrée n'est pas modifiée. Sans exclusion, without renvoie une copie.

Paramètres

Paramètre	Type	Description
`array`	`T[]`	Le tableau à filtrer. Il n'est pas modifié.
`...values`	`T[]`	Les valeurs à exclure.

Valeur de retour

T[] — un nouveau tableau sans ces valeurs, dans leur ordre d'origine.

Exceptions

Exception	Condition
`TypeError`	`array` n'est pas un tableau.

Exemples

Exclure des valeurs

without([1, 2, 3, 2], 2); // => [1, 3] — every occurrence
without([1, 2, 3], 2, 3); // => [1]
without([1, 2], 9); // => [1, 2] — nothing to remove
without([NaN, 1], NaN); // => [1]

Écarter les blancs d'une colonne

import { without } from "apps-script-utils";

const names = sheet.getRange("A2:A").getValues().flat();

without(names, "", "N/A"); // the real entries, in sheet order

Retirer une colonne d'une ligne d'en-tête

/**
 * Hides the internal columns from a header row before it is shown to a user.
 */
export function visibleHeader(header: string[]): string[] {
  return without(header, "internalNote", "_rowHash");
}

function visibleHeader(header) {
  return without(header, "internalNote", "_rowHash");
}

Voir aussi

compact — retire les valeurs falsy plutôt que celles qu'on nomme.
intersect — ne garde que les valeurs communes.
unique — retire les doublons.
Utilitaires de base

Code source

src/lang/array/without.ts

23 September 2026

Cette documentation a été générée par une IA (Claude) à partir du code source de la bibliothèque.