База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Array.prototype.flat: изравняване на вложени масиви

flat връща нов плитък масив и разгъва вложените масиви до зададената дълбочина.

Версия: ECMAScript 2026 draft; example target: Node.js 24.22.2

Синтаксис

array.flat([depth])

array.flat([depth]) създава нов масив и разгъва елементи Array до depth; по подразбиране е 1. Аргументът се отрязва до цяло число: неположителна стойност дава плитко копие, Infinity пълно изравняване. Array-like обект, който не е Array, не се разгъва.

Източникът не се променя и референциите към обекти остават споделени. Дупките в посетените нива се пропускат, затова резултатът може да е по-плътен. Спазва species конструктора; грешки от getter или proxy се разпространяват. Получател null или undefined хвърля TypeError. Примерът изравнява две нива, премахва дупките и пази дължината на източника.

Примери

const source = [1, , [2, , [3]]];
const result = source.flat(2);
console.log(result.join(","), result.length);
console.log(source.length);

Резултат

1,2,3 3
3

Източници