getSheetById

function getSheetById(
  sheetId: number,
  ss?: GoogleAppsScript.Spreadsheet.Spreadsheet | undefined | null
): GoogleAppsScript.Spreadsheet.Sheet | null;

Идентификатор переживает переименование и перестановку — именно поэтому его и стоит хранить в свойствах или конфигурации. В Apps Script нет поиска по идентификатору, поэтому листы перебираются и сравниваются.

Таблица по умолчанию — активная. Отсутствующий лист даёт null, а не исключение: сохранённый идентификатор, который больше не находится, — это случай для обработки, а не падение.

Параметры

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

Возвращает

GoogleAppsScript.Spreadsheet.Sheet | null — лист или null, если такого идентификатора нет.

Примеры

Поиск

const sheet = getSheetById(0);

if (sheet === null) {
  throw new Error("That sheet is gone.");
}

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

Исходный код

src/appsscript/sheet/getSheetById.ts

23 September 2026

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