setPath

function setPath<T extends object>(
  target: T,
  path: string | Array<string | number>,
  value: unknown
): T;

Les maillons manquants sont créés en chemin : un segment numérique fabrique un tableau, un segment textuel un objet. setPath({}, ["rows", 0, "id"], 7) donne donc { rows: [{ id: 7 }] }.

La cible est modifiée sur place puis renvoyée : l'appel s'insère dans une expression mais ne copie rien.

Paramètres

Paramètre	Type	Description
`target`	`T`	L'objet où écrire. Il est modifié.
`path`	`string \\| Array<string \\| number>`	Une chaîne pointée, ou un tableau de clés et d'indices.
`value`	`unknown`	La valeur à écrire.

Valeur de retour

T — le même objet, portant désormais la valeur.

Exceptions

Exception	Condition
`IllegalArgumentException`	la cible n'est pas un objet, ou le chemin est vide.

Exemples

Écriture

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

Voir aussi

Code source

src/lang/object/setPath.ts

23 September 2026

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