एक्मा TC39 की 71 वीं बैठक में, परियोजना और वादे के चार प्रमुख संयोजकों में से तीसरी, Promise.allSettled के संदर्भ कार्यान्वयन पर विचार किया जाएगा।

लेखक : जेसन विलियम्स (बीबीसी), रॉबर्ट पुमले (ब्लूमबर्ग), मैथियास बिनेंस (Google)
चैंपियन : मथायस बिनेंस (Google)
चरण : 3

पॉडकास्ट के प्रशंसकों के लिए, YouTube पर डुप्लिकेट किया गया ।

परिचय और प्रेरणा

वादों की दुनिया में चार मुख्य संयोजक हैं:

• Promise.all । ES2015। पहले अस्वीकृत / अस्वीकृत वादे पर बंद हो जाता है।
• Promise.race । ES2015। पहले किसी न किसी तरह से हल / सुलझा हुआ वादा बंद कर देता है।
• Promise.any । स्टेज 1. पहले संतुष्ट / पूर्ण किए गए वादे पर खरा उतरता है।
• Promise.allSettled । स्टेज 3 → स्टेज 4. बंद नहीं होता है।

उन सभी को व्यापक रूप से सामान्य उपयोगकर्ता पुस्तकालयों में प्रतिनिधित्व किया जाता है, उनमें से प्रत्येक अपने आप में उपयोगी है और विभिन्न स्थितियों में उपयुक्त है।

इस कॉम्बीनेटर का मुख्य अनुप्रयोग तब होता है जब आप कई अनुरोधों को पूरा करने के तुरंत बाद एक कार्रवाई करना चाहते हैं, चाहे वे सफलता या विफलता में समाप्त हो गए हों। वादों के बाकी संयोजकों को बंद कर दिया जाता है ( शॉर्ट-सर्किट ), इनपुट मानों के परिणामों को त्यागकर जो सिस्टम की एक निश्चित स्थिति के लिए दौड़ हार गए हैं। Promise.allSettled में अनूठा है कि यह हमेशा हर किसी से अपेक्षा करता है कि वह किसके लिए जिम्मेदार है।

Promise.allSettled एक वादा लौटाता है, जिसे वादों के राज्यों के स्नैपशॉट की एक सरणी के साथ निष्पादित किया जाता है, लेकिन केवल सभी प्रारंभिक वादों को हल करने के बाद।

ऑलसेटल्ड नाम कहां से आया है?

हम कहते हैं कि यदि कोई वाद लंबित नहीं है, तो उसका निपटारा ( निपटारा ) किया जाता है, अर्थात्। जब वह या तो संतुष्ट होता है या अस्वीकार कर दिया जाता है - दो चीजों में से एक। शब्दावली को समझने के लिए, पुराने राज्यों और भाग्य दस्तावेज़ पर एक नज़र डालें।

और यह भी, यह नाम, allSettled , मौजूदा पुस्तकालयों में व्यापक रूप से उपयोग किया जाता है जो इस कार्यक्षमता को लागू करते हैं। सूची नीचे होगी।

उदाहरण

कल्पना करें कि आपको वादों की एक सरणी पर पुनरावृति करने की आवश्यकता है और एक ज्ञात स्थिति के साथ एक नया मूल्य लौटाएं (जो कि तर्क के दो संभावित शाखाओं में से किसी में भी होता है)।

 function reflect(promise) { return promise.then( (v) => { return { status: 'fulfilled', value: v }; }, (error) => { return { status: 'rejected', reason: error }; } ); } const promises = [ fetch('index.html'), fetch('https://does-not-exist/') ]; const results = await Promise.all(promises.map(reflect)); const successfulPromises = results.filter(p => p.status === 'fulfilled'); 

प्रस्तावित एपीआई डेवलपर को इन विकल्पों को संसाधित करने की अनुमति देता है, बिना reflect फ़ंक्शन को स्वतंत्र रूप से बनाने या अस्थायी चर में परिणामों को संग्रहीत करने की आवश्यकता के बिना। नया एपीआई इस तरह दिखता है:

 const promises = [ fetch('index.html'), fetch('https://does-not-exist/') ]; const results = await Promise.allSettled(promises); const successfulPromises = results.filter(p => p.status === 'fulfilled'); 

