getSheetByIndex

function getSheetByIndex(
  sheetIndex: number,
  spreadsheet?: GoogleAppsScript.Spreadsheet.Spreadsheet | undefined | null
): GoogleAppsScript.Spreadsheet.Sheet | null;

Индекс считается от нуля, слева направо, как показаны вкладки. Это позиция, а не тождество: перемещение вкладки меняет результат — поэтому хранить стоит getSheetById.

Индекс за пределами диапазона даёт null, а не исключение.

Параметры

Параметр	Тип	Описание
`sheetIndex`	`number`	Позиция, считая от нуля.
`spreadsheet` (необязательный)	`GoogleAppsScript.Spreadsheet.Spreadsheet \\| undefined \\| null`	Таблица, в которой искать. По умолчанию активная.

Возвращает

GoogleAppsScript.Spreadsheet.Sheet | null — лист или null, если индекс за пределами.

Примеры

Поиск

const first = getSheetByIndex(0);

Смотрите также

Исходный код

src/appsscript/sheet/getSheetByIndex.ts

23 September 2026

Эта документация сгенерирована нейросетью (Claude) на основе исходного кода библиотеки.