setPath

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

Fehlende Glieder entstehen unterwegs: ein numerisches Segment erzeugt ein Array, ein Zeichenketten-Segment ein Objekt. setPath({}, ["rows", 0, "id"], 7) ergibt daher { rows: [{ id: 7 }] }.

Das Ziel wird an Ort und Stelle verändert und zurückgegeben; der Aufruf lässt sich einsetzen, kopiert aber nicht.

Parameter

Parameter	Typ	Beschreibung
`target`	`T`	Das Objekt, in das geschrieben wird. Es wird verändert.
`path`	`string \\| Array<string \\| number>`	Eine Punkt-Zeichenkette oder ein Array aus Schlüsseln und Indizes.
`value`	`unknown`	Der zu schreibende Wert.

Rückgabewert

T — dasselbe Objekt, nun mit dem Wert.

Ausnahmen

Ausnahme	Bedingung
`IllegalArgumentException`	das Ziel ist kein Objekt oder der Pfad ist leer.

Beispiele

Schreiben

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

Siehe auch

Quellcode

src/lang/object/setPath.ts

23 September 2026

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