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