getValues

function getValues<T = unknown>(
  target: GoogleAppsScript.Spreadsheet.Sheet | GoogleAppsScript.Spreadsheet.Range,
  config: GetValuesConfig | null | undefined = {}
): T[];

Якщо задано headerRow, кожен рядок приходить об'єктом із ключами за іменами стовпців — саме це робить фільтр читабельним: row.status замість row[4]. За повтору імені перемагає лівий стовпець.

filter звужує набір рядків, offset і limit розбивають решту на сторінки, а mapper вирішує, на що перетворюється кожен уцілілий рядок. display читає значення так, як їх бачить людина: відформатовану дату — як текст, а не як Date. Це інший вміст, а не косметика.

Аркуш читає весь свій діапазон даних; діапазон читає лише себе — це один виклик сервісу по блоку замість усього аркуша. Позиції лишаються від одиниці за аркушем, тож рядок зберігає свій справжній номер, а headerRow вказує рядок аркуша, а не зсув усередині діапазону.

Параметри

Параметр	Тип	Опис
`target`	`GoogleAppsScript.Spreadsheet.Sheet \\| GoogleAppsScript.Spreadsheet.Range`	Аркуш, який читаємо, або діапазон, який читаємо: забираються лише його клітинки.
`config` (необов'язковий) `= {}`	`GetValuesConfig \\| null \\| undefined`	`headerRow`, `display`, `filter`, `offset`, `limit` та `mapper`.

Повертає

T[] — уцілілі рядки в порядку аркуша.

Винятки

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

Приклади

Читання рядків

const sheet = SpreadsheetApp.getActiveSheet();

const active = getValues(sheet, {
  headerRow: 1,
  filter: (row) => row.status === "active",
  mapper: (row) => row.email,
  limit: 100
});

Читання одного блоку

const sheet = SpreadsheetApp.getActiveSheet();

// Only A1:C50 is fetched; the header is row 1 of the sheet.
const rows = getValues(sheet.getRange("A1:C50"), { headerRow: 1 });

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

Вихідний код

src/appsscript/sheet/getValues.ts

23 September 2026

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