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) на основі вихідного коду бібліотеки.