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

nonRange

function nonRange<T>(value: T | GoogleAppsScript.Spreadsheet.Range): value is T;

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

У сервисного объекта Apps Script нет конструктора, с которым скрипт мог бы сравнить значение, поэтому проверка читает тег, который объект сообщает о себе сам: value.toString() === "Range". Обычный объект с таким же тегом тоже пройдёт — на практике это тестовый дубль.

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

Параметры

Параметр

Тип

Описание

value

T \| GoogleAppsScript.Spreadsheet.Range

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

Возвращает

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

В TypeScript внутри ветки значение value сужается до T.

Примеры

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

const range = SpreadsheetApp.getActiveRange(); nonRange({}); // => true nonRange(null); // => true nonRange(range); // => false

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

Исходный код

src/appsscript/sheet/nonRange.ts

23 September 2026

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