flat

function flat(source: object, depth: number = Infinity): Record<string, unknown>;

Вкладені об'єкти перетворюються на шляхи через крапку; масиви лишаються цілими, бо їхні індекси — це дані, а не структура. depth зупиняє спуск: 1 розгортає лише перший рівень.

Зворотний хід — getPath, який читає значення за таким самим шляхом.

Параметри

Параметр	Тип	Опис
`source`	`object`	Об'єкт для розгортання. Не має бути масивом.
`depth` (необов'язковий) `= Infinity`	`number`	Скільки рівнів проходити. Будь-яке ціле; типово без обмеження.

Повертає

Record<string, unknown> — новий плоский об'єкт з ключами-шляхами через крапку.

Винятки

Виняток	Умова
`IllegalArgumentException`	значення не є об'єктом.

Приклади

Розгортання

flat({ a: { b: 1 }, c: [1, 2] }); // => { "a.b": 1, "c": [1, 2] }
flat({ a: { b: { c: 1 } } }, 1); // => { "a.b": { "c": 1 } }

Дивіться також

Вихідний код

src/lang/object/flat.ts

23 September 2026

Цю документацію згенеровано нейромережею (Claude) на основі вихідного коду бібліотеки.