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