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

CKTIS / JavaScript

Array.prototype.flatMap: преобразуване и изравняване на едно ниво

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

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

Синтаксис

array.flatMap(callbackFn[, thisArg])

array.flatMap(callbackFn[, thisArg]) извиква callbackFn(value, index, array) за съществуващи индекси и разгъва всеки резултат Array с едно ниво в нов масив. Резултат, който не е Array, остава един елемент; по-дълбоко влагане и обикновени array-like обекти не се изравняват допълнително.

Началната дължина се запомня, дупките се пропускат, а плиткият резултат спазва species. Callback може да върне [] за пропускане или няколко стойности за разширяване. Неизвикваем callback или получател null/undefined хвърля TypeError; изключенията се разпространяват. Не изчаква върната Promise. Примерът пропуска дупка и създава две стойности на посещение.

Примери

const source = [1, , 2];
let visits = 0;
const result = source.flatMap(value => { visits++; return [value, value * 10]; });
console.log(result.join(","));
console.log(visits);

Резултат

1,10,2,20
2

Източници