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) на основі вихідного коду бібліотеки.