getSheetById

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

Un identifiant survit à un renommage et à un réordonnancement : c'est donc la bonne poignée à ranger dans une propriété ou une configuration. Apps Script n'offre pas de recherche par identifiant, les feuilles sont donc parcourues et comparées.

Le classeur est par défaut celui qui est actif. Une feuille absente donne null plutôt qu'une exception : un identifiant stocké qui ne résout plus est un cas à traiter, pas un plantage.

Paramètres

Paramètre	Type	Description
`sheetId`	`number`	L'identifiant de feuille recherché.
`ss` (facultatif)	`GoogleAppsScript.Spreadsheet.Spreadsheet \\| undefined \\| null`	Le classeur où chercher. Par défaut, celui qui est actif.

Valeur de retour

GoogleAppsScript.Spreadsheet.Sheet | null — la feuille, ou null si aucune ne porte cet identifiant.

Exemples

Recherche

const sheet = getSheetById(0);

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

Voir aussi

Code source

src/appsscript/sheet/getSheetById.ts

23 September 2026

Cette documentation a été générée par une IA (Claude) à partir du code source de la bibliothèque.