getSheetById

function getSheetById(
  sheetId: number,
  ss?: GoogleAppsScript.Spreadsheet.Spreadsheet | undefined | null
): GoogleAppsScript.Spreadsheet.Sheet | null;

Eine Id übersteht Umbenennen und Umsortieren — deshalb gehört sie in eine Property oder eine Konfiguration. Apps Script bietet keine Suche nach Id, also werden die Blätter durchlaufen und verglichen.

Die Tabelle ist standardmäßig die aktive. Ein nicht vorhandenes Blatt ergibt null statt einer Ausnahme: eine gespeicherte Id, die nicht mehr auflöst, ist ein Fall zum Behandeln, kein Absturz.

Parameter

Parameter	Typ	Beschreibung
`sheetId`	`number`	Die gesuchte Blatt-Id.
`ss` (optional)	`GoogleAppsScript.Spreadsheet.Spreadsheet \\| undefined \\| null`	Die Tabelle, in der gesucht wird. Standardmäßig die aktive.

Rückgabewert

GoogleAppsScript.Spreadsheet.Sheet | null — das Blatt oder null, wenn kein Blatt diese Id trägt.

Beispiele

Nachschlagen

const sheet = getSheetById(0);

if (sheet === null) {
  throw new Error("That sheet is gone.");
}

Siehe auch

Quellcode

src/appsscript/sheet/getSheetById.ts

23 September 2026

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