appendColumns

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

Passez une feuille et toute la feuille est examinée ; passez une plage et seules ses cellules le sont, ce qui empêche des données situées plus bas de décaler l'écriture vers la droite. La plage décide aussi des lignes écrites ; pour une feuille, c'est toujours la ligne 1.

Les valeurs forment une matrice de lignes : un tableau par ligne, tous de même longueur. Rien n'est écrasé — l'écriture commence une colonne après la dernière qui contient des données, 0 et false comptant comme des données. La feuille gagne des colonnes si elle est trop étroite.

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 à laquelle ajouter, ou la plage dans laquelle ajouter.
`values`	`unknown`	Une matrice de lignes : un tableau par ligne, tous de même longueur.
`options` (facultatif) `= {}`	`Options \\| null \\| undefined`	`afterFrozenColumns` commence l'écriture après les colonnes figées lorsque les données s'arrêtent avant elles.

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

Ajout à une feuille

const sheet = SpreadsheetApp.getActiveSheet();

appendColumns(sheet, [["total", "=SUM(A2:A)"]]);

Ajout dans une plage

const sheet = SpreadsheetApp.getActiveSheet();

appendColumns(sheet.getRange("A1:D2"), [["a"], ["b"]]);

Voir aussi

Code source

src/appsscript/sheet/appendColumns.ts

23 September 2026

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