Перевод не завершен. Пожалуйста, помогите перевести эту статью с английского.
Это экспериментальная технология
Так как спецификация этой технологии ещё не стабилизировалась, смотрите таблицу совместимости по поводу использования в различных браузерах. Также заметьте, что синтаксис и поведение экспериментальной технологии может измениться в будущих версиях браузеров, вслед за изменениями спецификации.
Метод flat() возвращает новый массив, в котором все элементы вложенных подмассивов были рекурсивно "подняты" на указанный уровень depth.
{{EmbedInteractiveExample("pages/js/array-flatten.html")}}
Исходный код этого интерактивного примера находится на гитхабе. Если вы желаете внести свой вклад в проект интерактивных примеров, пожалуйста, склонируйте https://github.com/mdn/interactive-examples и пришлите нам пул-реквест.
Синтаксис
var newArray = arr.flat(depth);
Параметры
depthНеобязательный- На сколько уровней вложенности уменьшается мерность исходного массива. По-умолчанию 1.
Возвратит
Новый массив с объединенными в него подмассивами.
Примеры
Упрощение вложенных массивов
var arr1 = [1, 2, [3, 4]]; arr1.flat(); // [1, 2, 3, 4] var arr2 = [1, 2, [3, 4, [5, 6]]]; arr2.flat(); // [1, 2, 3, 4, [5, 6]] var arr3 = [1, 2, [3, 4, [5, 6]]]; arr3.flat(2); // [1, 2, 3, 4, 5, 6]
Упрощение и "дырки" в массивах
Метод flat удаляет пустые слоты из массива:
var arr4 = [1, 2, , 4, 5]; arr4.flat(); // [1, 2, 4, 5]
Альтернативы
reduce и concat
var arr1 = [1, 2, [3, 4]]; arr1.flat(); //В одномерный массив arr1.reduce((acc, val) => acc.concat(val), []);// [1, 2, 3, 4]
//для глубокого упрощения используем рекурсивно reduce и concat
var arr1 = [1,2,3,[1,2,3,4, [2,3,4]]];
function flattenDeep(arr1) {
return arr1.reduce((acc, val) => Array.isArray(val) ? acc.concat(flattenDeep(val)) : acc.concat(val), []);
}
flattenDeep(arr1);// [1, 2, 3, 1, 2, 3, 4, 2, 3, 4]
//не рекурсивное упрощение с использованием стэка
var arr1 = [1,2,3,[1,2,3,4, [2,3,4]]];
function flatten(input) {
const stack = [...input];
const res = [];
while (stack.length) {
// забираем последнее значение
const next = stack.pop();
if (Array.isArray(next)) {
// добавляем к массиву элементы не модифицируя исходное значение
stack.push(...next);
} else {
res.push(next);
}
}
//разворачиваем массив, чтобы восстановить порядок элементов
return res.reverse();
}
flatten(arr1);// [1, 2, 3, 1, 2, 3, 4, 2, 3, 4]
Спецификации
| Спецификация | Статус | Комментарий |
|---|---|---|
Array.prototype.flat proposal |
Кандидат (3) |
Совместимость с браузерами
| Компьютеры | Мобильные | Server | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Базовая поддержка | Chrome Полная поддержка 69 | Edge Нет поддержки Нет | Firefox Полная поддержка 62 | IE Нет поддержки Нет | Opera Полная поддержка 56 | Safari Полная поддержка 12 | WebView Android Полная поддержка 69 | Chrome Android Полная поддержка 69 | Edge Mobile Нет поддержки Нет | Firefox Android Полная поддержка 62 | Opera Android Полная поддержка 56 | Safari iOS Полная поддержка 12 | Samsung Internet Android Нет поддержки Нет | nodejs Полная поддержка 11.0.0 |
Легенда
- Полная поддержка
- Полная поддержка
- Нет поддержки
- Нет поддержки
- Экспериментальная. Ожидаемое поведение может измениться в будущем.
- Экспериментальная. Ожидаемое поведение может измениться в будущем.