requireValidSheetId

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

Apps Script nummeriert Blätter ab null, eine Blatt-Id ist also eine nicht negative sichere Ganzzahl — dieselbe Regel wie bei isCountable. Das erste Blatt einer Tabelle hat die Id 0.

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 valid sheet id."`	`string`	Die Meldung der Ausnahme. Ohne Angabe wird eine Standardmeldung verwendet.

Rückgabewert

number — denselben Wert, typisiert als eine Blatt-Id.

Ausnahmen

Ausnahme	Bedingung
`IllegalArgumentException`	der Wert ist nicht eine Blatt-Id.

Beispiele

Was besteht und was nicht

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

Siehe auch

Quellcode

src/appsscript/sheet/requireValidSheetId.ts

23 September 2026

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