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) на основе исходного кода библиотеки.