Async: दस्तावेज़ीकरण को बेहतर उदाहरणों की आवश्यकता है

मैं सहमत हूं, हमें बहुत बेहतर डॉक्स की जरूरत है। मैं async/प्रतीक्षा का उपयोग करने के लिए कई उदाहरणों को बदलना चाहता हूं (या एमओई उदाहरण जोड़ना)। हालाँकि, यह कुछ ऐसा है जिसमें समय लगता है जो मेरे पास इस समय नहीं है।

शायद मैं मदद कर सकता हूँ।

मैं उदाहरणों के साथ कैसे मदद कर सकता हूं?

• अधिक 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 के एक (सरल) वादा-आधारित उदाहरण की तलाश में हूं, यहां तक ​​​​कि async/प्रतीक्षा के बिना भी। अब तक कोई गैर-कॉलबैक उदाहरण नहीं मिला है।

@flatcoding https://github.com/caub/misc/blob/master/utils/promise-concurrent.js , यदि आप await नहीं चाहते हैं, तो आप इसे एक पुनरावर्ती फ़ंक्शन द्वारा प्रतिस्थापित कर सकते हैं

हाय सिरिल @caub ,
आपके जवाब के लिए धन्यवाद। मैं विशेष रूप से 'प्रतीक्षा' के खिलाफ नहीं हूं, बल्कि 'एसिंक' मॉड्यूल के लिए 'अच्छे उदाहरण' के लिए हूं, जिसे मैं शुरू करना चाहता हूं और बुनियादी वादा प्रबंधन के साथ कार्यान्वयन देखना चाहता हूं, जिसमें .then .catch शामिल है।
मैं सामान्य रूप से वादे के साथ एसिंक का उपयोग करके ईमानदारी से संघर्ष करता हूं, इसलिए एसिंक/प्रतीक्षा का उपयोग करने से पहले मैं चरण 1 से शुरू करना चाहता हूं) ...
बीटीडब्ल्यू।, अपना उदाहरण साझा करने के लिए धन्यवाद, मुझे पूरी तरह से यकीन नहीं है कि यह एसिंक मॉड्यूल से कैसे संबंधित है।

मैंने सोचा "सरल वादा-आधारित उदाहरण" से, आपका मतलब किसी पुस्तकालय के बिना एक उदाहरण था

यदि आप इस पुस्तकालय के साथ एक उदाहरण चाहते हैं, तो मुझे यकीन है कि बहुत सारे हैं

ठीक है, इसलिए मैं सामान्य रूप से वादों का उपयोग करने के साथ ठीक हूं, और मैं यह भी समझता हूं कि कॉलबैक शैली में 'async' मॉड्यूल का उपयोग कैसे करें। जैसा कि दस्तावेज़ीकरण में कहा गया है, कॉलबैक की आपूर्ति के बिना यह एक वादा वापस कर देगा। अब तक, मैं उदाहरणों को ठीक नहीं कर सका, कम से कम async.map(Limit) के लिए नहीं। चूंकि यह धागा दस्तावेज़ीकरण में 'बेहतर उदाहरण' के बारे में है, इसलिए मैंने इस पर यहां ध्यान दिया ...
और जैसा कि कहा गया है, मैं वास्तव में इसे नहीं उठा सका और एक वादे के साथ चल रहा था, यहां तक ​​​​कि उस पर एक मुद्दा भी उठाया।

हाय @caub , संग्रह विधियों के लिए दस्तावेज़ों में सुधार करने, कॉलबैक, वादे, और एसिंक/प्रतीक्षा के लिए उपयोग मामलों को जोड़ने पर एक शॉट लिया।

@romanbalyan अच्छा

जिन विधियों का हम सबसे अधिक उपयोग करते हैं वे हैं async.parallel , और async.auto , क्या आप उन्हें भी कवर करने की योजना बना रहे हैं?

नोट: मुझे लगता है कि चीजों को हल्का बनाने के लिए आप async IIFE (async ()=>{ async/प्रतीक्षा उदाहरणों से बच सकते हैं

@caub ,

हां, मैं जल्द ही प्रवाह नियंत्रण को भी कवर करना चाहूंगा। मैं वास्तव में केवल प्रतिक्रिया की प्रतीक्षा कर रहा था यदि संग्रह उदाहरणों के लिए मैंने जो परिवर्तन किए हैं वे यहां अपेक्षाओं से मेल खाते हैं।

@romanbalyan आप क्या कर सकते हैं उस पीआर शाखा को जीथब पेज के रूप में स्थापित करें ( http://romanbalyan.github में पूर्वावलोकन कर

@caub , बहुत अच्छा विचार। ऐसा किया, और अब https://romanbalyan.github.io/async/v3/ पर उपलब्ध होना चाहिए

हाय @caub ,

प्रवाह नियंत्रण विधियों के लिए जोड़ा गया वादा और async/प्रतीक्षा नमूने - async.parallel , async.series , और async.auto

@romanbalyan अच्छा! https://romanbalyan.github.io/async/v3/docs.html#auto

मुझे लगता है कि कॉलबैक और वादों के उदाहरण हमेशा काफी समान होते हैं, शायद उनमें से केवल एक होने के लायक है, वैसे भी जब वादे का उपयोग करते हैं, तो हम एसिंक/प्रतीक्षा के लिए जाते हैं, और यह सामान को हल्का कर देगा

अच्छा सामान और!

@ गोभी

क्या मुझे संग्रह विधियों पर भी वादे के उपयोग के उदाहरण को हटा देना चाहिए?

मुझे लगता है हाँ आप कर सकते थे

इसके अलावा प्रवाह नियंत्रण विधियों के लिए, आप async आंतरिक कार्यों के साथ उदाहरण जोड़ सकते हैं, उदाहरण:

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);
}

@romanbalyan बहुत अच्छा काम। काश मुझे कुछ दिन पहले दस्तावेज़ीकरण का आपका संस्करण मिल जाता! मुझे पता चला कि परीक्षण और त्रुटि से चीजें कैसे काम करती हैं, लेकिन नए उदाहरणों के साथ यह कम दर्दनाक होता :-)
मैं अभी भी कुछ एसिंक विधियों की उपयोगिता पर 100% निश्चित नहीं हूं कि हमारे पास एसिंक/प्रतीक्षा और वादा है। साथ ही साथ 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()])
  )
);