setPath

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

Недостающие звенья создаются по дороге: числовой сегмент даёт массив, строковый — объект. Поэтому setPath({}, ["rows", 0, "id"], 7) возвращает { rows: [{ id: 7 }] }.

Целевой объект изменяется на месте и возвращается: вызов удобно встраивать в выражение, но копии он не делает.

Параметры

Параметр	Тип	Описание
`target`	`T`	Объект, в который пишем. Он изменяется.
`path`	`string \\| Array<string \\| number>`	Строка через точку или массив ключей и индексов.
`value`	`unknown`	Записываемое значение.

Возвращает

T — тот же объект, уже с записанным значением.

Исключения

Исключение	Условие
`IllegalArgumentException`	цель не объект или путь пуст.

Примеры

Запись

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

Смотрите также

Исходный код

src/lang/object/setPath.ts

23 September 2026

Эта документация сгенерирована нейросетью (Claude) на основе исходного кода библиотеки.