without

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

Значения сравниваются по правилу SameValueZero: without([NaN], NaN) возвращает [], чего поиск через indexOf не умеет, потому что строгое равенство никогда не совпадает с NaN. -0 и 0 считаются одним значением.

Исключаемые значения один раз собираются в множество, поэтому стоимость линейна по длине массива, а не квадратична, как у связки filter и includes. Возвращается новый массив, исходный не изменяется. Без исключаемых значений without возвращает копию.

Параметры

Параметр	Тип	Описание
`array`	`T[]`	Массив для фильтрации. Не изменяется.
`...values`	`T[]`	Значения, которые нужно исключить.

Возвращает

T[] — новый массив без этих значений, в исходном порядке.

Исключения

Исключение	Условие
`TypeError`	`array` не является массивом.

Примеры

Исключение значений

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]

Отбрасывание пустых значений столбца

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

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

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

Удаление столбца из строки заголовков

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

Смотрите также

compact — удаляет ложные значения, а не перечисленные.
intersect — оставляет только общие значения.
unique — удаляет повторы.
Базовые утилиты

Исходный код

src/lang/array/without.ts

23 September 2026

Эта документация сгенерирована нейросетью (Claude) на основе исходного кода библиотеки.