getPath

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

Le chemin est soit une chaîne pointée, soit un tableau de segments ; les indices de tableau y figurent en nombres, comme dans ["rows", 0, "id"]. La syntaxe à crochets dans une chaîne n'est pas analysée : "rows[0].id" ne trouve rien.

Un maillon absent ou nul n'importe où sur le chemin renvoie la valeur de repli au lieu de lever, et c'est tout l'intérêt face à a.b.c.

Paramètres

Paramètre	Type	Description
`source`	`unknown`	La valeur d'où lire.
`path`	`string \\| Array<string \\| number>`	Une chaîne pointée, ou un tableau de clés et d'indices.
`fallback` (facultatif)	`T`	Renvoyée lorsque le chemin n'aboutit pas.

Valeur de retour

T | undefined — la valeur au chemin, ou la valeur de repli.

Exemples

Lecture

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

Voir aussi

Code source

src/lang/object/getPath.ts

23 September 2026

Cette documentation a été générée par une IA (Claude) à partir du code source de la bibliothèque.