prependRow

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

prependRows avec une seule ligne : la place est faite d'abord, donc rien de ce qui existe n'est écrasé. Une feuille reçoit la ligne tout en haut ; une plage la reçoit juste au-dessus de sa première ligne, les valeurs étant écrites sur les colonnes de la plage.

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

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 seule ligne : un tableau plat, une valeur par colonne.
`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 un tableau plat.

Exemples

Insertion en haut d'une feuille

const sheet = SpreadsheetApp.getActiveSheet();

prependRow(sheet, ["Name", "Email"]);

Insertion au niveau d'une plage

const sheet = SpreadsheetApp.getActiveSheet();

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

Voir aussi

Code source

src/appsscript/sheet/prependRow.ts

23 September 2026

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