requireValidSheetId

function requireValidSheetId(
  value: unknown,
  message: string = "Expected a valid sheet id."
): number;

Apps Script нумерує аркуші з нуля, тому ідентифікатор аркуша — невід'ємне безпечне ціле, те саме правило, що в isCountable. У першого аркуша таблиці ідентифікатор 0.

isX та nonX відповідають на питання й ніколи не переривають виконання; requireX і requireNonX повертають значення або викидають виняток. Схему розібрано в Домовленості про перевірки.

Параметри

Параметр	Тип	Опис
`value`	`unknown`	Значення, яке потрібно перевірити.
`message` (необов'язковий) `= "Expected a valid sheet id."`	`string`	Повідомлення винятку. Якщо не задано, використовується типове повідомлення.

Повертає

number — те саме значення, вже перевірене як ідентифікатор аркуша.

Винятки

Виняток	Умова
`IllegalArgumentException`	значення не є ідентифікатором аркуша.

Приклади

Що проходить, а що ні

requireValidSheetId(0); // => 0
requireValidSheetId(1234567890); // => 1234567890
requireValidSheetId(-1); // throws IllegalArgumentException
requireValidSheetId(1.5); // throws IllegalArgumentException

Дивіться також

Вихідний код

src/appsscript/sheet/requireValidSheetId.ts

23 September 2026

Цю документацію згенеровано нейромережею (Claude) на основі вихідного коду бібліотеки.