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