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

isValidSheetId

function isValidSheetId(value: unknown): value is number;

Apps Script нумерует листы с нуля, поэтому идентификатор листа — неотрицательное безопасное целое, то же правило, что у isCountable. У первого листа таблицы идентификатор 0.

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

Параметры

Параметр

Тип

Описание

value

unknown

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

Возвращает

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

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

Примеры

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

isValidSheetId(0); // => true isValidSheetId(1234567890); // => true isValidSheetId(-1); // => false isValidSheetId(1.5); // => false isValidSheetId("0"); // => false

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

Исходный код

src/appsscript/sheet/isValidSheetId.ts

23 September 2026

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