getNamedRangeByName

function getNamedRangeByName(
  spreadsheet: GoogleAppsScript.Spreadsheet.Spreadsheet,
  name: string
): GoogleAppsScript.Spreadsheet.NamedRange | null;

Именованный диапазон — устойчивый способ указать на блок ячеек, который человек может передвинуть по листу. Apps Script отдаёт только весь список, поэтому имена перебираются и сравниваются.

Неопределённое имя даёт null — это случай, который стоит обработать, если шаблон правили руками.

Параметры

Параметр	Тип	Описание
`spreadsheet`	`GoogleAppsScript.Spreadsheet.Spreadsheet`	Таблица, в которой искать.
`name`	`string`	Имя диапазона.

Возвращает

GoogleAppsScript.Spreadsheet.NamedRange | null — именованный диапазон или null, если такого имени нет.

Примеры

Поиск

const spreadsheet = SpreadsheetApp.getActive();

const range = getNamedRangeByName(spreadsheet, "Settings");

range?.getRange().getValues();

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

Исходный код

src/appsscript/sheet/getNamedRangeByName.ts

23 September 2026

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