requireCellGridRange

function requireCellGridRange(
  value: unknown,
  message: string = "Expected a grid range covering exactly one cell."
): GridRange;

Один рядок і один стовпець, рахуючи за межами, а не за тим, як діапазон записали: кінцеві індекси не включаються, тому одна комірка — це endRowIndex - startRowIndex === 1 і те саме для стовпців. Діапазон із пропущеною межею відкритий у цей бік і однією коміркою не буває.

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

Параметри

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

Повертає

GridRange — те саме значення, вже перевірене як діапазон з однієї комірки.

Винятки

Виняток	Умова
`InvalidGridRangeException`	значення не є діапазоном з однієї комірки.

Приклади

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

requireCellGridRange({ startRowIndex: 0, endRowIndex: 1, startColumnIndex: 0, endColumnIndex: 1 }); // => { startRowIndex: 0, endRowIndex: 1, startColumnIndex: 0, endColumnIndex: 1 }
requireCellGridRange({ startRowIndex: 0, endRowIndex: 2, startColumnIndex: 0, endColumnIndex: 1 }); // throws InvalidGridRangeException
requireCellGridRange({}); // throws InvalidGridRangeException

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

Вихідний код

src/appsscript/sheet/requireCellGridRange.ts

23 September 2026

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