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