getNamedRangeByName

function getNamedRangeByName(
  spreadsheet: GoogleAppsScript.Spreadsheet.Spreadsheet,
  name: string
): GoogleAppsScript.Spreadsheet.NamedRange | null;

Une plage nommée est la façon stable de désigner un bloc de cellules qu'une personne peut déplacer dans la feuille. Apps Script ne fournit que la liste entière : les noms sont donc parcourus et comparés.

Un nom non défini donne null, cas à traiter lorsqu'un modèle a été modifié à la main.

Paramètres

Paramètre	Type	Description
`spreadsheet`	`GoogleAppsScript.Spreadsheet.Spreadsheet`	Le classeur où chercher.
`name`	`string`	Le nom de la plage.

Valeur de retour

GoogleAppsScript.Spreadsheet.NamedRange | null — la plage nommée, ou null si ce nom n'existe pas.

Exemples

Recherche

const spreadsheet = SpreadsheetApp.getActive();

const range = getNamedRangeByName(spreadsheet, "Settings");

range?.getRange().getValues();

Voir aussi

Code source

src/appsscript/sheet/getNamedRangeByName.ts

23 September 2026

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