getPath

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

Der Pfad ist entweder eine Punkt-Zeichenkette oder ein Array von Segmenten; Array-Indizes stehen als Zahlen darin, wie in ["rows", 0, "id"]. Klammernsyntax innerhalb einer Zeichenkette wird nicht ausgewertet: "rows[0].id" findet nichts.

Ein fehlendes oder leeres Glied irgendwo im Pfad liefert den Rückfallwert statt einer Ausnahme — genau dafür steht diese Funktion anstelle von a.b.c.

Parameter

Parameter	Typ	Beschreibung
`source`	`unknown`	Der Wert, aus dem gelesen wird.
`path`	`string \\| Array<string \\| number>`	Eine Punkt-Zeichenkette oder ein Array aus Schlüsseln und Indizes.
`fallback` (optional)	`T`	Wird zurückgegeben, wenn der Pfad ins Leere führt.

Rückgabewert

T | undefined — den Wert am Pfad oder den Rückfallwert.

Beispiele

Lesen

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

Siehe auch

Quellcode

src/lang/object/getPath.ts

23 September 2026

Diese Dokumentation wurde mit KI (Claude) aus dem Quellcode der Bibliothek erzeugt.