Async: Документация требует лучших примеров

Я согласен, нам нужны гораздо лучшие документы. Я также хотел бы изменить многие примеры (или добавить несколько примеров), чтобы использовать async / await. Однако это требует времени, которого у меня сейчас нет.

Может, я смогу помочь.

Как я могу помочь с примерами?

• Примеры с большим количеством async / await , меньше с обратными вызовами
• Более конкретные примеры из реальных приложений, за вычетом foo / bar
• Вещи, которые показывают "золотую середину" для Async - вещи, которые сложно обойтись без библиотеки
• Примеры доступны для новичков в Node / JS, которые показывают, как параметры проходят через
• Более подробные примеры, показывающие больше возможностей отдельных методов

Для большинства методов в комментариях JSDoc есть блоки @example . Сходить с ума!

обратите внимание на этот конкретный пример, вы можете сделать

await async.map(['file1','file2','file3'], fs.promises.stat);
// or without async lib
await Promise.all(['file1','file2','file3'].map(name => fs.promises.stat(name))

или если вы хотите получить объект в качестве результата

await async.auto({
  file1: async()=>fs.promises.stat('file1'),
  file2: async()=>fs.promises.stat('file2')
  file3: async()=>fs.promises.stat('file3')
})
// or without async lib
Object.fromEntries(
  await Promise.all(['file1','file2','file3'].map(async name => [name, await fs.promises.stat(name)]))
)

В частности, я ищу (простой) пример async.mapLimit на основе Promise, даже без async / await. Пока не нашел ни одного примера без обратного вызова.

@flatcoding https://github.com/caub/misc/blob/master/utils/promise-concurrent.js , если вам не нужен await , вы можете заменить его рекурсивной функцией

Привет Сирил @caub ,
Спасибо за ваш ответ. Я не особо против «await», скорее ради «хороших примеров» для модуля «async», с которого я хотел бы начать и увидеть реализацию с базовой обработкой Promise, включая .then .catch.
Я честно борюсь с использованием async с обещаниями в целом, поэтому перед использованием async / await я просто хотел бы начать с шага 1) ...
Кстати, спасибо, что поделились своим примером, я не совсем уверен, как это связано с модулем async.

Я подумал, что под "простым примером на основе обещаний" вы имели в виду пример без какой-либо библиотеки.

если вам нужен пример с этой библиотекой, я уверен, что есть много

Верно, в целом я нормально использую Promises, а также понимаю, как использовать модули async в стиле обратного вызова. Как указано в документации, без обратных вызовов он вернет обещание. Пока что я не мог хороших примеров, по крайней мере, для async.map (Limit). Поскольку эта ветка посвящена «лучшим примерам» в документации, я вмешался в это здесь ...
И, как уже было сказано, я действительно не мог запустить его и с помощью Promise, даже поднял вопрос по этому поводу.

Привет, @caub , сделал

@romanbalayan приятно

чаще всего мы используем следующие методы: async.parallel и async.auto Планируете ли вы охватить и их?

примечание: я думаю, вы могли бы избежать использования async IIFE (async ()=>{ в примерах async / await, чтобы упростить задачу

@caub , обновленный пулреквест для удаления IIFE. (Использовал его для локальной проверки, действительно ли образцы работают)

Да, я также хотел бы вскоре рассказать об управлении потоком. На самом деле я просто ждал отзывов, соответствуют ли изменения, которые я внес для примеров коллекций, ожиданиям здесь.

@romanbalayan, что вы могли бы сделать, это настроить эту PR-ветку как страницу github (перейдите в свою вилку async, настройки> Github pages> Source: (выберите свою PR-ветку)), чтобы мы могли предварительно просмотреть ее на http: //romanbalayan.github .io / асинхронный / v3 /

@caub , отличная идея. Сделал это, и теперь он должен быть доступен на https://romanbalayan.github.io/async/v3/

Привет @caub ,

Добавлены образцы Promise и async / await для методов управления потоком - async.parallel , async.series и async.auto

@romanbalayan здорово! https://romanbalayan.github.io/async/v3/docs.html#auto

Я чувствую, что примеры обратного вызова и обещаний всегда очень похожи, вероятно, стоит иметь только один из них, так как в любом случае при использовании обещаний мы бы предпочли использовать async / await, и это облегчило бы материал

Еще хорошие вещи!

@caub

Следует ли мне также удалить пример использования Promises в методах коллекций?

Я думаю да ты мог бы

Также для методов управления потоком вы можете добавить примеры с асинхронными внутренними функциями, например:

const delay = (t, v) => new Promise(r => setTimeout(r, t, v));

try {
    console.time('parallel')
    const results = await async.parallel({
        one: async () => delay(200, 1),
        two: async () => delay(100, 2),
    });
    console.timeLog('parallel', results);
    // parallel: 200ms { one: 1, two: 2 }
}
catch (err) {
    console.log(err);
}

@romanbalayan отличная работа. Хотел бы я найти вашу версию документации несколько дней назад! В конце концов, я выяснил, как все работает, методом проб и ошибок, но с новыми примерами это было бы менее болезненно :-)
Я все еще не уверен на 100% в полезности некоторых асинхронных методов, поскольку у нас есть async / await и Promise.all, а также Promise.allSettled .. В основном мне интересно, есть ли на данный момент собственные эквиваленты всех методов . (?)

const results = await async.parallel({
    one: async () => delay(200, 1),
    two: async () => delay(100, 2),
});

было бы изначально написано:

const results = Object.fromEntries(
  await Promise.all(
    Object.entries({
      one: async () => delay(200, 1),
      two: async () => delay(100, 2),
    })
      .map(async ([k, v]) => [k, await v()])
  )
);