jQuery.waterfall। छोटा उपयोगी

वर्तमान परियोजना में, अपने सभी परिणामों के साथ कुछ करने के लिए, अजाक्स अनुरोधों की अनुक्रमिक श्रृंखला को पूरा करने की आवश्यकता थी।
एक काफी विशिष्ट कार्य, इसके समाधान के पैटर्न को आमतौर पर झरना (झरना) कहा जाता है। इस पैटर्न के कार्यान्वयन नोड.जेएस के लिए हैं, हालांकि ब्राउज़र में कुछ काम करते हैं - async ।
लेकिन मैं एक तरीके की खातिर पूरे मॉड्यूल को शामिल नहीं करना चाहता था। कॉपी / पेस्ट भी नहीं किया, बल्कि सौंदर्य के कारण। Async में, कॉलबैक फ़ंक्शन विधि के लिए दिया जाता है, जबकि हम हर जगह jQuery.Deferred का उपयोग करते हैं। बेशक, कोई अंतर नहीं है, लेकिन मेरी "सुंदरता की भावना" ने मुझे परियोजना की शैली को "तोड़ने" की अनुमति नहीं दी :)
परिणामस्वरूप, मैंने jQuery.when के समान एक छोटी सी उपयोगिता लिखी



JQuery.when के विपरीत, दलीलें jqxhr को नहीं, बल्कि उन्हें लौटाने वाले कार्यों के लिए पारित की जानी चाहिए, अन्यथा झरने का अर्थ खो जाता है। हालांकि यह त्रुटियों का कारण नहीं होगा, क्योंकि झरना किसी भी प्रकार के तर्क को स्वीकार करता है।

इसका उपयोग करना आसान है।

1. चलो बदले में 3 अनुरोध निष्पादित करते हैं और परिणाम दिखाते हैं:

$.waterfall( function() { return $.ajax(...) }, function(arg1) { return $.ajax(...) }, function(arg2) { return $.ajax(...) } ) .fail(function(error) { console.log('fail'); console.log(error); }) .done(function() { console.log('success'); console.log(arguments); }) 

2. चलो एक अनुरोध पर अमल करें, जांचें कि वह वापस लौट आया है और यह तय करेगा कि आगे क्या करना है:

 $.waterfall( function() { return $.ajax(...) }, function(arg1) { return arg1 && arg1.answer == 42 ? $.ajax(...) : false; }, function(arg2) { return $.ajax(...) } ) .fail(function(error) { console.log('fail'); console.log(error) }) .done(function() { console.log('success'); console.log(arguments) }) 

3. झरना किसी भी प्रकार के तर्क को स्वीकार कर सकता है। झूठा तुरंत जलप्रपात को बाधित करेगा, कार्यों और आस्थगित वस्तुओं के अलावा अन्य मूल्यों को बस परिणाम में जोड़ा जाएगा:

 var dfrd = $.Deferred(); $.waterfall( function() { return $.ajax(...) }, $.ajax(...), //   " " dfrd, //        resolve/reject 'string', 42, false //     ) .fail(function(error) { console.log('fail'); console.log(error) }) .done(function() { console.log('success'); console.log(arguments) }) 

वह, वास्तव में, सब है। आलोचना और सलाह का स्वागत है।
गिथब कोड