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