prependRow

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

prependRows з одним рядком: спершу звільняється місце, тож ніщо з наявного не перезаписується. Аркуш отримує рядок угорі; діапазон — просто над своїм першим рядком, а значення пишуться за стовпцями діапазону.

Клітинка, текст якої починається з =, записується як формула, а не як текст — за тим самим правилом, що й у редакторі.

Параметри

Параметр	Тип	Опис
`target`	`GoogleAppsScript.Spreadsheet.Sheet \\| GoogleAppsScript.Spreadsheet.Range`	Аркуш, до якого вставляємо, або діапазон, біля якого вставляємо.
`values`	`unknown`	Один рядок: плоский масив, по значенню на стовпець.
`options` (необов'язковий) `= {}`	`PrependRowsOptions \\| null \\| undefined`	`afterFrozenRows` вставляє нижче закріплених рядків, а не на самий верх. Діапазон задає позицію сам, тож там опція нічого не змінює.

Повертає

GoogleAppsScript.Spreadsheet.Sheet — аркуш, щоб виклики можна було об'єднувати в ланцюжок.

Винятки

Виняток	Умова
`IllegalArgumentException`	не передано жодного аргументу.
`InvalidSheetException`	перший аргумент не є ні аркушем, ні діапазоном.
`TypeError`	значення не є плоским масивом.

Приклади

Вставка на початок аркуша

const sheet = SpreadsheetApp.getActiveSheet();

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

Вставка біля діапазону

const sheet = SpreadsheetApp.getActiveSheet();

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

Дивіться також

Вихідний код

src/appsscript/sheet/prependRow.ts

23 September 2026

Цю документацію згенеровано нейромережею (Claude) на основі вихідного коду бібліотеки.