Метод JavaScript Array.fromAsync()
Пример
Создайте массив из асинхронного итерируемого объекта:
Попробуйте сами »
Определение и использование
Array.fromAsync() — относительно новый статический метод в JavaScript, который позволяет создать новый массив из асинхронно итерируемого объекта, итерируемого объекта или массивоподобного объекта. Этот метод возвращает Promise, который разрешается в новый экземпляр массива.
Проще говоря, это асинхронная версия Array.from(), специально предназначенная для обработки асинхронных источников данных.
Базовый синтаксис
Array.fromAsync(iterable)
Array.fromAsync(arrayLike)
Array.fromAsync(asyncIterable, mapFn)
Array.fromAsync(asyncIterable, mapFn, thisArg)
Описание параметра
asyncIterable: асинхронно итерируемый объект (например, асинхронный генератор)iterable: итерируемый объект (например, массив, строка, Set и т. д.)arrayLike: массивоподобный объект (объект со свойством length и индексированными элементами)mapFn(Необязательно): Функция отображения, которая вызывается для каждого элементаthisArg(Необязательно): Значение, используемое в качестве this при выполнении mapFn
Возвращаемое значение
Возвращает Promise, который разрешается в новый массив.
Поддержка браузеров
Array.fromAsync() — относительно новая возможность, которая по состоянию на 2023 год поддерживается только в новых версиях браузеров:
- Chrome 117+
- Firefox 115+
- Safari 16.4+
- Node.js 21+
Для неподдерживаемых сред вы можете использовать polyfill или реализовать аналогичную функциональность самостоятельно.
Числа в таблице указывают первую версию браузера, которая поддерживает этот метод.
| Метод | |||||
|---|---|---|---|---|---|
| fromAsync() | 117+ | 121+ | 115+ | 16.4+ | 81.0+ |
Примеры использования
Пример 1: Создание массива из асинхронного генератора
Пример
yield 1;
yield 2;
yield 3;
}
(async () => {
const result = await Array.fromAsync(asyncGenerator());
console.log(result); // Вывод: [1, 2, 3]
})();
Пример 2: Создание массива из обычного итерируемого объекта
Пример
(async () => {
const result = await Array.fromAsync(set);
console.log(result); // Вывод: [1, 2, 3]
})();
Пример 3: Использование функции отображения
Пример
yield 1;
yield 2;
yield 3;
}
(async () => {
const result = await Array.fromAsync(asyncNumbers(), x => x * 2);
console.log(result); // Вывод: [2, 4, 6]
})();
Отличия от Array.from()
Хотя Array.fromAsync() и Array.from() выглядят похоже, у них есть несколько ключевых различий:
1. Обработка асинхронных источников данных
Array.fromAsync() может обрабатывать асинхронные итерируемые объекты, а Array.from() — нет.
2. Возвращаемое значение
Array.from() возвращает массив напрямую, а Array.fromAsync() возвращает Promise.
3. Время выполнения
Array.from() выполняется синхронно, а Array.fromAsync() — асинхронно.
Практические сценарии применения
Сценарий 1: Обработка данных API с пагинацией
Пример
let page = 1;
while (true) {
const response = await fetch(`https://api.example.com/data?page=${page}`);
const data = await response.json();
if (data.length === 0) break;
yield* data;
page++;
}
}
(async () => {
const allData = await Array.fromAsync(paginatedFetcher());
console.log(allData); // Объединить данные со всех страниц в один массив
})();
Сценарий 2: Обработка результатов нескольких асинхронных операций
Пример
Promise.resolve(1),
Promise.resolve(2),
Promise.resolve(3)
];
(async () => {
const results = await Array.fromAsync(promises);
console.log(results); // Вывод: [1, 2, 3]
})();
Итог
Array.fromAsync() — мощный инструмент, особенно подходящий для обработки асинхронных коллекций данных. Он упрощает процесс создания массивов из асинхронных источников данных, делая код чище и проще в поддержке. Хотя поддержка браузерами пока не является повсеместной, со временем он станет одним из стандартных методов для обработки асинхронных коллекций данных.
Помните, когда вам нужно создать массив из асинхронного источника данных, Array.fromAsync() — ваш хороший помощник!
Другие расширения
Объект Array в JavaScript