apps-script-utils (Русский) 2.1.1 Help

nonArray

function nonArray<T>(value: T | unknown): value is Exclude<T | unknown, unknown[] | Array<unknown>>;

nonArray(value) — та же проверка, что и !isArray(value), записанная так, чтобы охранное условие читалось как утверждение, а не как отрицание.

Проверка целиком сводится к Array.isArray, поэтому массив из другого фрейма подходит, а похожий на массив объект — arguments, NodeList, { length: 0 } — нет.

isX и nonX отвечают на вопрос и никогда не прерывают выполнение; requireX и requireNonX возвращают значение или выбрасывают исключение. Схема разобрана в Соглашения о проверках.

Параметры

Параметр

Тип

Описание

value

T \| unknown

Проверяемое значение.

Возвращает

boolean — true, если значение не является массивом; иначе false.

В TypeScript внутри ветки значение value сужается до Exclude<T | unknown, unknown[] | Array<unknown>>.

Примеры

Что проходит, а что нет

nonArray("abc"); // => true nonArray({ length: 0 }); // => true nonArray(null); // => true nonArray([]); // => false nonArray([1, 2, 3]); // => false

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

Исходный код

src/lang/base/nonArray.ts

23 September 2026

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