requireValidSpreadsheetId
function requireValidSpreadsheetId(value: unknown, message?: string): string;
Mindestens 25 Zeichen aus Buchstaben, Ziffern, Bindestrichen und Unterstrichen — die Id, die in der Tabellen-URL zwischen /d/ und /edit steht. Es wird nichts abgerufen, geprüft wird nur das Format.
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 |
|---|---|---|
|
| Der zu validierende Wert. |
|
| Die Meldung der Ausnahme. Ohne Angabe wird eine Standardmeldung verwendet. |
Rückgabewert
string — denselben Wert, typisiert als eine Tabellen-Id.
Ausnahmen
Ausnahme | Bedingung |
|---|---|
| der Wert ist nicht eine Tabellen-Id. |
Beispiele
Was besteht und was nicht
requireValidSpreadsheetId("1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms"); // => "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms"
requireValidSpreadsheetId("short-id"); // throws IllegalArgumentException
requireValidSpreadsheetId("has space in it and is long enough to pass"); // throws IllegalArgumentException
Siehe auch
Quellcode
23 September 2026
Diese Dokumentation wurde mit KI (Claude) aus dem Quellcode der Bibliothek erzeugt.