यदि किसी कारण से हमें अस्वीकार किए गए वादों की आवश्यकता होती है, तो संभवतः हमें उन कारणों को एकत्र करने की आवश्यकता है जो हुआ allSettled यह बस के रूप में आसान बनाता है।

 const promises = [ fetch('index.html'), fetch('https://does-not-exist/') ]; const results = await Promise.allSettled(promises); const errors = results .filter(p => p.status === 'rejected') .map(p => p.reason); 

वास्तविक उदाहरण

काफी सामान्य यह जानने की इच्छा है कि उनमें से प्रत्येक की स्थिति की परवाह किए बिना सभी अनुरोध पूरे हो गए हैं। यह महत्वपूर्ण है जब आप भविष्य में क्रमिक सुधार करना चाहते हैं। हमें हमेशा एपीआई से प्रतिक्रिया प्राप्त करने की आवश्यकता नहीं होती है।

 const urls = [ /* ... */ ]; const requests = urls.map(x => fetch(x)); // , -    ,  - - . //        ,   . try { await Promise.all(requests); console.log('  ,    .'); } catch { console.log('-    ,     . .'); } 

Promise.allSettled का उपयोग करके Promise.allSettled आप कुछ ऐसा लिख ​​सकते हैं जो हमारी अपेक्षाओं के अनुरूप हो।

 //   ,     API  . Promise.allSettled(requests).finally(() => { console.log('  :    ,   '); removeLoadingIndicator(); }); 

कस्टम कार्यान्वयन

• https://www.npmjs.com/package/promise.allsettled
• https://www.npmjs.com/package/q
• https://www.npmjs.com/package/rsvp
• http://bluebirdjs.com/docs/api/reflect.html
• https://www.npmjs.com/package/promise-settle
• https://github.com/cujojs/when/blob/master/docs/api.md#whensettle
• https://www.npmjs.com/package/es2015-promise.allsettled
• https://www.npmjs.com/package/promise-all-settled
• https://www.npmjs.com/package/maybe

अन्य भाषाओं में

इसी तरह की कार्यक्षमता अन्य भाषाओं में, विभिन्न नामों के तहत मौजूद है। चूंकि कोई सार्वभौमिक तंत्र नहीं है जो तुरंत कई भाषाओं के साथ संगत है, इसलिए यह दस्तावेज़ ऊपर सूचीबद्ध पुस्तकालयों से नामों के उदाहरण का अनुसरण करता है। यहाँ पर यह अन्य भाषाओं में कैसा दिखता है:

• जंग - futures::join ;
• सी # - Task.WhenAll । आप या तो कोशिश कर सकते हैं / पकड़ सकते हैं या TaskContinuationOptions.OnlyOnFaulted कर सकते हैं।
• पायथन - ALL_COMPLETED विकल्प के साथ ALL_COMPLETED
• जावा - CompletableFuture.allOf

आगे के अध्ययन के लिए सामग्री

• https://www.bennadel.com/blog/3289-implementing-qs-allsettled-promise-method-in-bluebird.htm
• https://github.com/domenic/promises-unwrapping/blob/master/docs/states-and-fates.md
• http://exploringjs.com/es6/ch_promises.html
• https://github.com/kriskowal/q/issues/257

TC39 की बैठकों से मिनट

• सितंबर 2018
• जनवरी 2019
• मार्च 2019
• जुलाई 2019 - जल्द ही आ रहा है

विनिर्देश

• Ecmarkup पर स्रोत
• HTML के रूप में

कार्यान्वयन

• V8 , क्रोम 76
• स्पाइडरमोंकी , फ़ायरफ़ॉक्स 68 नाइटली
• जावास्क्रिप्ट कोर , सफारी टीपी 85 और सफारी 13 बीटा
• चक्र
• मुख्य पॉलीफ़िल