apps-script-utils (Українська) 2.1.1 Help

isRange

function isRange(value: unknown): value is GoogleAppsScript.Spreadsheet.Range;

У сервісного об'єкта Apps Script немає конструктора, з яким скрипт міг би порівняти значення, тому перевірка читає тег, який об'єкт повідомляє про себе сам: value.toString() === "Range". Звичайний об'єкт з таким самим тегом теж пройде — на практиці це тестовий дубль.

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

Параметри

Параметр

Тип

Опис

value

unknown

Значення, що перевіряється.

Повертає

boolean — true, якщо значення є діапазоном; інакше false.

У TypeScript усередині гілки значення value звужується до GoogleAppsScript.Spreadsheet.Range.

Приклади

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

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

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

Вихідний код

src/appsscript/sheet/isRange.ts

23 September 2026

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