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