prependRows

function prependRows(
  target: GoogleAppsScript.Spreadsheet.Sheet | GoogleAppsScript.Spreadsheet.Range,
  values: unknown,
  options: PrependRowsOptions | null | undefined = {}
): GoogleAppsScript.Spreadsheet.Sheet;

La place est faite d'abord, puis les valeurs y sont écrites : rien de ce qui se trouve déjà dans la feuille n'est écrasé. Avec une feuille, les lignes vont tout en haut ; avec une plage, au-dessus de sa première ligne, et les valeurs sont écrites sur ses colonnes.

Une cellule dont le texte commence par = est écrite comme une formule, pas comme du texte — la règle de l'éditeur.

Un échec pendant l'écriture — service indisponible, feuille supprimée — revient sous la forme de l'erreur levée par le service, avec sa pile. Le verrou du document est relâché dans tous les cas.

Paramètres

Paramètre	Type	Description
`target`	`GoogleAppsScript.Spreadsheet.Sheet \\| GoogleAppsScript.Spreadsheet.Range`	La feuille dans laquelle insérer, ou la plage au niveau de laquelle insérer.
`values`	`unknown`	Une matrice de lignes : un tableau par ligne, tous de même longueur.
`options` (facultatif) `= {}`	`PrependRowsOptions \\| null \\| undefined`	`afterFrozenRows` insère sous les lignes figées plutôt qu'tout en haut. Une plage décide elle-même de la position : l'option n'y change rien.

Valeur de retour

GoogleAppsScript.Spreadsheet.Sheet — la feuille, afin de chaîner les appels.

Exceptions

Exception	Condition
`IllegalArgumentException`	aucun argument n'est passé.
`InvalidSheetException`	le premier argument n'est ni une feuille ni une plage.
`TypeError`	les valeurs ne forment pas une matrice de lignes de même longueur.

Exemples

Insertion en haut d'une feuille

const sheet = SpreadsheetApp.getActiveSheet();

prependRows(sheet, [
  ["Name", "Email"],
  ["Ada", "ada@example.com"]
]);

Insertion au niveau d'une plage

const sheet = SpreadsheetApp.getActiveSheet();

prependRows(sheet.getRange("B4:C13"), [["Name", "Email"]]);

Voir aussi

Code source

src/appsscript/sheet/prependRows.ts

23 September 2026

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