Метод JavaScript Array.fromAsync()

Array 对象参考手册Объект Array в JavaScript


Пример

Создайте массив из асинхронного итерируемого объекта:

const asyncIterable = (async function* () { for (let i = 0; i < 5; i++) { await new Promise((resolve) => setTimeout(resolve, 10 * i)); yield i; } })(); Array.fromAsync(asyncIterable).then((array) => console.log(array)); // [0, 1, 2, 3, 4]

Попробуйте сами »

Определение и использование

Array.fromAsync() — относительно новый статический метод в JavaScript, который позволяет создать новый массив из асинхронно итерируемого объекта, итерируемого объекта или массивоподобного объекта. Этот метод возвращает Promise, который разрешается в новый экземпляр массива.

Проще говоря, это асинхронная версия Array.from(), специально предназначенная для обработки асинхронных источников данных.


Базовый синтаксис

Array.fromAsync(asyncIterable)
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: Создание массива из асинхронного генератора

Пример

async function* asyncGenerator() {
  yield 1;
  yield 2;
  yield 3;
}

(async () => {
  const result = await Array.fromAsync(asyncGenerator());
  console.log(result); // Вывод: [1, 2, 3]
})();

Пример 2: Создание массива из обычного итерируемого объекта

Пример

const set = new Set([1, 2, 3]);

(async () => {
  const result = await Array.fromAsync(set);
  console.log(result); // Вывод: [1, 2, 3]
})();

Пример 3: Использование функции отображения

Пример

async function* asyncNumbers() {
  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 с пагинацией

Пример

async function* paginatedFetcher() {
  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: Обработка результатов нескольких асинхронных операций

Пример

const promises = [
  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 对象参考手册Объект Array в JavaScript

Другие расширения