getPath

function getPath<T>(
  source: unknown,
  path: string | Array<string | number>,
  fallback?: T
): T | undefined;

Путь — либо строка через точку, либо массив сегментов; индексы массива передаются числами, как в ["rows", 0, "id"]. Скобочный синтаксис внутри строки не разбирается: "rows[0].id" ничего не найдёт.

Отсутствующее или пустое звено в любом месте пути даёт запасное значение, а не исключение, — ради этого функция и существует вместо a.b.c.

Параметры

Параметр	Тип	Описание
`source`	`unknown`	Значение, из которого читаем.
`path`	`string \\| Array<string \\| number>`	Строка через точку или массив ключей и индексов.
`fallback` (необязательный)	`T`	Возвращается, если путь не разрешается.

Возвращает

T | undefined — значение по пути или запасное значение.

Примеры

Чтение

getPath({ a: { b: 1 } }, "a.b"); // => 1
getPath({}, "a.b", "fallback"); // => "fallback"
getPath({ rows: [{ id: 7 }] }, ["rows", 0, "id"]); // => 7

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

Исходный код

src/lang/object/getPath.ts

23 September 2026

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