requireCellGridRange

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

Eine Zeile und eine Spalte, gemessen an den Grenzen und nicht daran, wie der Bereich geschrieben wurde: die Endindizes gehören nicht dazu, eine einzelne Zelle ist also endRowIndex - startRowIndex === 1 und ebenso bei den Spalten. Ein Bereich mit weggelassener Grenze ist in diese Richtung offen und nie eine einzelne Zelle.

isX und nonX beantworten eine Frage und unterbrechen den Ablauf nie; requireX und requireNonX geben den Wert zurück oder werfen. Das Schema erklärt Konventionen der Prüfungen.

Parameter

Parameter	Typ	Beschreibung
`value`	`unknown`	Der zu validierende Wert.
`message` (optional) `= "Expected a grid range covering exactly one cell."`	`string`	Die Meldung der Ausnahme. Ohne Angabe wird eine Standardmeldung verwendet.

Rückgabewert

GridRange — denselben Wert, typisiert als einen Einzelzellbereich.

Ausnahmen

Ausnahme	Bedingung
`InvalidGridRangeException`	der Wert ist nicht ein Einzelzellbereich.

Beispiele

Was besteht und was nicht

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

Siehe auch

Quellcode

src/appsscript/sheet/requireCellGridRange.ts

23 September 2026

Diese Dokumentation wurde mit KI (Claude) aus dem Quellcode der Bibliothek erzeugt.