without

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

Verglichen wird mit SameValueZero: without([NaN], NaN) ergibt [], was eine Suche über indexOf nicht kann, weil strikte Gleichheit nie auf NaN passt. -0 und 0 gelten als derselbe Wert.

Die Ausschlüsse werden einmal zu einer Menge gesammelt, der Aufwand bleibt also linear in der Länge des Arrays statt quadratisch wie bei filter plus includes. Zurück kommt ein neues Array, die Eingabe bleibt unverändert. Ohne Ausschlüsse liefert without eine Kopie.

Parameter

Parameter	Typ	Beschreibung
`array`	`T[]`	Das zu filternde Array. Bleibt unverändert.
`...values`	`T[]`	Die auszuschließenden Werte.

Rückgabewert

T[] — ein neues Array ohne diese Werte, in ursprünglicher Reihenfolge.

Ausnahmen

Ausnahme	Bedingung
`TypeError`	`array` ist kein Array.

Beispiele

Werte ausschließen

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]

Die Leerwerte einer Spalte verwerfen

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

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

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

Eine Spalte aus der Kopfzeile entfernen

/**
 * 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");
}

Siehe auch

compact — entfernt die falsy-Werte statt der genannten.
intersect — behält nur die gemeinsamen Werte.
unique — entfernt Dubletten.
Basis-Werkzeuge

Quellcode

src/lang/array/without.ts

23 September 2026

Diese Dokumentation wurde mit KI (Claude) aus dem Quellcode der Bibliothek erzeugt.