| 1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878287928802881288228832884288528862887288828892890289128922893289428952896289728982899290029012902290329042905290629072908290929102911291229132914291529162917291829192920292129222923292429252926292729282929293029312932293329342935293629372938293929402941294229432944294529462947294829492950295129522953295429552956295729582959296029612962296329642965296629672968296929702971297229732974297529762977297829792980298129822983298429852986298729882989299029912992299329942995299629972998299930003001300230033004300530063007300830093010301130123013301430153016301730183019302030213022302330243025302630273028302930303031303230333034303530363037303830393040304130423043304430453046304730483049305030513052305330543055305630573058305930603061306230633064306530663067306830693070307130723073307430753076307730783079308030813082308330843085308630873088308930903091309230933094309530963097309830993100310131023103310431053106310731083109311031113112311331143115311631173118311931203121312231233124312531263127312831293130313131323133313431353136313731383139314031413142314331443145314631473148314931503151315231533154315531563157315831593160316131623163316431653166316731683169317031713172317331743175317631773178317931803181318231833184318531863187318831893190319131923193319431953196319731983199320032013202320332043205320632073208320932103211321232133214321532163217321832193220322132223223322432253226322732283229323032313232323332343235323632373238323932403241324232433244324532463247324832493250325132523253325432553256325732583259326032613262326332643265326632673268326932703271327232733274327532763277327832793280328132823283328432853286328732883289329032913292329332943295329632973298329933003301330233033304330533063307330833093310331133123313331433153316331733183319332033213322332333243325332633273328332933303331333233333334333533363337333833393340334133423343334433453346334733483349335033513352335333543355335633573358335933603361336233633364336533663367336833693370337133723373337433753376337733783379338033813382338333843385338633873388338933903391339233933394339533963397339833993400340134023403340434053406340734083409341034113412341334143415341634173418341934203421342234233424342534263427342834293430343134323433343434353436343734383439344034413442344334443445344634473448344934503451345234533454345534563457345834593460346134623463346434653466346734683469347034713472347334743475347634773478347934803481348234833484348534863487348834893490349134923493349434953496349734983499350035013502350335043505350635073508350935103511351235133514351535163517351835193520352135223523352435253526352735283529353035313532353335343535353635373538353935403541354235433544354535463547354835493550355135523553355435553556355735583559356035613562356335643565356635673568356935703571357235733574357535763577357835793580358135823583358435853586358735883589359035913592359335943595359635973598359936003601360236033604360536063607360836093610361136123613361436153616361736183619362036213622362336243625362636273628362936303631363236333634363536363637363836393640364136423643364436453646364736483649365036513652365336543655365636573658365936603661366236633664366536663667366836693670367136723673367436753676367736783679368036813682368336843685368636873688368936903691369236933694369536963697369836993700370137023703370437053706370737083709371037113712371337143715371637173718371937203721372237233724372537263727372837293730373137323733373437353736373737383739374037413742374337443745374637473748374937503751375237533754375537563757375837593760376137623763376437653766376737683769377037713772377337743775377637773778377937803781378237833784378537863787378837893790379137923793379437953796379737983799380038013802380338043805380638073808380938103811381238133814381538163817381838193820382138223823382438253826382738283829383038313832383338343835383638373838383938403841384238433844384538463847384838493850385138523853385438553856385738583859386038613862386338643865386638673868386938703871387238733874387538763877387838793880388138823883388438853886388738883889389038913892389338943895389638973898389939003901390239033904390539063907390839093910391139123913391439153916391739183919392039213922392339243925392639273928392939303931393239333934393539363937393839393940394139423943394439453946394739483949395039513952395339543955395639573958395939603961396239633964396539663967396839693970397139723973397439753976397739783979398039813982398339843985398639873988398939903991399239933994399539963997399839994000400140024003400440054006400740084009401040114012401340144015401640174018401940204021 |
- !function(e){"object"==typeof exports?module.exports=e():"function"==typeof define&&define.amd?define(e):"undefined"!=typeof window?window.when=e():"undefined"!=typeof global?global.when=e():"undefined"!=typeof self&&(self.when=e())}(function(){var define,module,exports;return (function e(t,n,r){function s(o,u){if(!n[o]){if(!t[o]){var a=typeof require=="function"&&require;if(!u&&a)return a(o,!0);if(i)return i(o,!0);throw new Error("Cannot find module '"+o+"'")}var f=n[o]={exports:{}};t[o][0].call(f.exports,function(e){var n=t[o][1][e];return s(n?n:e)},f,f.exports,e,t,n,r)}return n[o].exports}var i=typeof require=="function"&&require;for(var o=0;o<r.length;o++)s(r[o]);return s})({1:[function(require,module,exports){
- require('../monitor/console');
- module.exports = require('./when.browserify.js');
- },{"../monitor/console":30,"./when.browserify.js":2}],2:[function(require,module,exports){
- var when = module.exports = require('../when');
- when.callbacks = require('../callbacks');
- when.cancelable = require('../cancelable');
- when.delay = require('../delay');
- when.fn = require('../function');
- when.guard = require('../guard');
- when.keys = require('../keys');
- when.nodefn = when.node = require('../node');
- when.parallel = require('../parallel');
- when.pipeline = require('../pipeline');
- when.poll = require('../poll');
- when.sequence = require('../sequence');
- when.timeout = require('../timeout');
- },{"../callbacks":3,"../cancelable":4,"../delay":5,"../function":6,"../guard":7,"../keys":8,"../node":32,"../parallel":33,"../pipeline":34,"../poll":35,"../sequence":36,"../timeout":37,"../when":38}],3:[function(require,module,exports){
- /** @license MIT License (c) copyright 2013-2014 original author or authors */
- /**
- * Collection of helper functions for interacting with 'traditional',
- * callback-taking functions using a promise interface.
- *
- * @author Renato Zannon
- * @contributor Brian Cavalier
- */
- (function(define) {
- define(function(require) {
- var when = require('./when');
- var Promise = when.Promise;
- var _liftAll = require('./lib/liftAll');
- var slice = Array.prototype.slice;
- var makeApply = require('./lib/apply');
- var _apply = makeApply(Promise, dispatch);
- return {
- lift: lift,
- liftAll: liftAll,
- apply: apply,
- call: call,
- promisify: promisify
- };
- /**
- * Takes a `traditional` callback-taking function and returns a promise for its
- * result, accepting an optional array of arguments (that might be values or
- * promises). It assumes that the function takes its callback and errback as
- * the last two arguments. The resolution of the promise depends on whether the
- * function will call its callback or its errback.
- *
- * @example
- * var domIsLoaded = callbacks.apply($);
- * domIsLoaded.then(function() {
- * doMyDomStuff();
- * });
- *
- * @example
- * function existingAjaxyFunction(url, callback, errback) {
- * // Complex logic you'd rather not change
- * }
- *
- * var promise = callbacks.apply(existingAjaxyFunction, ["/movies.json"]);
- *
- * promise.then(function(movies) {
- * // Work with movies
- * }, function(reason) {
- * // Handle error
- * });
- *
- * @param {function} asyncFunction function to be called
- * @param {Array} [extraAsyncArgs] array of arguments to asyncFunction
- * @returns {Promise} promise for the callback value of asyncFunction
- */
- function apply(asyncFunction, extraAsyncArgs) {
- return _apply(asyncFunction, this, extraAsyncArgs || []);
- }
- /**
- * Apply helper that allows specifying thisArg
- * @private
- */
- function dispatch(f, thisArg, args, h) {
- args.push(alwaysUnary(h.resolve, h), alwaysUnary(h.reject, h));
- tryCatchResolve(f, thisArg, args, h);
- }
- function tryCatchResolve(f, thisArg, args, resolver) {
- try {
- f.apply(thisArg, args);
- } catch(e) {
- resolver.reject(e);
- }
- }
- /**
- * Works as `callbacks.apply` does, with the difference that the arguments to
- * the function are passed individually, instead of as an array.
- *
- * @example
- * function sumInFiveSeconds(a, b, callback) {
- * setTimeout(function() {
- * callback(a + b);
- * }, 5000);
- * }
- *
- * var sumPromise = callbacks.call(sumInFiveSeconds, 5, 10);
- *
- * // Logs '15' 5 seconds later
- * sumPromise.then(console.log);
- *
- * @param {function} asyncFunction function to be called
- * @param {...*} args arguments that will be forwarded to the function
- * @returns {Promise} promise for the callback value of asyncFunction
- */
- function call(asyncFunction/*, arg1, arg2...*/) {
- return _apply(asyncFunction, this, slice.call(arguments, 1));
- }
- /**
- * Takes a 'traditional' callback/errback-taking function and returns a function
- * that returns a promise instead. The resolution/rejection of the promise
- * depends on whether the original function will call its callback or its
- * errback.
- *
- * If additional arguments are passed to the `lift` call, they will be prepended
- * on the calls to the original function, much like `Function.prototype.bind`.
- *
- * The resulting function is also "promise-aware", in the sense that, if given
- * promises as arguments, it will wait for their resolution before executing.
- *
- * @example
- * function traditionalAjax(method, url, callback, errback) {
- * var xhr = new XMLHttpRequest();
- * xhr.open(method, url);
- *
- * xhr.onload = callback;
- * xhr.onerror = errback;
- *
- * xhr.send();
- * }
- *
- * var promiseAjax = callbacks.lift(traditionalAjax);
- * promiseAjax("GET", "/movies.json").then(console.log, console.error);
- *
- * var promiseAjaxGet = callbacks.lift(traditionalAjax, "GET");
- * promiseAjaxGet("/movies.json").then(console.log, console.error);
- *
- * @param {Function} f traditional async function to be decorated
- * @param {...*} [args] arguments to be prepended for the new function @deprecated
- * @returns {Function} a promise-returning function
- */
- function lift(f/*, args...*/) {
- var args = arguments.length > 1 ? slice.call(arguments, 1) : [];
- return function() {
- return _apply(f, this, args.concat(slice.call(arguments)));
- };
- }
- /**
- * Lift all the functions/methods on src
- * @param {object|function} src source whose functions will be lifted
- * @param {function?} combine optional function for customizing the lifting
- * process. It is passed dst, the lifted function, and the property name of
- * the original function on src.
- * @param {(object|function)?} dst option destination host onto which to place lifted
- * functions. If not provided, liftAll returns a new object.
- * @returns {*} If dst is provided, returns dst with lifted functions as
- * properties. If dst not provided, returns a new object with lifted functions.
- */
- function liftAll(src, combine, dst) {
- return _liftAll(lift, combine, dst, src);
- }
- /**
- * `promisify` is a version of `lift` that allows fine-grained control over the
- * arguments that passed to the underlying function. It is intended to handle
- * functions that don't follow the common callback and errback positions.
- *
- * The control is done by passing an object whose 'callback' and/or 'errback'
- * keys, whose values are the corresponding 0-based indexes of the arguments on
- * the function. Negative values are interpreted as being relative to the end
- * of the arguments array.
- *
- * If arguments are given on the call to the 'promisified' function, they are
- * intermingled with the callback and errback. If a promise is given among them,
- * the execution of the function will only occur after its resolution.
- *
- * @example
- * var delay = callbacks.promisify(setTimeout, {
- * callback: 0
- * });
- *
- * delay(100).then(function() {
- * console.log("This happens 100ms afterwards");
- * });
- *
- * @example
- * function callbackAsLast(errback, followsStandards, callback) {
- * if(followsStandards) {
- * callback("well done!");
- * } else {
- * errback("some programmers just want to watch the world burn");
- * }
- * }
- *
- * var promisified = callbacks.promisify(callbackAsLast, {
- * callback: -1,
- * errback: 0,
- * });
- *
- * promisified(true).then(console.log, console.error);
- * promisified(false).then(console.log, console.error);
- *
- * @param {Function} asyncFunction traditional function to be decorated
- * @param {object} positions
- * @param {number} [positions.callback] index at which asyncFunction expects to
- * receive a success callback
- * @param {number} [positions.errback] index at which asyncFunction expects to
- * receive an error callback
- * @returns {function} promisified function that accepts
- *
- * @deprecated
- */
- function promisify(asyncFunction, positions) {
- return function() {
- var thisArg = this;
- return Promise.all(arguments).then(function(args) {
- var p = Promise._defer();
- var callbackPos, errbackPos;
- if(typeof positions.callback === 'number') {
- callbackPos = normalizePosition(args, positions.callback);
- }
- if(typeof positions.errback === 'number') {
- errbackPos = normalizePosition(args, positions.errback);
- }
- if(errbackPos < callbackPos) {
- insertCallback(args, errbackPos, p._handler.reject, p._handler);
- insertCallback(args, callbackPos, p._handler.resolve, p._handler);
- } else {
- insertCallback(args, callbackPos, p._handler.resolve, p._handler);
- insertCallback(args, errbackPos, p._handler.reject, p._handler);
- }
- asyncFunction.apply(thisArg, args);
- return p;
- });
- };
- }
- function normalizePosition(args, pos) {
- return pos < 0 ? (args.length + pos + 2) : pos;
- }
- function insertCallback(args, pos, callback, thisArg) {
- if(typeof pos === 'number') {
- args.splice(pos, 0, alwaysUnary(callback, thisArg));
- }
- }
- function alwaysUnary(fn, thisArg) {
- return function() {
- if (arguments.length > 1) {
- fn.call(thisArg, slice.call(arguments));
- } else {
- fn.apply(thisArg, arguments);
- }
- };
- }
- });
- })(typeof define === 'function' && define.amd ? define : function (factory) { module.exports = factory(require); });
- },{"./lib/apply":12,"./lib/liftAll":24,"./when":38}],4:[function(require,module,exports){
- /** @license MIT License (c) copyright B Cavalier & J Hann */
- /**
- * cancelable.js
- * @deprecated
- *
- * Decorator that makes a deferred "cancelable". It adds a cancel() method that
- * will call a special cancel handler function and then reject the deferred. The
- * cancel handler can be used to do resource cleanup, or anything else that should
- * be done before any other rejection handlers are executed.
- *
- * Usage:
- *
- * var cancelableDeferred = cancelable(when.defer(), myCancelHandler);
- *
- * @author brian@hovercraftstudios.com
- */
- (function(define) {
- define(function() {
- /**
- * Makes deferred cancelable, adding a cancel() method.
- * @deprecated
- *
- * @param deferred {Deferred} the {@link Deferred} to make cancelable
- * @param canceler {Function} cancel handler function to execute when this deferred
- * is canceled. This is guaranteed to run before all other rejection handlers.
- * The canceler will NOT be executed if the deferred is rejected in the standard
- * way, i.e. deferred.reject(). It ONLY executes if the deferred is canceled,
- * i.e. deferred.cancel()
- *
- * @returns deferred, with an added cancel() method.
- */
- return function(deferred, canceler) {
- // Add a cancel method to the deferred to reject the delegate
- // with the special canceled indicator.
- deferred.cancel = function() {
- try {
- deferred.reject(canceler(deferred));
- } catch(e) {
- deferred.reject(e);
- }
- return deferred.promise;
- };
- return deferred;
- };
- });
- })(typeof define === 'function' && define.amd ? define : function (factory) { module.exports = factory(); });
- },{}],5:[function(require,module,exports){
- /** @license MIT License (c) copyright 2011-2013 original author or authors */
- /**
- * delay.js
- *
- * Helper that returns a promise that resolves after a delay.
- *
- * @author Brian Cavalier
- * @author John Hann
- */
- (function(define) {
- define(function(require) {
- var when = require('./when');
- /**
- * @deprecated Use when(value).delay(ms)
- */
- return function delay(msec, value) {
- return when(value).delay(msec);
- };
- });
- })(typeof define === 'function' && define.amd ? define : function (factory) { module.exports = factory(require); });
- },{"./when":38}],6:[function(require,module,exports){
- /** @license MIT License (c) copyright 2013-2014 original author or authors */
- /**
- * Collection of helper functions for wrapping and executing 'traditional'
- * synchronous functions in a promise interface.
- *
- * @author Brian Cavalier
- * @contributor Renato Zannon
- */
- (function(define) {
- define(function(require) {
- var when = require('./when');
- var attempt = when['try'];
- var _liftAll = require('./lib/liftAll');
- var _apply = require('./lib/apply')(when.Promise);
- var slice = Array.prototype.slice;
- return {
- lift: lift,
- liftAll: liftAll,
- call: attempt,
- apply: apply,
- compose: compose
- };
- /**
- * Takes a function and an optional array of arguments (that might be promises),
- * and calls the function. The return value is a promise whose resolution
- * depends on the value returned by the function.
- * @param {function} f function to be called
- * @param {Array} [args] array of arguments to func
- * @returns {Promise} promise for the return value of func
- */
- function apply(f, args) {
- // slice args just in case the caller passed an Arguments instance
- return _apply(f, this, args == null ? [] : slice.call(args));
- }
- /**
- * Takes a 'regular' function and returns a version of that function that
- * returns a promise instead of a plain value, and handles thrown errors by
- * returning a rejected promise. Also accepts a list of arguments to be
- * prepended to the new function, as does Function.prototype.bind.
- *
- * The resulting function is promise-aware, in the sense that it accepts
- * promise arguments, and waits for their resolution.
- * @param {Function} f function to be bound
- * @param {...*} [args] arguments to be prepended for the new function @deprecated
- * @returns {Function} a promise-returning function
- */
- function lift(f /*, args... */) {
- var args = arguments.length > 1 ? slice.call(arguments, 1) : [];
- return function() {
- return _apply(f, this, args.concat(slice.call(arguments)));
- };
- }
- /**
- * Lift all the functions/methods on src
- * @param {object|function} src source whose functions will be lifted
- * @param {function?} combine optional function for customizing the lifting
- * process. It is passed dst, the lifted function, and the property name of
- * the original function on src.
- * @param {(object|function)?} dst option destination host onto which to place lifted
- * functions. If not provided, liftAll returns a new object.
- * @returns {*} If dst is provided, returns dst with lifted functions as
- * properties. If dst not provided, returns a new object with lifted functions.
- */
- function liftAll(src, combine, dst) {
- return _liftAll(lift, combine, dst, src);
- }
- /**
- * Composes multiple functions by piping their return values. It is
- * transparent to whether the functions return 'regular' values or promises:
- * the piped argument is always a resolved value. If one of the functions
- * throws or returns a rejected promise, the composed promise will be also
- * rejected.
- *
- * The arguments (or promises to arguments) given to the returned function (if
- * any), are passed directly to the first function on the 'pipeline'.
- * @param {Function} f the function to which the arguments will be passed
- * @param {...Function} [funcs] functions that will be composed, in order
- * @returns {Function} a promise-returning composition of the functions
- */
- function compose(f /*, funcs... */) {
- var funcs = slice.call(arguments, 1);
- return function() {
- var thisArg = this;
- var args = slice.call(arguments);
- var firstPromise = attempt.apply(thisArg, [f].concat(args));
- return when.reduce(funcs, function(arg, func) {
- return func.call(thisArg, arg);
- }, firstPromise);
- };
- }
- });
- })(typeof define === 'function' && define.amd ? define : function (factory) { module.exports = factory(require); });
- },{"./lib/apply":12,"./lib/liftAll":24,"./when":38}],7:[function(require,module,exports){
- /** @license MIT License (c) copyright 2011-2013 original author or authors */
- /**
- * Generalized promise concurrency guard
- * Adapted from original concept by Sakari Jokinen (Rocket Pack, Ltd.)
- *
- * @author Brian Cavalier
- * @author John Hann
- * @contributor Sakari Jokinen
- */
- (function(define) {
- define(function(require) {
- var when = require('./when');
- var slice = Array.prototype.slice;
- guard.n = n;
- return guard;
- /**
- * Creates a guarded version of f that can only be entered when the supplied
- * condition allows.
- * @param {function} condition represents a critical section that may only
- * be entered when allowed by the condition
- * @param {function} f function to guard
- * @returns {function} guarded version of f
- */
- function guard(condition, f) {
- return function() {
- var args = slice.call(arguments);
- return when(condition()).withThis(this).then(function(exit) {
- return when(f.apply(this, args))['finally'](exit);
- });
- };
- }
- /**
- * Creates a condition that allows only n simultaneous executions
- * of a guarded function
- * @param {number} allowed number of allowed simultaneous executions
- * @returns {function} condition function which returns a promise that
- * fulfills when the critical section may be entered. The fulfillment
- * value is a function ("notifyExit") that must be called when the critical
- * section has been exited.
- */
- function n(allowed) {
- var count = 0;
- var waiting = [];
- return function enter() {
- return when.promise(function(resolve) {
- if(count < allowed) {
- resolve(exit);
- } else {
- waiting.push(resolve);
- }
- count += 1;
- });
- };
- function exit() {
- count = Math.max(count - 1, 0);
- if(waiting.length > 0) {
- waiting.shift()(exit);
- }
- }
- }
- });
- }(typeof define === 'function' && define.amd ? define : function(factory) { module.exports = factory(require); }));
- },{"./when":38}],8:[function(require,module,exports){
- /** @license MIT License (c) copyright 2011-2013 original author or authors */
- /**
- * Licensed under the MIT License at:
- * http://www.opensource.org/licenses/mit-license.php
- *
- * @author Brian Cavalier
- * @author John Hann
- */
- (function(define) { 'use strict';
- define(function(require) {
- var when = require('./when');
- var Promise = when.Promise;
- var toPromise = when.resolve;
- return {
- all: when.lift(all),
- map: map,
- settle: settle
- };
- /**
- * Resolve all the key-value pairs in the supplied object or promise
- * for an object.
- * @param {Promise|object} object or promise for object whose key-value pairs
- * will be resolved
- * @returns {Promise} promise for an object with the fully resolved key-value pairs
- */
- function all(object) {
- var p = Promise._defer();
- var resolver = Promise._handler(p);
- var results = {};
- var keys = Object.keys(object);
- var pending = keys.length;
- for(var i=0, k; i<keys.length; ++i) {
- k = keys[i];
- Promise._handler(object[k]).fold(settleKey, k, results, resolver);
- }
- if(pending === 0) {
- resolver.resolve(results);
- }
- return p;
- function settleKey(k, x, resolver) {
- /*jshint validthis:true*/
- this[k] = x;
- if(--pending === 0) {
- resolver.resolve(results);
- }
- }
- }
- /**
- * Map values in the supplied object's keys
- * @param {Promise|object} object or promise for object whose key-value pairs
- * will be reduced
- * @param {function(value:*, key:String):*} f mapping function which may
- * return either a promise or a value
- * @returns {Promise} promise for an object with the mapped and fully
- * resolved key-value pairs
- */
- function map(object, f) {
- return toPromise(object).then(function(object) {
- return all(Object.keys(object).reduce(function(o, k) {
- o[k] = toPromise(object[k]).fold(mapWithKey, k);
- return o;
- }, {}));
- });
- function mapWithKey(k, x) {
- return f(x, k);
- }
- }
- /**
- * Resolve all key-value pairs in the supplied object and return a promise
- * that will always fulfill with the outcome states of all input promises.
- * @param {object} object whose key-value pairs will be settled
- * @returns {Promise} promise for an object with the mapped and fully
- * settled key-value pairs
- */
- function settle(object) {
- var keys = Object.keys(object);
- var results = {};
- if(keys.length === 0) {
- return toPromise(results);
- }
- var p = Promise._defer();
- var resolver = Promise._handler(p);
- var promises = keys.map(function(k) { return object[k]; });
- when.settle(promises).then(function(states) {
- populateResults(keys, states, results, resolver);
- });
- return p;
- }
- function populateResults(keys, states, results, resolver) {
- for(var i=0; i<keys.length; i++) {
- results[keys[i]] = states[i];
- }
- resolver.resolve(results);
- }
- });
- })(typeof define === 'function' && define.amd ? define : function (factory) { module.exports = factory(require); });
- },{"./when":38}],9:[function(require,module,exports){
- /** @license MIT License (c) copyright 2010-2014 original author or authors */
- /** @author Brian Cavalier */
- /** @author John Hann */
- (function(define) { 'use strict';
- define(function (require) {
- var makePromise = require('./makePromise');
- var Scheduler = require('./Scheduler');
- var async = require('./env').asap;
- return makePromise({
- scheduler: new Scheduler(async)
- });
- });
- })(typeof define === 'function' && define.amd ? define : function (factory) { module.exports = factory(require); });
- },{"./Scheduler":10,"./env":22,"./makePromise":25}],10:[function(require,module,exports){
- /** @license MIT License (c) copyright 2010-2014 original author or authors */
- /** @author Brian Cavalier */
- /** @author John Hann */
- (function(define) { 'use strict';
- define(function() {
- // Credit to Twisol (https://github.com/Twisol) for suggesting
- // this type of extensible queue + trampoline approach for next-tick conflation.
- /**
- * Async task scheduler
- * @param {function} async function to schedule a single async function
- * @constructor
- */
- function Scheduler(async) {
- this._async = async;
- this._running = false;
- this._queue = this;
- this._queueLen = 0;
- this._afterQueue = {};
- this._afterQueueLen = 0;
- var self = this;
- this.drain = function() {
- self._drain();
- };
- }
- /**
- * Enqueue a task
- * @param {{ run:function }} task
- */
- Scheduler.prototype.enqueue = function(task) {
- this._queue[this._queueLen++] = task;
- this.run();
- };
- /**
- * Enqueue a task to run after the main task queue
- * @param {{ run:function }} task
- */
- Scheduler.prototype.afterQueue = function(task) {
- this._afterQueue[this._afterQueueLen++] = task;
- this.run();
- };
- Scheduler.prototype.run = function() {
- if (!this._running) {
- this._running = true;
- this._async(this.drain);
- }
- };
- /**
- * Drain the handler queue entirely, and then the after queue
- */
- Scheduler.prototype._drain = function() {
- var i = 0;
- for (; i < this._queueLen; ++i) {
- this._queue[i].run();
- this._queue[i] = void 0;
- }
- this._queueLen = 0;
- this._running = false;
- for (i = 0; i < this._afterQueueLen; ++i) {
- this._afterQueue[i].run();
- this._afterQueue[i] = void 0;
- }
- this._afterQueueLen = 0;
- };
- return Scheduler;
- });
- }(typeof define === 'function' && define.amd ? define : function(factory) { module.exports = factory(); }));
- },{}],11:[function(require,module,exports){
- /** @license MIT License (c) copyright 2010-2014 original author or authors */
- /** @author Brian Cavalier */
- /** @author John Hann */
- (function(define) { 'use strict';
- define(function() {
- /**
- * Custom error type for promises rejected by promise.timeout
- * @param {string} message
- * @constructor
- */
- function TimeoutError (message) {
- Error.call(this);
- this.message = message;
- this.name = TimeoutError.name;
- if (typeof Error.captureStackTrace === 'function') {
- Error.captureStackTrace(this, TimeoutError);
- }
- }
- TimeoutError.prototype = Object.create(Error.prototype);
- TimeoutError.prototype.constructor = TimeoutError;
- return TimeoutError;
- });
- }(typeof define === 'function' && define.amd ? define : function(factory) { module.exports = factory(); }));
- },{}],12:[function(require,module,exports){
- /** @license MIT License (c) copyright 2010-2014 original author or authors */
- /** @author Brian Cavalier */
- /** @author John Hann */
- (function(define) { 'use strict';
- define(function() {
- makeApply.tryCatchResolve = tryCatchResolve;
- return makeApply;
- function makeApply(Promise, call) {
- if(arguments.length < 2) {
- call = tryCatchResolve;
- }
- return apply;
- function apply(f, thisArg, args) {
- var p = Promise._defer();
- var l = args.length;
- var params = new Array(l);
- callAndResolve({ f:f, thisArg:thisArg, args:args, params:params, i:l-1, call:call }, p._handler);
- return p;
- }
- function callAndResolve(c, h) {
- if(c.i < 0) {
- return call(c.f, c.thisArg, c.params, h);
- }
- var handler = Promise._handler(c.args[c.i]);
- handler.fold(callAndResolveNext, c, void 0, h);
- }
- function callAndResolveNext(c, x, h) {
- c.params[c.i] = x;
- c.i -= 1;
- callAndResolve(c, h);
- }
- }
- function tryCatchResolve(f, thisArg, args, resolver) {
- try {
- resolver.resolve(f.apply(thisArg, args));
- } catch(e) {
- resolver.reject(e);
- }
- }
- });
- }(typeof define === 'function' && define.amd ? define : function(factory) { module.exports = factory(); }));
- },{}],13:[function(require,module,exports){
- /** @license MIT License (c) copyright 2010-2014 original author or authors */
- /** @author Brian Cavalier */
- /** @author John Hann */
- (function(define) { 'use strict';
- define(function(require) {
- var state = require('../state');
- var applier = require('../apply');
- return function array(Promise) {
- var applyFold = applier(Promise);
- var toPromise = Promise.resolve;
- var all = Promise.all;
- var ar = Array.prototype.reduce;
- var arr = Array.prototype.reduceRight;
- var slice = Array.prototype.slice;
- // Additional array combinators
- Promise.any = any;
- Promise.some = some;
- Promise.settle = settle;
- Promise.map = map;
- Promise.filter = filter;
- Promise.reduce = reduce;
- Promise.reduceRight = reduceRight;
- /**
- * When this promise fulfills with an array, do
- * onFulfilled.apply(void 0, array)
- * @param {function} onFulfilled function to apply
- * @returns {Promise} promise for the result of applying onFulfilled
- */
- Promise.prototype.spread = function(onFulfilled) {
- return this.then(all).then(function(array) {
- return onFulfilled.apply(this, array);
- });
- };
- return Promise;
- /**
- * One-winner competitive race.
- * Return a promise that will fulfill when one of the promises
- * in the input array fulfills, or will reject when all promises
- * have rejected.
- * @param {array} promises
- * @returns {Promise} promise for the first fulfilled value
- */
- function any(promises) {
- var p = Promise._defer();
- var resolver = p._handler;
- var l = promises.length>>>0;
- var pending = l;
- var errors = [];
- for (var h, x, i = 0; i < l; ++i) {
- x = promises[i];
- if(x === void 0 && !(i in promises)) {
- --pending;
- continue;
- }
- h = Promise._handler(x);
- if(h.state() > 0) {
- resolver.become(h);
- Promise._visitRemaining(promises, i, h);
- break;
- } else {
- h.visit(resolver, handleFulfill, handleReject);
- }
- }
- if(pending === 0) {
- resolver.reject(new RangeError('any(): array must not be empty'));
- }
- return p;
- function handleFulfill(x) {
- /*jshint validthis:true*/
- errors = null;
- this.resolve(x); // this === resolver
- }
- function handleReject(e) {
- /*jshint validthis:true*/
- if(this.resolved) { // this === resolver
- return;
- }
- errors.push(e);
- if(--pending === 0) {
- this.reject(errors);
- }
- }
- }
- /**
- * N-winner competitive race
- * Return a promise that will fulfill when n input promises have
- * fulfilled, or will reject when it becomes impossible for n
- * input promises to fulfill (ie when promises.length - n + 1
- * have rejected)
- * @param {array} promises
- * @param {number} n
- * @returns {Promise} promise for the earliest n fulfillment values
- *
- * @deprecated
- */
- function some(promises, n) {
- /*jshint maxcomplexity:7*/
- var p = Promise._defer();
- var resolver = p._handler;
- var results = [];
- var errors = [];
- var l = promises.length>>>0;
- var nFulfill = 0;
- var nReject;
- var x, i; // reused in both for() loops
- // First pass: count actual array items
- for(i=0; i<l; ++i) {
- x = promises[i];
- if(x === void 0 && !(i in promises)) {
- continue;
- }
- ++nFulfill;
- }
- // Compute actual goals
- n = Math.max(n, 0);
- nReject = (nFulfill - n + 1);
- nFulfill = Math.min(n, nFulfill);
- if(n > nFulfill) {
- resolver.reject(new RangeError('some(): array must contain at least '
- + n + ' item(s), but had ' + nFulfill));
- } else if(nFulfill === 0) {
- resolver.resolve(results);
- }
- // Second pass: observe each array item, make progress toward goals
- for(i=0; i<l; ++i) {
- x = promises[i];
- if(x === void 0 && !(i in promises)) {
- continue;
- }
- Promise._handler(x).visit(resolver, fulfill, reject, resolver.notify);
- }
- return p;
- function fulfill(x) {
- /*jshint validthis:true*/
- if(this.resolved) { // this === resolver
- return;
- }
- results.push(x);
- if(--nFulfill === 0) {
- errors = null;
- this.resolve(results);
- }
- }
- function reject(e) {
- /*jshint validthis:true*/
- if(this.resolved) { // this === resolver
- return;
- }
- errors.push(e);
- if(--nReject === 0) {
- results = null;
- this.reject(errors);
- }
- }
- }
- /**
- * Apply f to the value of each promise in a list of promises
- * and return a new list containing the results.
- * @param {array} promises
- * @param {function(x:*, index:Number):*} f mapping function
- * @returns {Promise}
- */
- function map(promises, f) {
- return Promise._traverse(f, promises);
- }
- /**
- * Filter the provided array of promises using the provided predicate. Input may
- * contain promises and values
- * @param {Array} promises array of promises and values
- * @param {function(x:*, index:Number):boolean} predicate filtering predicate.
- * Must return truthy (or promise for truthy) for items to retain.
- * @returns {Promise} promise that will fulfill with an array containing all items
- * for which predicate returned truthy.
- */
- function filter(promises, predicate) {
- var a = slice.call(promises);
- return Promise._traverse(predicate, a).then(function(keep) {
- return filterSync(a, keep);
- });
- }
- function filterSync(promises, keep) {
- // Safe because we know all promises have fulfilled if we've made it this far
- var l = keep.length;
- var filtered = new Array(l);
- for(var i=0, j=0; i<l; ++i) {
- if(keep[i]) {
- filtered[j++] = Promise._handler(promises[i]).value;
- }
- }
- filtered.length = j;
- return filtered;
- }
- /**
- * Return a promise that will always fulfill with an array containing
- * the outcome states of all input promises. The returned promise
- * will never reject.
- * @param {Array} promises
- * @returns {Promise} promise for array of settled state descriptors
- */
- function settle(promises) {
- return all(promises.map(settleOne));
- }
- function settleOne(p) {
- var h = Promise._handler(p);
- if(h.state() === 0) {
- return toPromise(p).then(state.fulfilled, state.rejected);
- }
- h._unreport();
- return state.inspect(h);
- }
- /**
- * Traditional reduce function, similar to `Array.prototype.reduce()`, but
- * input may contain promises and/or values, and reduceFunc
- * may return either a value or a promise, *and* initialValue may
- * be a promise for the starting value.
- * @param {Array|Promise} promises array or promise for an array of anything,
- * may contain a mix of promises and values.
- * @param {function(accumulated:*, x:*, index:Number):*} f reduce function
- * @returns {Promise} that will resolve to the final reduced value
- */
- function reduce(promises, f /*, initialValue */) {
- return arguments.length > 2 ? ar.call(promises, liftCombine(f), arguments[2])
- : ar.call(promises, liftCombine(f));
- }
- /**
- * Traditional reduce function, similar to `Array.prototype.reduceRight()`, but
- * input may contain promises and/or values, and reduceFunc
- * may return either a value or a promise, *and* initialValue may
- * be a promise for the starting value.
- * @param {Array|Promise} promises array or promise for an array of anything,
- * may contain a mix of promises and values.
- * @param {function(accumulated:*, x:*, index:Number):*} f reduce function
- * @returns {Promise} that will resolve to the final reduced value
- */
- function reduceRight(promises, f /*, initialValue */) {
- return arguments.length > 2 ? arr.call(promises, liftCombine(f), arguments[2])
- : arr.call(promises, liftCombine(f));
- }
- function liftCombine(f) {
- return function(z, x, i) {
- return applyFold(f, void 0, [z,x,i]);
- };
- }
- };
- });
- }(typeof define === 'function' && define.amd ? define : function(factory) { module.exports = factory(require); }));
- },{"../apply":12,"../state":26}],14:[function(require,module,exports){
- /** @license MIT License (c) copyright 2010-2014 original author or authors */
- /** @author Brian Cavalier */
- /** @author John Hann */
- (function(define) { 'use strict';
- define(function() {
- return function flow(Promise) {
- var resolve = Promise.resolve;
- var reject = Promise.reject;
- var origCatch = Promise.prototype['catch'];
- /**
- * Handle the ultimate fulfillment value or rejection reason, and assume
- * responsibility for all errors. If an error propagates out of result
- * or handleFatalError, it will be rethrown to the host, resulting in a
- * loud stack track on most platforms and a crash on some.
- * @param {function?} onResult
- * @param {function?} onError
- * @returns {undefined}
- */
- Promise.prototype.done = function(onResult, onError) {
- this._handler.visit(this._handler.receiver, onResult, onError);
- };
- /**
- * Add Error-type and predicate matching to catch. Examples:
- * promise.catch(TypeError, handleTypeError)
- * .catch(predicate, handleMatchedErrors)
- * .catch(handleRemainingErrors)
- * @param onRejected
- * @returns {*}
- */
- Promise.prototype['catch'] = Promise.prototype.otherwise = function(onRejected) {
- if (arguments.length < 2) {
- return origCatch.call(this, onRejected);
- }
- if(typeof onRejected !== 'function') {
- return this.ensure(rejectInvalidPredicate);
- }
- return origCatch.call(this, createCatchFilter(arguments[1], onRejected));
- };
- /**
- * Wraps the provided catch handler, so that it will only be called
- * if the predicate evaluates truthy
- * @param {?function} handler
- * @param {function} predicate
- * @returns {function} conditional catch handler
- */
- function createCatchFilter(handler, predicate) {
- return function(e) {
- return evaluatePredicate(e, predicate)
- ? handler.call(this, e)
- : reject(e);
- };
- }
- /**
- * Ensures that onFulfilledOrRejected will be called regardless of whether
- * this promise is fulfilled or rejected. onFulfilledOrRejected WILL NOT
- * receive the promises' value or reason. Any returned value will be disregarded.
- * onFulfilledOrRejected may throw or return a rejected promise to signal
- * an additional error.
- * @param {function} handler handler to be called regardless of
- * fulfillment or rejection
- * @returns {Promise}
- */
- Promise.prototype['finally'] = Promise.prototype.ensure = function(handler) {
- if(typeof handler !== 'function') {
- return this;
- }
- return this.then(function(x) {
- return runSideEffect(handler, this, identity, x);
- }, function(e) {
- return runSideEffect(handler, this, reject, e);
- });
- };
- function runSideEffect (handler, thisArg, propagate, value) {
- var result = handler.call(thisArg);
- return maybeThenable(result)
- ? propagateValue(result, propagate, value)
- : propagate(value);
- }
- function propagateValue (result, propagate, x) {
- return resolve(result).then(function () {
- return propagate(x);
- });
- }
- /**
- * Recover from a failure by returning a defaultValue. If defaultValue
- * is a promise, it's fulfillment value will be used. If defaultValue is
- * a promise that rejects, the returned promise will reject with the
- * same reason.
- * @param {*} defaultValue
- * @returns {Promise} new promise
- */
- Promise.prototype['else'] = Promise.prototype.orElse = function(defaultValue) {
- return this.then(void 0, function() {
- return defaultValue;
- });
- };
- /**
- * Shortcut for .then(function() { return value; })
- * @param {*} value
- * @return {Promise} a promise that:
- * - is fulfilled if value is not a promise, or
- * - if value is a promise, will fulfill with its value, or reject
- * with its reason.
- */
- Promise.prototype['yield'] = function(value) {
- return this.then(function() {
- return value;
- });
- };
- /**
- * Runs a side effect when this promise fulfills, without changing the
- * fulfillment value.
- * @param {function} onFulfilledSideEffect
- * @returns {Promise}
- */
- Promise.prototype.tap = function(onFulfilledSideEffect) {
- return this.then(onFulfilledSideEffect)['yield'](this);
- };
- return Promise;
- };
- function rejectInvalidPredicate() {
- throw new TypeError('catch predicate must be a function');
- }
- function evaluatePredicate(e, predicate) {
- return isError(predicate) ? e instanceof predicate : predicate(e);
- }
- function isError(predicate) {
- return predicate === Error
- || (predicate != null && predicate.prototype instanceof Error);
- }
- function maybeThenable(x) {
- return (typeof x === 'object' || typeof x === 'function') && x !== null;
- }
- function identity(x) {
- return x;
- }
- });
- }(typeof define === 'function' && define.amd ? define : function(factory) { module.exports = factory(); }));
- },{}],15:[function(require,module,exports){
- /** @license MIT License (c) copyright 2010-2014 original author or authors */
- /** @author Brian Cavalier */
- /** @author John Hann */
- /** @author Jeff Escalante */
- (function(define) { 'use strict';
- define(function() {
- return function fold(Promise) {
- Promise.prototype.fold = function(f, z) {
- var promise = this._beget();
- this._handler.fold(function(z, x, to) {
- Promise._handler(z).fold(function(x, z, to) {
- to.resolve(f.call(this, z, x));
- }, x, this, to);
- }, z, promise._handler.receiver, promise._handler);
- return promise;
- };
- return Promise;
- };
- });
- }(typeof define === 'function' && define.amd ? define : function(factory) { module.exports = factory(); }));
- },{}],16:[function(require,module,exports){
- /** @license MIT License (c) copyright 2010-2014 original author or authors */
- /** @author Brian Cavalier */
- /** @author John Hann */
- (function(define) { 'use strict';
- define(function(require) {
- var inspect = require('../state').inspect;
- return function inspection(Promise) {
- Promise.prototype.inspect = function() {
- return inspect(Promise._handler(this));
- };
- return Promise;
- };
- });
- }(typeof define === 'function' && define.amd ? define : function(factory) { module.exports = factory(require); }));
- },{"../state":26}],17:[function(require,module,exports){
- /** @license MIT License (c) copyright 2010-2014 original author or authors */
- /** @author Brian Cavalier */
- /** @author John Hann */
- (function(define) { 'use strict';
- define(function() {
- return function generate(Promise) {
- var resolve = Promise.resolve;
- Promise.iterate = iterate;
- Promise.unfold = unfold;
- return Promise;
- /**
- * @deprecated Use github.com/cujojs/most streams and most.iterate
- * Generate a (potentially infinite) stream of promised values:
- * x, f(x), f(f(x)), etc. until condition(x) returns true
- * @param {function} f function to generate a new x from the previous x
- * @param {function} condition function that, given the current x, returns
- * truthy when the iterate should stop
- * @param {function} handler function to handle the value produced by f
- * @param {*|Promise} x starting value, may be a promise
- * @return {Promise} the result of the last call to f before
- * condition returns true
- */
- function iterate(f, condition, handler, x) {
- return unfold(function(x) {
- return [x, f(x)];
- }, condition, handler, x);
- }
- /**
- * @deprecated Use github.com/cujojs/most streams and most.unfold
- * Generate a (potentially infinite) stream of promised values
- * by applying handler(generator(seed)) iteratively until
- * condition(seed) returns true.
- * @param {function} unspool function that generates a [value, newSeed]
- * given a seed.
- * @param {function} condition function that, given the current seed, returns
- * truthy when the unfold should stop
- * @param {function} handler function to handle the value produced by unspool
- * @param x {*|Promise} starting value, may be a promise
- * @return {Promise} the result of the last value produced by unspool before
- * condition returns true
- */
- function unfold(unspool, condition, handler, x) {
- return resolve(x).then(function(seed) {
- return resolve(condition(seed)).then(function(done) {
- return done ? seed : resolve(unspool(seed)).spread(next);
- });
- });
- function next(item, newSeed) {
- return resolve(handler(item)).then(function() {
- return unfold(unspool, condition, handler, newSeed);
- });
- }
- }
- };
- });
- }(typeof define === 'function' && define.amd ? define : function(factory) { module.exports = factory(); }));
- },{}],18:[function(require,module,exports){
- /** @license MIT License (c) copyright 2010-2014 original author or authors */
- /** @author Brian Cavalier */
- /** @author John Hann */
- (function(define) { 'use strict';
- define(function() {
- return function progress(Promise) {
- /**
- * @deprecated
- * Register a progress handler for this promise
- * @param {function} onProgress
- * @returns {Promise}
- */
- Promise.prototype.progress = function(onProgress) {
- return this.then(void 0, void 0, onProgress);
- };
- return Promise;
- };
- });
- }(typeof define === 'function' && define.amd ? define : function(factory) { module.exports = factory(); }));
- },{}],19:[function(require,module,exports){
- /** @license MIT License (c) copyright 2010-2014 original author or authors */
- /** @author Brian Cavalier */
- /** @author John Hann */
- (function(define) { 'use strict';
- define(function(require) {
- var env = require('../env');
- var TimeoutError = require('../TimeoutError');
- function setTimeout(f, ms, x, y) {
- return env.setTimer(function() {
- f(x, y, ms);
- }, ms);
- }
- return function timed(Promise) {
- /**
- * Return a new promise whose fulfillment value is revealed only
- * after ms milliseconds
- * @param {number} ms milliseconds
- * @returns {Promise}
- */
- Promise.prototype.delay = function(ms) {
- var p = this._beget();
- this._handler.fold(handleDelay, ms, void 0, p._handler);
- return p;
- };
- function handleDelay(ms, x, h) {
- setTimeout(resolveDelay, ms, x, h);
- }
- function resolveDelay(x, h) {
- h.resolve(x);
- }
- /**
- * Return a new promise that rejects after ms milliseconds unless
- * this promise fulfills earlier, in which case the returned promise
- * fulfills with the same value.
- * @param {number} ms milliseconds
- * @param {Error|*=} reason optional rejection reason to use, defaults
- * to a TimeoutError if not provided
- * @returns {Promise}
- */
- Promise.prototype.timeout = function(ms, reason) {
- var p = this._beget();
- var h = p._handler;
- var t = setTimeout(onTimeout, ms, reason, p._handler);
- this._handler.visit(h,
- function onFulfill(x) {
- env.clearTimer(t);
- this.resolve(x); // this = h
- },
- function onReject(x) {
- env.clearTimer(t);
- this.reject(x); // this = h
- },
- h.notify);
- return p;
- };
- function onTimeout(reason, h, ms) {
- var e = typeof reason === 'undefined'
- ? new TimeoutError('timed out after ' + ms + 'ms')
- : reason;
- h.reject(e);
- }
- return Promise;
- };
- });
- }(typeof define === 'function' && define.amd ? define : function(factory) { module.exports = factory(require); }));
- },{"../TimeoutError":11,"../env":22}],20:[function(require,module,exports){
- /** @license MIT License (c) copyright 2010-2014 original author or authors */
- /** @author Brian Cavalier */
- /** @author John Hann */
- (function(define) { 'use strict';
- define(function(require) {
- var setTimer = require('../env').setTimer;
- var format = require('../format');
- return function unhandledRejection(Promise) {
- var logError = noop;
- var logInfo = noop;
- var localConsole;
- if(typeof console !== 'undefined') {
- // Alias console to prevent things like uglify's drop_console option from
- // removing console.log/error. Unhandled rejections fall into the same
- // category as uncaught exceptions, and build tools shouldn't silence them.
- localConsole = console;
- logError = typeof localConsole.error !== 'undefined'
- ? function (e) { localConsole.error(e); }
- : function (e) { localConsole.log(e); };
- logInfo = typeof localConsole.info !== 'undefined'
- ? function (e) { localConsole.info(e); }
- : function (e) { localConsole.log(e); };
- }
- Promise.onPotentiallyUnhandledRejection = function(rejection) {
- enqueue(report, rejection);
- };
- Promise.onPotentiallyUnhandledRejectionHandled = function(rejection) {
- enqueue(unreport, rejection);
- };
- Promise.onFatalRejection = function(rejection) {
- enqueue(throwit, rejection.value);
- };
- var tasks = [];
- var reported = [];
- var running = null;
- function report(r) {
- if(!r.handled) {
- reported.push(r);
- logError('Potentially unhandled rejection [' + r.id + '] ' + format.formatError(r.value));
- }
- }
- function unreport(r) {
- var i = reported.indexOf(r);
- if(i >= 0) {
- reported.splice(i, 1);
- logInfo('Handled previous rejection [' + r.id + '] ' + format.formatObject(r.value));
- }
- }
- function enqueue(f, x) {
- tasks.push(f, x);
- if(running === null) {
- running = setTimer(flush, 0);
- }
- }
- function flush() {
- running = null;
- while(tasks.length > 0) {
- tasks.shift()(tasks.shift());
- }
- }
- return Promise;
- };
- function throwit(e) {
- throw e;
- }
- function noop() {}
- });
- }(typeof define === 'function' && define.amd ? define : function(factory) { module.exports = factory(require); }));
- },{"../env":22,"../format":23}],21:[function(require,module,exports){
- /** @license MIT License (c) copyright 2010-2014 original author or authors */
- /** @author Brian Cavalier */
- /** @author John Hann */
- (function(define) { 'use strict';
- define(function() {
- return function addWith(Promise) {
- /**
- * Returns a promise whose handlers will be called with `this` set to
- * the supplied receiver. Subsequent promises derived from the
- * returned promise will also have their handlers called with receiver
- * as `this`. Calling `with` with undefined or no arguments will return
- * a promise whose handlers will again be called in the usual Promises/A+
- * way (no `this`) thus safely undoing any previous `with` in the
- * promise chain.
- *
- * WARNING: Promises returned from `with`/`withThis` are NOT Promises/A+
- * compliant, specifically violating 2.2.5 (http://promisesaplus.com/#point-41)
- *
- * @param {object} receiver `this` value for all handlers attached to
- * the returned promise.
- * @returns {Promise}
- */
- Promise.prototype['with'] = Promise.prototype.withThis = function(receiver) {
- var p = this._beget();
- var child = p._handler;
- child.receiver = receiver;
- this._handler.chain(child, receiver);
- return p;
- };
- return Promise;
- };
- });
- }(typeof define === 'function' && define.amd ? define : function(factory) { module.exports = factory(); }));
- },{}],22:[function(require,module,exports){
- /** @license MIT License (c) copyright 2010-2014 original author or authors */
- /** @author Brian Cavalier */
- /** @author John Hann */
- /*global process,document,setTimeout,clearTimeout,MutationObserver,WebKitMutationObserver*/
- (function(define) { 'use strict';
- define(function(require) {
- /*jshint maxcomplexity:6*/
- // Sniff "best" async scheduling option
- // Prefer process.nextTick or MutationObserver, then check for
- // setTimeout, and finally vertx, since its the only env that doesn't
- // have setTimeout
- var MutationObs;
- var capturedSetTimeout = typeof setTimeout !== 'undefined' && setTimeout;
- // Default env
- var setTimer = function(f, ms) { return setTimeout(f, ms); };
- var clearTimer = function(t) { return clearTimeout(t); };
- var asap = function (f) { return capturedSetTimeout(f, 0); };
- // Detect specific env
- if (isNode()) { // Node
- asap = function (f) { return process.nextTick(f); };
- } else if (MutationObs = hasMutationObserver()) { // Modern browser
- asap = initMutationObserver(MutationObs);
- } else if (!capturedSetTimeout) { // vert.x
- var vertxRequire = require;
- var vertx = vertxRequire('vertx');
- setTimer = function (f, ms) { return vertx.setTimer(ms, f); };
- clearTimer = vertx.cancelTimer;
- asap = vertx.runOnLoop || vertx.runOnContext;
- }
- return {
- setTimer: setTimer,
- clearTimer: clearTimer,
- asap: asap
- };
- function isNode () {
- return typeof process !== 'undefined' &&
- Object.prototype.toString.call(process) === '[object process]';
- }
- function hasMutationObserver () {
- return (typeof MutationObserver === 'function' && MutationObserver) ||
- (typeof WebKitMutationObserver === 'function' && WebKitMutationObserver);
- }
- function initMutationObserver(MutationObserver) {
- var scheduled;
- var node = document.createTextNode('');
- var o = new MutationObserver(run);
- o.observe(node, { characterData: true });
- function run() {
- var f = scheduled;
- scheduled = void 0;
- f();
- }
- var i = 0;
- return function (f) {
- scheduled = f;
- node.data = (i ^= 1);
- };
- }
- });
- }(typeof define === 'function' && define.amd ? define : function(factory) { module.exports = factory(require); }));
- },{}],23:[function(require,module,exports){
- /** @license MIT License (c) copyright 2010-2014 original author or authors */
- /** @author Brian Cavalier */
- /** @author John Hann */
- (function(define) { 'use strict';
- define(function() {
- return {
- formatError: formatError,
- formatObject: formatObject,
- tryStringify: tryStringify
- };
- /**
- * Format an error into a string. If e is an Error and has a stack property,
- * it's returned. Otherwise, e is formatted using formatObject, with a
- * warning added about e not being a proper Error.
- * @param {*} e
- * @returns {String} formatted string, suitable for output to developers
- */
- function formatError(e) {
- var s = typeof e === 'object' && e !== null && (e.stack || e.message) ? e.stack || e.message : formatObject(e);
- return e instanceof Error ? s : s + ' (WARNING: non-Error used)';
- }
- /**
- * Format an object, detecting "plain" objects and running them through
- * JSON.stringify if possible.
- * @param {Object} o
- * @returns {string}
- */
- function formatObject(o) {
- var s = String(o);
- if(s === '[object Object]' && typeof JSON !== 'undefined') {
- s = tryStringify(o, s);
- }
- return s;
- }
- /**
- * Try to return the result of JSON.stringify(x). If that fails, return
- * defaultValue
- * @param {*} x
- * @param {*} defaultValue
- * @returns {String|*} JSON.stringify(x) or defaultValue
- */
- function tryStringify(x, defaultValue) {
- try {
- return JSON.stringify(x);
- } catch(e) {
- return defaultValue;
- }
- }
- });
- }(typeof define === 'function' && define.amd ? define : function(factory) { module.exports = factory(); }));
- },{}],24:[function(require,module,exports){
- /** @license MIT License (c) copyright 2010-2014 original author or authors */
- /** @author Brian Cavalier */
- /** @author John Hann */
- (function(define) { 'use strict';
- define(function() {
- return function liftAll(liftOne, combine, dst, src) {
- if(typeof combine === 'undefined') {
- combine = defaultCombine;
- }
- return Object.keys(src).reduce(function(dst, key) {
- var f = src[key];
- return typeof f === 'function' ? combine(dst, liftOne(f), key) : dst;
- }, typeof dst === 'undefined' ? defaultDst(src) : dst);
- };
- function defaultCombine(o, f, k) {
- o[k] = f;
- return o;
- }
- function defaultDst(src) {
- return typeof src === 'function' ? src.bind() : Object.create(src);
- }
- });
- }(typeof define === 'function' && define.amd ? define : function(factory) { module.exports = factory(); }));
- },{}],25:[function(require,module,exports){
- /** @license MIT License (c) copyright 2010-2014 original author or authors */
- /** @author Brian Cavalier */
- /** @author John Hann */
- (function(define) { 'use strict';
- define(function() {
- return function makePromise(environment) {
- var tasks = environment.scheduler;
- var emitRejection = initEmitRejection();
- var objectCreate = Object.create ||
- function(proto) {
- function Child() {}
- Child.prototype = proto;
- return new Child();
- };
- /**
- * Create a promise whose fate is determined by resolver
- * @constructor
- * @returns {Promise} promise
- * @name Promise
- */
- function Promise(resolver, handler) {
- this._handler = resolver === Handler ? handler : init(resolver);
- }
- /**
- * Run the supplied resolver
- * @param resolver
- * @returns {Pending}
- */
- function init(resolver) {
- var handler = new Pending();
- try {
- resolver(promiseResolve, promiseReject, promiseNotify);
- } catch (e) {
- promiseReject(e);
- }
- return handler;
- /**
- * Transition from pre-resolution state to post-resolution state, notifying
- * all listeners of the ultimate fulfillment or rejection
- * @param {*} x resolution value
- */
- function promiseResolve (x) {
- handler.resolve(x);
- }
- /**
- * Reject this promise with reason, which will be used verbatim
- * @param {Error|*} reason rejection reason, strongly suggested
- * to be an Error type
- */
- function promiseReject (reason) {
- handler.reject(reason);
- }
- /**
- * @deprecated
- * Issue a progress event, notifying all progress listeners
- * @param {*} x progress event payload to pass to all listeners
- */
- function promiseNotify (x) {
- handler.notify(x);
- }
- }
- // Creation
- Promise.resolve = resolve;
- Promise.reject = reject;
- Promise.never = never;
- Promise._defer = defer;
- Promise._handler = getHandler;
- /**
- * Returns a trusted promise. If x is already a trusted promise, it is
- * returned, otherwise returns a new trusted Promise which follows x.
- * @param {*} x
- * @return {Promise} promise
- */
- function resolve(x) {
- return isPromise(x) ? x
- : new Promise(Handler, new Async(getHandler(x)));
- }
- /**
- * Return a reject promise with x as its reason (x is used verbatim)
- * @param {*} x
- * @returns {Promise} rejected promise
- */
- function reject(x) {
- return new Promise(Handler, new Async(new Rejected(x)));
- }
- /**
- * Return a promise that remains pending forever
- * @returns {Promise} forever-pending promise.
- */
- function never() {
- return foreverPendingPromise; // Should be frozen
- }
- /**
- * Creates an internal {promise, resolver} pair
- * @private
- * @returns {Promise}
- */
- function defer() {
- return new Promise(Handler, new Pending());
- }
- // Transformation and flow control
- /**
- * Transform this promise's fulfillment value, returning a new Promise
- * for the transformed result. If the promise cannot be fulfilled, onRejected
- * is called with the reason. onProgress *may* be called with updates toward
- * this promise's fulfillment.
- * @param {function=} onFulfilled fulfillment handler
- * @param {function=} onRejected rejection handler
- * @param {function=} onProgress @deprecated progress handler
- * @return {Promise} new promise
- */
- Promise.prototype.then = function(onFulfilled, onRejected, onProgress) {
- var parent = this._handler;
- var state = parent.join().state();
- if ((typeof onFulfilled !== 'function' && state > 0) ||
- (typeof onRejected !== 'function' && state < 0)) {
- // Short circuit: value will not change, simply share handler
- return new this.constructor(Handler, parent);
- }
- var p = this._beget();
- var child = p._handler;
- parent.chain(child, parent.receiver, onFulfilled, onRejected, onProgress);
- return p;
- };
- /**
- * If this promise cannot be fulfilled due to an error, call onRejected to
- * handle the error. Shortcut for .then(undefined, onRejected)
- * @param {function?} onRejected
- * @return {Promise}
- */
- Promise.prototype['catch'] = function(onRejected) {
- return this.then(void 0, onRejected);
- };
- /**
- * Creates a new, pending promise of the same type as this promise
- * @private
- * @returns {Promise}
- */
- Promise.prototype._beget = function() {
- return begetFrom(this._handler, this.constructor);
- };
- function begetFrom(parent, Promise) {
- var child = new Pending(parent.receiver, parent.join().context);
- return new Promise(Handler, child);
- }
- // Array combinators
- Promise.all = all;
- Promise.race = race;
- Promise._traverse = traverse;
- /**
- * Return a promise that will fulfill when all promises in the
- * input array have fulfilled, or will reject when one of the
- * promises rejects.
- * @param {array} promises array of promises
- * @returns {Promise} promise for array of fulfillment values
- */
- function all(promises) {
- return traverseWith(snd, null, promises);
- }
- /**
- * Array<Promise<X>> -> Promise<Array<f(X)>>
- * @private
- * @param {function} f function to apply to each promise's value
- * @param {Array} promises array of promises
- * @returns {Promise} promise for transformed values
- */
- function traverse(f, promises) {
- return traverseWith(tryCatch2, f, promises);
- }
- function traverseWith(tryMap, f, promises) {
- var handler = typeof f === 'function' ? mapAt : settleAt;
- var resolver = new Pending();
- var pending = promises.length >>> 0;
- var results = new Array(pending);
- for (var i = 0, x; i < promises.length && !resolver.resolved; ++i) {
- x = promises[i];
- if (x === void 0 && !(i in promises)) {
- --pending;
- continue;
- }
- traverseAt(promises, handler, i, x, resolver);
- }
- if(pending === 0) {
- resolver.become(new Fulfilled(results));
- }
- return new Promise(Handler, resolver);
- function mapAt(i, x, resolver) {
- if(!resolver.resolved) {
- traverseAt(promises, settleAt, i, tryMap(f, x, i), resolver);
- }
- }
- function settleAt(i, x, resolver) {
- results[i] = x;
- if(--pending === 0) {
- resolver.become(new Fulfilled(results));
- }
- }
- }
- function traverseAt(promises, handler, i, x, resolver) {
- if (maybeThenable(x)) {
- var h = getHandlerMaybeThenable(x);
- var s = h.state();
- if (s === 0) {
- h.fold(handler, i, void 0, resolver);
- } else if (s > 0) {
- handler(i, h.value, resolver);
- } else {
- resolver.become(h);
- visitRemaining(promises, i+1, h);
- }
- } else {
- handler(i, x, resolver);
- }
- }
- Promise._visitRemaining = visitRemaining;
- function visitRemaining(promises, start, handler) {
- for(var i=start; i<promises.length; ++i) {
- markAsHandled(getHandler(promises[i]), handler);
- }
- }
- function markAsHandled(h, handler) {
- if(h === handler) {
- return;
- }
- var s = h.state();
- if(s === 0) {
- h.visit(h, void 0, h._unreport);
- } else if(s < 0) {
- h._unreport();
- }
- }
- /**
- * Fulfill-reject competitive race. Return a promise that will settle
- * to the same state as the earliest input promise to settle.
- *
- * WARNING: The ES6 Promise spec requires that race()ing an empty array
- * must return a promise that is pending forever. This implementation
- * returns a singleton forever-pending promise, the same singleton that is
- * returned by Promise.never(), thus can be checked with ===
- *
- * @param {array} promises array of promises to race
- * @returns {Promise} if input is non-empty, a promise that will settle
- * to the same outcome as the earliest input promise to settle. if empty
- * is empty, returns a promise that will never settle.
- */
- function race(promises) {
- if(typeof promises !== 'object' || promises === null) {
- return reject(new TypeError('non-iterable passed to race()'));
- }
- // Sigh, race([]) is untestable unless we return *something*
- // that is recognizable without calling .then() on it.
- return promises.length === 0 ? never()
- : promises.length === 1 ? resolve(promises[0])
- : runRace(promises);
- }
- function runRace(promises) {
- var resolver = new Pending();
- var i, x, h;
- for(i=0; i<promises.length; ++i) {
- x = promises[i];
- if (x === void 0 && !(i in promises)) {
- continue;
- }
- h = getHandler(x);
- if(h.state() !== 0) {
- resolver.become(h);
- visitRemaining(promises, i+1, h);
- break;
- } else {
- h.visit(resolver, resolver.resolve, resolver.reject);
- }
- }
- return new Promise(Handler, resolver);
- }
- // Promise internals
- // Below this, everything is @private
- /**
- * Get an appropriate handler for x, without checking for cycles
- * @param {*} x
- * @returns {object} handler
- */
- function getHandler(x) {
- if(isPromise(x)) {
- return x._handler.join();
- }
- return maybeThenable(x) ? getHandlerUntrusted(x) : new Fulfilled(x);
- }
- /**
- * Get a handler for thenable x.
- * NOTE: You must only call this if maybeThenable(x) == true
- * @param {object|function|Promise} x
- * @returns {object} handler
- */
- function getHandlerMaybeThenable(x) {
- return isPromise(x) ? x._handler.join() : getHandlerUntrusted(x);
- }
- /**
- * Get a handler for potentially untrusted thenable x
- * @param {*} x
- * @returns {object} handler
- */
- function getHandlerUntrusted(x) {
- try {
- var untrustedThen = x.then;
- return typeof untrustedThen === 'function'
- ? new Thenable(untrustedThen, x)
- : new Fulfilled(x);
- } catch(e) {
- return new Rejected(e);
- }
- }
- /**
- * Handler for a promise that is pending forever
- * @constructor
- */
- function Handler() {}
- Handler.prototype.when
- = Handler.prototype.become
- = Handler.prototype.notify // deprecated
- = Handler.prototype.fail
- = Handler.prototype._unreport
- = Handler.prototype._report
- = noop;
- Handler.prototype._state = 0;
- Handler.prototype.state = function() {
- return this._state;
- };
- /**
- * Recursively collapse handler chain to find the handler
- * nearest to the fully resolved value.
- * @returns {object} handler nearest the fully resolved value
- */
- Handler.prototype.join = function() {
- var h = this;
- while(h.handler !== void 0) {
- h = h.handler;
- }
- return h;
- };
- Handler.prototype.chain = function(to, receiver, fulfilled, rejected, progress) {
- this.when({
- resolver: to,
- receiver: receiver,
- fulfilled: fulfilled,
- rejected: rejected,
- progress: progress
- });
- };
- Handler.prototype.visit = function(receiver, fulfilled, rejected, progress) {
- this.chain(failIfRejected, receiver, fulfilled, rejected, progress);
- };
- Handler.prototype.fold = function(f, z, c, to) {
- this.when(new Fold(f, z, c, to));
- };
- /**
- * Handler that invokes fail() on any handler it becomes
- * @constructor
- */
- function FailIfRejected() {}
- inherit(Handler, FailIfRejected);
- FailIfRejected.prototype.become = function(h) {
- h.fail();
- };
- var failIfRejected = new FailIfRejected();
- /**
- * Handler that manages a queue of consumers waiting on a pending promise
- * @constructor
- */
- function Pending(receiver, inheritedContext) {
- Promise.createContext(this, inheritedContext);
- this.consumers = void 0;
- this.receiver = receiver;
- this.handler = void 0;
- this.resolved = false;
- }
- inherit(Handler, Pending);
- Pending.prototype._state = 0;
- Pending.prototype.resolve = function(x) {
- this.become(getHandler(x));
- };
- Pending.prototype.reject = function(x) {
- if(this.resolved) {
- return;
- }
- this.become(new Rejected(x));
- };
- Pending.prototype.join = function() {
- if (!this.resolved) {
- return this;
- }
- var h = this;
- while (h.handler !== void 0) {
- h = h.handler;
- if (h === this) {
- return this.handler = cycle();
- }
- }
- return h;
- };
- Pending.prototype.run = function() {
- var q = this.consumers;
- var handler = this.handler;
- this.handler = this.handler.join();
- this.consumers = void 0;
- for (var i = 0; i < q.length; ++i) {
- handler.when(q[i]);
- }
- };
- Pending.prototype.become = function(handler) {
- if(this.resolved) {
- return;
- }
- this.resolved = true;
- this.handler = handler;
- if(this.consumers !== void 0) {
- tasks.enqueue(this);
- }
- if(this.context !== void 0) {
- handler._report(this.context);
- }
- };
- Pending.prototype.when = function(continuation) {
- if(this.resolved) {
- tasks.enqueue(new ContinuationTask(continuation, this.handler));
- } else {
- if(this.consumers === void 0) {
- this.consumers = [continuation];
- } else {
- this.consumers.push(continuation);
- }
- }
- };
- /**
- * @deprecated
- */
- Pending.prototype.notify = function(x) {
- if(!this.resolved) {
- tasks.enqueue(new ProgressTask(x, this));
- }
- };
- Pending.prototype.fail = function(context) {
- var c = typeof context === 'undefined' ? this.context : context;
- this.resolved && this.handler.join().fail(c);
- };
- Pending.prototype._report = function(context) {
- this.resolved && this.handler.join()._report(context);
- };
- Pending.prototype._unreport = function() {
- this.resolved && this.handler.join()._unreport();
- };
- /**
- * Wrap another handler and force it into a future stack
- * @param {object} handler
- * @constructor
- */
- function Async(handler) {
- this.handler = handler;
- }
- inherit(Handler, Async);
- Async.prototype.when = function(continuation) {
- tasks.enqueue(new ContinuationTask(continuation, this));
- };
- Async.prototype._report = function(context) {
- this.join()._report(context);
- };
- Async.prototype._unreport = function() {
- this.join()._unreport();
- };
- /**
- * Handler that wraps an untrusted thenable and assimilates it in a future stack
- * @param {function} then
- * @param {{then: function}} thenable
- * @constructor
- */
- function Thenable(then, thenable) {
- Pending.call(this);
- tasks.enqueue(new AssimilateTask(then, thenable, this));
- }
- inherit(Pending, Thenable);
- /**
- * Handler for a fulfilled promise
- * @param {*} x fulfillment value
- * @constructor
- */
- function Fulfilled(x) {
- Promise.createContext(this);
- this.value = x;
- }
- inherit(Handler, Fulfilled);
- Fulfilled.prototype._state = 1;
- Fulfilled.prototype.fold = function(f, z, c, to) {
- runContinuation3(f, z, this, c, to);
- };
- Fulfilled.prototype.when = function(cont) {
- runContinuation1(cont.fulfilled, this, cont.receiver, cont.resolver);
- };
- var errorId = 0;
- /**
- * Handler for a rejected promise
- * @param {*} x rejection reason
- * @constructor
- */
- function Rejected(x) {
- Promise.createContext(this);
- this.id = ++errorId;
- this.value = x;
- this.handled = false;
- this.reported = false;
- this._report();
- }
- inherit(Handler, Rejected);
- Rejected.prototype._state = -1;
- Rejected.prototype.fold = function(f, z, c, to) {
- to.become(this);
- };
- Rejected.prototype.when = function(cont) {
- if(typeof cont.rejected === 'function') {
- this._unreport();
- }
- runContinuation1(cont.rejected, this, cont.receiver, cont.resolver);
- };
- Rejected.prototype._report = function(context) {
- tasks.afterQueue(new ReportTask(this, context));
- };
- Rejected.prototype._unreport = function() {
- if(this.handled) {
- return;
- }
- this.handled = true;
- tasks.afterQueue(new UnreportTask(this));
- };
- Rejected.prototype.fail = function(context) {
- this.reported = true;
- emitRejection('unhandledRejection', this);
- Promise.onFatalRejection(this, context === void 0 ? this.context : context);
- };
- function ReportTask(rejection, context) {
- this.rejection = rejection;
- this.context = context;
- }
- ReportTask.prototype.run = function() {
- if(!this.rejection.handled && !this.rejection.reported) {
- this.rejection.reported = true;
- emitRejection('unhandledRejection', this.rejection) ||
- Promise.onPotentiallyUnhandledRejection(this.rejection, this.context);
- }
- };
- function UnreportTask(rejection) {
- this.rejection = rejection;
- }
- UnreportTask.prototype.run = function() {
- if(this.rejection.reported) {
- emitRejection('rejectionHandled', this.rejection) ||
- Promise.onPotentiallyUnhandledRejectionHandled(this.rejection);
- }
- };
- // Unhandled rejection hooks
- // By default, everything is a noop
- Promise.createContext
- = Promise.enterContext
- = Promise.exitContext
- = Promise.onPotentiallyUnhandledRejection
- = Promise.onPotentiallyUnhandledRejectionHandled
- = Promise.onFatalRejection
- = noop;
- // Errors and singletons
- var foreverPendingHandler = new Handler();
- var foreverPendingPromise = new Promise(Handler, foreverPendingHandler);
- function cycle() {
- return new Rejected(new TypeError('Promise cycle'));
- }
- // Task runners
- /**
- * Run a single consumer
- * @constructor
- */
- function ContinuationTask(continuation, handler) {
- this.continuation = continuation;
- this.handler = handler;
- }
- ContinuationTask.prototype.run = function() {
- this.handler.join().when(this.continuation);
- };
- /**
- * Run a queue of progress handlers
- * @constructor
- */
- function ProgressTask(value, handler) {
- this.handler = handler;
- this.value = value;
- }
- ProgressTask.prototype.run = function() {
- var q = this.handler.consumers;
- if(q === void 0) {
- return;
- }
- for (var c, i = 0; i < q.length; ++i) {
- c = q[i];
- runNotify(c.progress, this.value, this.handler, c.receiver, c.resolver);
- }
- };
- /**
- * Assimilate a thenable, sending it's value to resolver
- * @param {function} then
- * @param {object|function} thenable
- * @param {object} resolver
- * @constructor
- */
- function AssimilateTask(then, thenable, resolver) {
- this._then = then;
- this.thenable = thenable;
- this.resolver = resolver;
- }
- AssimilateTask.prototype.run = function() {
- var h = this.resolver;
- tryAssimilate(this._then, this.thenable, _resolve, _reject, _notify);
- function _resolve(x) { h.resolve(x); }
- function _reject(x) { h.reject(x); }
- function _notify(x) { h.notify(x); }
- };
- function tryAssimilate(then, thenable, resolve, reject, notify) {
- try {
- then.call(thenable, resolve, reject, notify);
- } catch (e) {
- reject(e);
- }
- }
- /**
- * Fold a handler value with z
- * @constructor
- */
- function Fold(f, z, c, to) {
- this.f = f; this.z = z; this.c = c; this.to = to;
- this.resolver = failIfRejected;
- this.receiver = this;
- }
- Fold.prototype.fulfilled = function(x) {
- this.f.call(this.c, this.z, x, this.to);
- };
- Fold.prototype.rejected = function(x) {
- this.to.reject(x);
- };
- Fold.prototype.progress = function(x) {
- this.to.notify(x);
- };
- // Other helpers
- /**
- * @param {*} x
- * @returns {boolean} true iff x is a trusted Promise
- */
- function isPromise(x) {
- return x instanceof Promise;
- }
- /**
- * Test just enough to rule out primitives, in order to take faster
- * paths in some code
- * @param {*} x
- * @returns {boolean} false iff x is guaranteed *not* to be a thenable
- */
- function maybeThenable(x) {
- return (typeof x === 'object' || typeof x === 'function') && x !== null;
- }
- function runContinuation1(f, h, receiver, next) {
- if(typeof f !== 'function') {
- return next.become(h);
- }
- Promise.enterContext(h);
- tryCatchReject(f, h.value, receiver, next);
- Promise.exitContext();
- }
- function runContinuation3(f, x, h, receiver, next) {
- if(typeof f !== 'function') {
- return next.become(h);
- }
- Promise.enterContext(h);
- tryCatchReject3(f, x, h.value, receiver, next);
- Promise.exitContext();
- }
- /**
- * @deprecated
- */
- function runNotify(f, x, h, receiver, next) {
- if(typeof f !== 'function') {
- return next.notify(x);
- }
- Promise.enterContext(h);
- tryCatchReturn(f, x, receiver, next);
- Promise.exitContext();
- }
- function tryCatch2(f, a, b) {
- try {
- return f(a, b);
- } catch(e) {
- return reject(e);
- }
- }
- /**
- * Return f.call(thisArg, x), or if it throws return a rejected promise for
- * the thrown exception
- */
- function tryCatchReject(f, x, thisArg, next) {
- try {
- next.become(getHandler(f.call(thisArg, x)));
- } catch(e) {
- next.become(new Rejected(e));
- }
- }
- /**
- * Same as above, but includes the extra argument parameter.
- */
- function tryCatchReject3(f, x, y, thisArg, next) {
- try {
- f.call(thisArg, x, y, next);
- } catch(e) {
- next.become(new Rejected(e));
- }
- }
- /**
- * @deprecated
- * Return f.call(thisArg, x), or if it throws, *return* the exception
- */
- function tryCatchReturn(f, x, thisArg, next) {
- try {
- next.notify(f.call(thisArg, x));
- } catch(e) {
- next.notify(e);
- }
- }
- function inherit(Parent, Child) {
- Child.prototype = objectCreate(Parent.prototype);
- Child.prototype.constructor = Child;
- }
- function snd(x, y) {
- return y;
- }
- function noop() {}
- function initEmitRejection() {
- /*global process, self, CustomEvent*/
- if(typeof process !== 'undefined' && process !== null
- && typeof process.emit === 'function') {
- // Returning falsy here means to call the default
- // onPotentiallyUnhandledRejection API. This is safe even in
- // browserify since process.emit always returns falsy in browserify:
- // https://github.com/defunctzombie/node-process/blob/master/browser.js#L40-L46
- return function(type, rejection) {
- return type === 'unhandledRejection'
- ? process.emit(type, rejection.value, rejection)
- : process.emit(type, rejection);
- };
- } else if(typeof self !== 'undefined' && typeof CustomEvent === 'function') {
- return (function(noop, self, CustomEvent) {
- var hasCustomEvent = false;
- try {
- var ev = new CustomEvent('unhandledRejection');
- hasCustomEvent = ev instanceof CustomEvent;
- } catch (e) {}
- return !hasCustomEvent ? noop : function(type, rejection) {
- var ev = new CustomEvent(type, {
- detail: {
- reason: rejection.value,
- key: rejection
- },
- bubbles: false,
- cancelable: true
- });
- return !self.dispatchEvent(ev);
- };
- }(noop, self, CustomEvent));
- }
- return noop;
- }
- return Promise;
- };
- });
- }(typeof define === 'function' && define.amd ? define : function(factory) { module.exports = factory(); }));
- },{}],26:[function(require,module,exports){
- /** @license MIT License (c) copyright 2010-2014 original author or authors */
- /** @author Brian Cavalier */
- /** @author John Hann */
- (function(define) { 'use strict';
- define(function() {
- return {
- pending: toPendingState,
- fulfilled: toFulfilledState,
- rejected: toRejectedState,
- inspect: inspect
- };
- function toPendingState() {
- return { state: 'pending' };
- }
- function toRejectedState(e) {
- return { state: 'rejected', reason: e };
- }
- function toFulfilledState(x) {
- return { state: 'fulfilled', value: x };
- }
- function inspect(handler) {
- var state = handler.state();
- return state === 0 ? toPendingState()
- : state > 0 ? toFulfilledState(handler.value)
- : toRejectedState(handler.value);
- }
- });
- }(typeof define === 'function' && define.amd ? define : function(factory) { module.exports = factory(); }));
- },{}],27:[function(require,module,exports){
- /** @license MIT License (c) copyright 2010-2014 original author or authors */
- /** @author Brian Cavalier */
- /** @author John Hann */
- (function(define) { 'use strict';
- define(function(require) {
- var PromiseMonitor = require('./monitor/PromiseMonitor');
- var ConsoleReporter = require('./monitor/ConsoleReporter');
- var promiseMonitor = new PromiseMonitor(new ConsoleReporter());
- return function(Promise) {
- return promiseMonitor.monitor(Promise);
- };
- });
- }(typeof define === 'function' && define.amd ? define : function(factory) { module.exports = factory(require); }));
- },{"./monitor/ConsoleReporter":28,"./monitor/PromiseMonitor":29}],28:[function(require,module,exports){
- /** @license MIT License (c) copyright 2010-2014 original author or authors */
- /** @author Brian Cavalier */
- /** @author John Hann */
- (function(define) { 'use strict';
- define(function(require) {
- var error = require('./error');
- var unhandledRejectionsMsg = '[promises] Unhandled rejections: ';
- var allHandledMsg = '[promises] All previously unhandled rejections have now been handled';
- function ConsoleReporter() {
- this._previouslyReported = false;
- }
- ConsoleReporter.prototype = initDefaultLogging();
- ConsoleReporter.prototype.log = function(traces) {
- if(traces.length === 0) {
- if(this._previouslyReported) {
- this._previouslyReported = false;
- this.msg(allHandledMsg);
- }
- return;
- }
- this._previouslyReported = true;
- this.groupStart(unhandledRejectionsMsg + traces.length);
- try {
- this._log(traces);
- } finally {
- this.groupEnd();
- }
- };
- ConsoleReporter.prototype._log = function(traces) {
- for(var i=0; i<traces.length; ++i) {
- this.warn(error.format(traces[i]));
- }
- };
- function initDefaultLogging() {
- /*jshint maxcomplexity:7*/
- var log, warn, groupStart, groupEnd;
- if(typeof console === 'undefined') {
- log = warn = consoleNotAvailable;
- } else {
- // Alias console to prevent things like uglify's drop_console option from
- // removing console.log/error. Unhandled rejections fall into the same
- // category as uncaught exceptions, and build tools shouldn't silence them.
- var localConsole = console;
- if(typeof localConsole.error === 'function'
- && typeof localConsole.dir === 'function') {
- warn = function(s) {
- localConsole.error(s);
- };
- log = function(s) {
- localConsole.log(s);
- };
- if(typeof localConsole.groupCollapsed === 'function') {
- groupStart = function(s) {
- localConsole.groupCollapsed(s);
- };
- groupEnd = function() {
- localConsole.groupEnd();
- };
- }
- } else {
- // IE8 has console.log and JSON, so we can make a
- // reasonably useful warn() from those.
- // Credit to webpro (https://github.com/webpro) for this idea
- // typeof localConsole.log will return 'object' in IE8, so can't test it with === 'function'
- // Since this is more of a corner case for IE8, I'm ok to check it with !== 'undefined' to reduce complexity
- if (typeof localConsole.log !== 'undefined' && typeof JSON !== 'undefined') {
- log = warn = function(x) {
- if (typeof x !== 'string') {
- try {
- x = JSON.stringify(x);
- } catch (e) {
- }
- }
- localConsole.log(x);
- };
- } else {
- log = warn = consoleNotAvailable;
- }
- }
- }
- return {
- msg: log,
- warn: warn,
- groupStart: groupStart || warn,
- groupEnd: groupEnd || consoleNotAvailable
- };
- }
- function consoleNotAvailable() {}
- return ConsoleReporter;
- });
- }(typeof define === 'function' && define.amd ? define : function(factory) { module.exports = factory(require); }));
- },{"./error":31}],29:[function(require,module,exports){
- /** @license MIT License (c) copyright 2010-2014 original author or authors */
- /** @author Brian Cavalier */
- /** @author John Hann */
- (function(define) { 'use strict';
- define(function(require) {
- var defaultStackJumpSeparator = 'from execution context:';
- var defaultStackFilter = /[\s\(\/\\](node|module|timers)\.js:|when([\/\\]{1,2}(lib|monitor|es6-shim)[\/\\]{1,2}|\.js)|(new\sPromise)\b|(\b(PromiseMonitor|ConsoleReporter|Scheduler|RunHandlerTask|ProgressTask|Promise|.*Handler)\.[\w_]\w\w+\b)|\b(tryCatch\w+|getHandler\w*)\b/i;
- var setTimer = require('../lib/env').setTimer;
- var error = require('./error');
- var executionContext = [];
- function PromiseMonitor(reporter) {
- this.logDelay = 0;
- this.stackFilter = defaultStackFilter;
- this.stackJumpSeparator = defaultStackJumpSeparator;
- this.filterDuplicateFrames = true;
- this._reporter = reporter;
- if(typeof reporter.configurePromiseMonitor === 'function') {
- reporter.configurePromiseMonitor(this);
- }
- this._traces = [];
- this._traceTask = 0;
- var self = this;
- this._doLogTraces = function() {
- self._logTraces();
- };
- }
- PromiseMonitor.prototype.monitor = function(Promise) {
- var self = this;
- Promise.createContext = function(p, context) {
- p.context = self.createContext(p, context);
- };
- Promise.enterContext = function(p) {
- executionContext.push(p.context);
- };
- Promise.exitContext = function() {
- executionContext.pop();
- };
- Promise.onPotentiallyUnhandledRejection = function(rejection, extraContext) {
- return self.addTrace(rejection, extraContext);
- };
- Promise.onPotentiallyUnhandledRejectionHandled = function(rejection) {
- return self.removeTrace(rejection);
- };
- Promise.onFatalRejection = function(rejection, extraContext) {
- return self.fatal(rejection, extraContext);
- };
- return this;
- };
- PromiseMonitor.prototype.createContext = function(at, parentContext) {
- var context = {
- parent: parentContext || executionContext[executionContext.length - 1],
- stack: void 0
- };
- error.captureStack(context, at.constructor);
- return context;
- };
- PromiseMonitor.prototype.addTrace = function(handler, extraContext) {
- var t, i;
- for(i = this._traces.length-1; i >= 0; --i) {
- t = this._traces[i];
- if(t.handler === handler) {
- break;
- }
- }
- if(i >= 0) {
- t.extraContext = extraContext;
- } else {
- this._traces.push({
- handler: handler,
- extraContext: extraContext
- });
- }
- this.logTraces();
- };
- PromiseMonitor.prototype.removeTrace = function(/*handler*/) {
- this.logTraces();
- };
- PromiseMonitor.prototype.fatal = function(handler, extraContext) {
- var err = new Error();
- err.stack = this._createLongTrace(handler.value, handler.context, extraContext).join('\n');
- setTimer(function() {
- throw err;
- }, 0);
- };
- PromiseMonitor.prototype.logTraces = function() {
- if(!this._traceTask) {
- this._traceTask = setTimer(this._doLogTraces, this.logDelay);
- }
- };
- PromiseMonitor.prototype._logTraces = function() {
- this._traceTask = void 0;
- this._traces = this._traces.filter(filterHandled);
- this._reporter.log(this.formatTraces(this._traces));
- };
- PromiseMonitor.prototype.formatTraces = function(traces) {
- return traces.map(function(t) {
- return this._createLongTrace(t.handler.value, t.handler.context, t.extraContext);
- }, this);
- };
- PromiseMonitor.prototype._createLongTrace = function(e, context, extraContext) {
- var trace = error.parse(e) || [String(e) + ' (WARNING: non-Error used)'];
- trace = filterFrames(this.stackFilter, trace, 0);
- this._appendContext(trace, context);
- this._appendContext(trace, extraContext);
- return this.filterDuplicateFrames ? this._removeDuplicates(trace) : trace;
- };
- PromiseMonitor.prototype._removeDuplicates = function(trace) {
- var seen = {};
- var sep = this.stackJumpSeparator;
- var count = 0;
- return trace.reduceRight(function(deduped, line, i) {
- if(i === 0) {
- deduped.unshift(line);
- } else if(line === sep) {
- if(count > 0) {
- deduped.unshift(line);
- count = 0;
- }
- } else if(!seen[line]) {
- seen[line] = true;
- deduped.unshift(line);
- ++count;
- }
- return deduped;
- }, []);
- };
- PromiseMonitor.prototype._appendContext = function(trace, context) {
- trace.push.apply(trace, this._createTrace(context));
- };
- PromiseMonitor.prototype._createTrace = function(traceChain) {
- var trace = [];
- var stack;
- while(traceChain) {
- stack = error.parse(traceChain);
- if (stack) {
- stack = filterFrames(this.stackFilter, stack);
- appendStack(trace, stack, this.stackJumpSeparator);
- }
- traceChain = traceChain.parent;
- }
- return trace;
- };
- function appendStack(trace, stack, separator) {
- if (stack.length > 1) {
- stack[0] = separator;
- trace.push.apply(trace, stack);
- }
- }
- function filterFrames(stackFilter, stack) {
- return stack.filter(function(frame) {
- return !stackFilter.test(frame);
- });
- }
- function filterHandled(t) {
- return !t.handler.handled;
- }
- return PromiseMonitor;
- });
- }(typeof define === 'function' && define.amd ? define : function(factory) { module.exports = factory(require); }));
- },{"../lib/env":22,"./error":31}],30:[function(require,module,exports){
- /** @license MIT License (c) copyright 2010-2014 original author or authors */
- /** @author Brian Cavalier */
- /** @author John Hann */
- (function(define) { 'use strict';
- define(function(require) {
- var monitor = require('../monitor');
- var Promise = require('../when').Promise;
- return monitor(Promise);
- });
- }(typeof define === 'function' && define.amd ? define : function(factory) { module.exports = factory(require); }));
- },{"../monitor":27,"../when":38}],31:[function(require,module,exports){
- /** @license MIT License (c) copyright 2010-2014 original author or authors */
- /** @author Brian Cavalier */
- /** @author John Hann */
- (function(define) { 'use strict';
- define(function() {
- var parse, captureStack, format;
- if(Error.captureStackTrace) {
- // Use Error.captureStackTrace if available
- parse = function(e) {
- return e && e.stack && e.stack.split('\n');
- };
- format = formatAsString;
- captureStack = Error.captureStackTrace;
- } else {
- // Otherwise, do minimal feature detection to determine
- // how to capture and format reasonable stacks.
- parse = function(e) {
- var stack = e && e.stack && e.stack.split('\n');
- if(stack && e.message) {
- stack.unshift(e.message);
- }
- return stack;
- };
- (function() {
- var e = new Error();
- if(typeof e.stack !== 'string') {
- format = formatAsString;
- captureStack = captureSpiderMonkeyStack;
- } else {
- format = formatAsErrorWithStack;
- captureStack = useStackDirectly;
- }
- }());
- }
- function captureSpiderMonkeyStack(host) {
- try {
- throw new Error();
- } catch(err) {
- host.stack = err.stack;
- }
- }
- function useStackDirectly(host) {
- host.stack = new Error().stack;
- }
- function formatAsString(longTrace) {
- return join(longTrace);
- }
- function formatAsErrorWithStack(longTrace) {
- var e = new Error();
- e.stack = formatAsString(longTrace);
- return e;
- }
- // About 5-10x faster than String.prototype.join o_O
- function join(a) {
- var sep = false;
- var s = '';
- for(var i=0; i< a.length; ++i) {
- if(sep) {
- s += '\n' + a[i];
- } else {
- s+= a[i];
- sep = true;
- }
- }
- return s;
- }
- return {
- parse: parse,
- format: format,
- captureStack: captureStack
- };
- });
- }(typeof define === 'function' && define.amd ? define : function(factory) { module.exports = factory(); }));
- },{}],32:[function(require,module,exports){
- /** @license MIT License (c) copyright 2013 original author or authors */
- /**
- * Collection of helpers for interfacing with node-style asynchronous functions
- * using promises.
- *
- * @author Brian Cavalier
- * @contributor Renato Zannon
- */
- (function(define) {
- define(function(require) {
- var when = require('./when');
- var _liftAll = require('./lib/liftAll');
- var setTimer = require('./lib/env').setTimer;
- var slice = Array.prototype.slice;
- var _apply = require('./lib/apply')(when.Promise, dispatch);
- return {
- lift: lift,
- liftAll: liftAll,
- apply: apply,
- call: call,
- createCallback: createCallback,
- bindCallback: bindCallback,
- liftCallback: liftCallback
- };
- /**
- * Takes a node-style async function and calls it immediately (with an optional
- * array of arguments or promises for arguments). It returns a promise whose
- * resolution depends on whether the async functions calls its callback with the
- * conventional error argument or not.
- *
- * With this it becomes possible to leverage existing APIs while still reaping
- * the benefits of promises.
- *
- * @example
- * function onlySmallNumbers(n, callback) {
- * if(n < 10) {
- * callback(null, n + 10);
- * } else {
- * callback(new Error("Calculation failed"));
- * }
- * }
- *
- * var nodefn = require("when/node/function");
- *
- * // Logs '15'
- * nodefn.apply(onlySmallNumbers, [5]).then(console.log, console.error);
- *
- * // Logs 'Calculation failed'
- * nodefn.apply(onlySmallNumbers, [15]).then(console.log, console.error);
- *
- * @param {function} f node-style function that will be called
- * @param {Array} [args] array of arguments to func
- * @returns {Promise} promise for the value func passes to its callback
- */
- function apply(f, args) {
- return _apply(f, this, args || []);
- }
- function dispatch(f, thisArg, args, h) {
- var cb = createCallback(h);
- try {
- switch(args.length) {
- case 2: f.call(thisArg, args[0], args[1], cb); break;
- case 1: f.call(thisArg, args[0], cb); break;
- case 0: f.call(thisArg, cb); break;
- default:
- args.push(cb);
- f.apply(thisArg, args);
- }
- } catch(e) {
- h.reject(e);
- }
- }
- /**
- * Has the same behavior that {@link apply} has, with the difference that the
- * arguments to the function are provided individually, while {@link apply} accepts
- * a single array.
- *
- * @example
- * function sumSmallNumbers(x, y, callback) {
- * var result = x + y;
- * if(result < 10) {
- * callback(null, result);
- * } else {
- * callback(new Error("Calculation failed"));
- * }
- * }
- *
- * // Logs '5'
- * nodefn.call(sumSmallNumbers, 2, 3).then(console.log, console.error);
- *
- * // Logs 'Calculation failed'
- * nodefn.call(sumSmallNumbers, 5, 10).then(console.log, console.error);
- *
- * @param {function} f node-style function that will be called
- * @param {...*} [args] arguments that will be forwarded to the function
- * @returns {Promise} promise for the value func passes to its callback
- */
- function call(f /*, args... */) {
- return _apply(f, this, slice.call(arguments, 1));
- }
- /**
- * Takes a node-style function and returns new function that wraps the
- * original and, instead of taking a callback, returns a promise. Also, it
- * knows how to handle promises given as arguments, waiting for their
- * resolution before executing.
- *
- * Upon execution, the orginal function is executed as well. If it passes
- * a truthy value as the first argument to the callback, it will be
- * interpreted as an error condition, and the promise will be rejected
- * with it. Otherwise, the call is considered a resolution, and the promise
- * is resolved with the callback's second argument.
- *
- * @example
- * var fs = require("fs"), nodefn = require("when/node/function");
- *
- * var promiseRead = nodefn.lift(fs.readFile);
- *
- * // The promise is resolved with the contents of the file if everything
- * // goes ok
- * promiseRead('exists.txt').then(console.log, console.error);
- *
- * // And will be rejected if something doesn't work out
- * // (e.g. the files does not exist)
- * promiseRead('doesnt_exist.txt').then(console.log, console.error);
- *
- *
- * @param {Function} f node-style function to be lifted
- * @param {...*} [args] arguments to be prepended for the new function @deprecated
- * @returns {Function} a promise-returning function
- */
- function lift(f /*, args... */) {
- var args1 = arguments.length > 1 ? slice.call(arguments, 1) : [];
- return function() {
- // TODO: Simplify once partialing has been removed
- var l = args1.length;
- var al = arguments.length;
- var args = new Array(al + l);
- var i;
- for(i=0; i<l; ++i) {
- args[i] = args1[i];
- }
- for(i=0; i<al; ++i) {
- args[i+l] = arguments[i];
- }
- return _apply(f, this, args);
- };
- }
- /**
- * Lift all the functions/methods on src
- * @param {object|function} src source whose functions will be lifted
- * @param {function?} combine optional function for customizing the lifting
- * process. It is passed dst, the lifted function, and the property name of
- * the original function on src.
- * @param {(object|function)?} dst option destination host onto which to place lifted
- * functions. If not provided, liftAll returns a new object.
- * @returns {*} If dst is provided, returns dst with lifted functions as
- * properties. If dst not provided, returns a new object with lifted functions.
- */
- function liftAll(src, combine, dst) {
- return _liftAll(lift, combine, dst, src);
- }
- /**
- * Takes an object that responds to the resolver interface, and returns
- * a function that will resolve or reject it depending on how it is called.
- *
- * @example
- * function callbackTakingFunction(callback) {
- * if(somethingWrongHappened) {
- * callback(error);
- * } else {
- * callback(null, interestingValue);
- * }
- * }
- *
- * var when = require('when'), nodefn = require('when/node/function');
- *
- * var deferred = when.defer();
- * callbackTakingFunction(nodefn.createCallback(deferred.resolver));
- *
- * deferred.promise.then(function(interestingValue) {
- * // Use interestingValue
- * });
- *
- * @param {Resolver} resolver that will be 'attached' to the callback
- * @returns {Function} a node-style callback function
- */
- function createCallback(resolver) {
- return function(err, value) {
- if(err) {
- resolver.reject(err);
- } else if(arguments.length > 2) {
- resolver.resolve(slice.call(arguments, 1));
- } else {
- resolver.resolve(value);
- }
- };
- }
- /**
- * Attaches a node-style callback to a promise, ensuring the callback is
- * called for either fulfillment or rejection. Returns a promise with the same
- * state as the passed-in promise.
- *
- * @example
- * var deferred = when.defer();
- *
- * function callback(err, value) {
- * // Handle err or use value
- * }
- *
- * bindCallback(deferred.promise, callback);
- *
- * deferred.resolve('interesting value');
- *
- * @param {Promise} promise The promise to be attached to.
- * @param {Function} callback The node-style callback to attach.
- * @returns {Promise} A promise with the same state as the passed-in promise.
- */
- function bindCallback(promise, callback) {
- promise = when(promise);
- if (callback) {
- promise.then(success, wrapped);
- }
- return promise;
- function success(value) {
- wrapped(null, value);
- }
- function wrapped(err, value) {
- setTimer(function () {
- callback(err, value);
- }, 0);
- }
- }
- /**
- * Takes a node-style callback and returns new function that accepts a
- * promise, calling the original callback when the promise is either
- * fulfilled or rejected with the appropriate arguments.
- *
- * @example
- * var deferred = when.defer();
- *
- * function callback(err, value) {
- * // Handle err or use value
- * }
- *
- * var wrapped = liftCallback(callback);
- *
- * // `wrapped` can now be passed around at will
- * wrapped(deferred.promise);
- *
- * deferred.resolve('interesting value');
- *
- * @param {Function} callback The node-style callback to wrap.
- * @returns {Function} The lifted, promise-accepting function.
- */
- function liftCallback(callback) {
- return function(promise) {
- return bindCallback(promise, callback);
- };
- }
- });
- })(typeof define === 'function' && define.amd ? define : function (factory) { module.exports = factory(require); });
- },{"./lib/apply":12,"./lib/env":22,"./lib/liftAll":24,"./when":38}],33:[function(require,module,exports){
- /** @license MIT License (c) copyright 2011-2013 original author or authors */
- /**
- * parallel.js
- *
- * Run a set of task functions in parallel. All tasks will
- * receive the same args
- *
- * @author Brian Cavalier
- * @author John Hann
- */
- (function(define) {
- define(function(require) {
- var when = require('./when');
- var all = when.Promise.all;
- var slice = Array.prototype.slice;
- /**
- * Run array of tasks in parallel
- * @param tasks {Array|Promise} array or promiseForArray of task functions
- * @param [args] {*} arguments to be passed to all tasks
- * @return {Promise} promise for array containing the
- * result of each task in the array position corresponding
- * to position of the task in the tasks array
- */
- return function parallel(tasks /*, args... */) {
- return all(slice.call(arguments, 1)).then(function(args) {
- return when.map(tasks, function(task) {
- return task.apply(void 0, args);
- });
- });
- };
- });
- })(typeof define === 'function' && define.amd ? define : function (factory) { module.exports = factory(require); });
- },{"./when":38}],34:[function(require,module,exports){
- /** @license MIT License (c) copyright 2011-2013 original author or authors */
- /**
- * pipeline.js
- *
- * Run a set of task functions in sequence, passing the result
- * of the previous as an argument to the next. Like a shell
- * pipeline, e.g. `cat file.txt | grep 'foo' | sed -e 's/foo/bar/g'
- *
- * @author Brian Cavalier
- * @author John Hann
- */
- (function(define) {
- define(function(require) {
- var when = require('./when');
- var all = when.Promise.all;
- var slice = Array.prototype.slice;
- /**
- * Run array of tasks in a pipeline where the next
- * tasks receives the result of the previous. The first task
- * will receive the initialArgs as its argument list.
- * @param tasks {Array|Promise} array or promise for array of task functions
- * @param [initialArgs...] {*} arguments to be passed to the first task
- * @return {Promise} promise for return value of the final task
- */
- return function pipeline(tasks /* initialArgs... */) {
- // Self-optimizing function to run first task with multiple
- // args using apply, but subsequence tasks via direct invocation
- var runTask = function(args, task) {
- runTask = function(arg, task) {
- return task(arg);
- };
- return task.apply(null, args);
- };
- return all(slice.call(arguments, 1)).then(function(args) {
- return when.reduce(tasks, function(arg, task) {
- return runTask(arg, task);
- }, args);
- });
- };
- });
- })(typeof define === 'function' && define.amd ? define : function (factory) { module.exports = factory(require); });
- },{"./when":38}],35:[function(require,module,exports){
- /** @license MIT License (c) copyright 2012-2013 original author or authors */
- /**
- * poll.js
- *
- * Helper that polls until cancelled or for a condition to become true.
- *
- * @author Scott Andrews
- */
- (function (define) { 'use strict';
- define(function(require) {
- var when = require('./when');
- var attempt = when['try'];
- var cancelable = require('./cancelable');
- /**
- * Periodically execute the task function on the msec delay. The result of
- * the task may be verified by watching for a condition to become true. The
- * returned deferred is cancellable if the polling needs to be cancelled
- * externally before reaching a resolved state.
- *
- * The next vote is scheduled after the results of the current vote are
- * verified and rejected.
- *
- * Polling may be terminated by the verifier returning a truthy value,
- * invoking cancel() on the returned promise, or the task function returning
- * a rejected promise.
- *
- * Usage:
- *
- * var count = 0;
- * function doSomething() { return count++ }
- *
- * // poll until cancelled
- * var p = poll(doSomething, 1000);
- * ...
- * p.cancel();
- *
- * // poll until condition is met
- * poll(doSomething, 1000, function(result) { return result > 10 })
- * .then(function(result) { assert result == 10 });
- *
- * // delay first vote
- * poll(doSomething, 1000, anyFunc, true);
- *
- * @param task {Function} function that is executed after every timeout
- * @param interval {number|Function} timeout in milliseconds
- * @param [verifier] {Function} function to evaluate the result of the vote.
- * May return a {Promise} or a {Boolean}. Rejecting the promise or a
- * falsey value will schedule the next vote.
- * @param [delayInitialTask] {boolean} if truthy, the first vote is scheduled
- * instead of immediate
- *
- * @returns {Promise}
- */
- return function poll(task, interval, verifier, delayInitialTask) {
- var deferred, canceled, reject;
- canceled = false;
- deferred = cancelable(when.defer(), function () { canceled = true; });
- reject = deferred.reject;
- verifier = verifier || function () { return false; };
- if (typeof interval !== 'function') {
- interval = (function (interval) {
- return function () { return when().delay(interval); };
- })(interval);
- }
- function certify(result) {
- deferred.resolve(result);
- }
- function schedule(result) {
- attempt(interval).then(vote, reject);
- if (result !== void 0) {
- deferred.notify(result);
- }
- }
- function vote() {
- if (canceled) { return; }
- when(task(),
- function (result) {
- when(verifier(result),
- function (verification) {
- return verification ? certify(result) : schedule(result);
- },
- function () { schedule(result); }
- );
- },
- reject
- );
- }
- if (delayInitialTask) {
- schedule();
- } else {
- // if task() is blocking, vote will also block
- vote();
- }
- // make the promise cancelable
- deferred.promise = Object.create(deferred.promise);
- deferred.promise.cancel = deferred.cancel;
- return deferred.promise;
- };
- });
- })(typeof define === 'function' && define.amd ? define : function (factory) { module.exports = factory(require); });
- },{"./cancelable":4,"./when":38}],36:[function(require,module,exports){
- /** @license MIT License (c) copyright 2011-2013 original author or authors */
- /**
- * sequence.js
- *
- * Run a set of task functions in sequence. All tasks will
- * receive the same args.
- *
- * @author Brian Cavalier
- * @author John Hann
- */
- (function(define) {
- define(function(require) {
- var when = require('./when');
- var all = when.Promise.all;
- var slice = Array.prototype.slice;
- /**
- * Run array of tasks in sequence with no overlap
- * @param tasks {Array|Promise} array or promiseForArray of task functions
- * @param [args] {*} arguments to be passed to all tasks
- * @return {Promise} promise for an array containing
- * the result of each task in the array position corresponding
- * to position of the task in the tasks array
- */
- return function sequence(tasks /*, args... */) {
- var results = [];
- return all(slice.call(arguments, 1)).then(function(args) {
- return when.reduce(tasks, function(results, task) {
- return when(task.apply(void 0, args), addResult);
- }, results);
- });
- function addResult(result) {
- results.push(result);
- return results;
- }
- };
- });
- })(typeof define === 'function' && define.amd ? define : function (factory) { module.exports = factory(require); });
- },{"./when":38}],37:[function(require,module,exports){
- /** @license MIT License (c) copyright 2011-2013 original author or authors */
- /**
- * timeout.js
- *
- * Helper that returns a promise that rejects after a specified timeout,
- * if not explicitly resolved or rejected before that.
- *
- * @author Brian Cavalier
- * @author John Hann
- */
- (function(define) {
- define(function(require) {
- var when = require('./when');
- /**
- * @deprecated Use when(trigger).timeout(ms)
- */
- return function timeout(msec, trigger) {
- return when(trigger).timeout(msec);
- };
- });
- })(typeof define === 'function' && define.amd ? define : function (factory) { module.exports = factory(require); });
- },{"./when":38}],38:[function(require,module,exports){
- /** @license MIT License (c) copyright 2010-2014 original author or authors */
- /**
- * Promises/A+ and when() implementation
- * when is part of the cujoJS family of libraries (http://cujojs.com/)
- * @author Brian Cavalier
- * @author John Hann
- */
- (function(define) { 'use strict';
- define(function (require) {
- var timed = require('./lib/decorators/timed');
- var array = require('./lib/decorators/array');
- var flow = require('./lib/decorators/flow');
- var fold = require('./lib/decorators/fold');
- var inspect = require('./lib/decorators/inspect');
- var generate = require('./lib/decorators/iterate');
- var progress = require('./lib/decorators/progress');
- var withThis = require('./lib/decorators/with');
- var unhandledRejection = require('./lib/decorators/unhandledRejection');
- var TimeoutError = require('./lib/TimeoutError');
- var Promise = [array, flow, fold, generate, progress,
- inspect, withThis, timed, unhandledRejection]
- .reduce(function(Promise, feature) {
- return feature(Promise);
- }, require('./lib/Promise'));
- var apply = require('./lib/apply')(Promise);
- // Public API
- when.promise = promise; // Create a pending promise
- when.resolve = Promise.resolve; // Create a resolved promise
- when.reject = Promise.reject; // Create a rejected promise
- when.lift = lift; // lift a function to return promises
- when['try'] = attempt; // call a function and return a promise
- when.attempt = attempt; // alias for when.try
- when.iterate = Promise.iterate; // DEPRECATED (use cujojs/most streams) Generate a stream of promises
- when.unfold = Promise.unfold; // DEPRECATED (use cujojs/most streams) Generate a stream of promises
- when.join = join; // Join 2 or more promises
- when.all = all; // Resolve a list of promises
- when.settle = settle; // Settle a list of promises
- when.any = lift(Promise.any); // One-winner race
- when.some = lift(Promise.some); // Multi-winner race
- when.race = lift(Promise.race); // First-to-settle race
- when.map = map; // Array.map() for promises
- when.filter = filter; // Array.filter() for promises
- when.reduce = lift(Promise.reduce); // Array.reduce() for promises
- when.reduceRight = lift(Promise.reduceRight); // Array.reduceRight() for promises
- when.isPromiseLike = isPromiseLike; // Is something promise-like, aka thenable
- when.Promise = Promise; // Promise constructor
- when.defer = defer; // Create a {promise, resolve, reject} tuple
- // Error types
- when.TimeoutError = TimeoutError;
- /**
- * Get a trusted promise for x, or by transforming x with onFulfilled
- *
- * @param {*} x
- * @param {function?} onFulfilled callback to be called when x is
- * successfully fulfilled. If promiseOrValue is an immediate value, callback
- * will be invoked immediately.
- * @param {function?} onRejected callback to be called when x is
- * rejected.
- * @param {function?} onProgress callback to be called when progress updates
- * are issued for x. @deprecated
- * @returns {Promise} a new promise that will fulfill with the return
- * value of callback or errback or the completion value of promiseOrValue if
- * callback and/or errback is not supplied.
- */
- function when(x, onFulfilled, onRejected, onProgress) {
- var p = Promise.resolve(x);
- if (arguments.length < 2) {
- return p;
- }
- return p.then(onFulfilled, onRejected, onProgress);
- }
- /**
- * Creates a new promise whose fate is determined by resolver.
- * @param {function} resolver function(resolve, reject, notify)
- * @returns {Promise} promise whose fate is determine by resolver
- */
- function promise(resolver) {
- return new Promise(resolver);
- }
- /**
- * Lift the supplied function, creating a version of f that returns
- * promises, and accepts promises as arguments.
- * @param {function} f
- * @returns {Function} version of f that returns promises
- */
- function lift(f) {
- return function() {
- for(var i=0, l=arguments.length, a=new Array(l); i<l; ++i) {
- a[i] = arguments[i];
- }
- return apply(f, this, a);
- };
- }
- /**
- * Call f in a future turn, with the supplied args, and return a promise
- * for the result.
- * @param {function} f
- * @returns {Promise}
- */
- function attempt(f /*, args... */) {
- /*jshint validthis:true */
- for(var i=0, l=arguments.length-1, a=new Array(l); i<l; ++i) {
- a[i] = arguments[i+1];
- }
- return apply(f, this, a);
- }
- /**
- * Creates a {promise, resolver} pair, either or both of which
- * may be given out safely to consumers.
- * @return {{promise: Promise, resolve: function, reject: function, notify: function}}
- */
- function defer() {
- return new Deferred();
- }
- function Deferred() {
- var p = Promise._defer();
- function resolve(x) { p._handler.resolve(x); }
- function reject(x) { p._handler.reject(x); }
- function notify(x) { p._handler.notify(x); }
- this.promise = p;
- this.resolve = resolve;
- this.reject = reject;
- this.notify = notify;
- this.resolver = { resolve: resolve, reject: reject, notify: notify };
- }
- /**
- * Determines if x is promise-like, i.e. a thenable object
- * NOTE: Will return true for *any thenable object*, and isn't truly
- * safe, since it may attempt to access the `then` property of x (i.e.
- * clever/malicious getters may do weird things)
- * @param {*} x anything
- * @returns {boolean} true if x is promise-like
- */
- function isPromiseLike(x) {
- return x && typeof x.then === 'function';
- }
- /**
- * Return a promise that will resolve only once all the supplied arguments
- * have resolved. The resolution value of the returned promise will be an array
- * containing the resolution values of each of the arguments.
- * @param {...*} arguments may be a mix of promises and values
- * @returns {Promise}
- */
- function join(/* ...promises */) {
- return Promise.all(arguments);
- }
- /**
- * Return a promise that will fulfill once all input promises have
- * fulfilled, or reject when any one input promise rejects.
- * @param {array|Promise} promises array (or promise for an array) of promises
- * @returns {Promise}
- */
- function all(promises) {
- return when(promises, Promise.all);
- }
- /**
- * Return a promise that will always fulfill with an array containing
- * the outcome states of all input promises. The returned promise
- * will only reject if `promises` itself is a rejected promise.
- * @param {array|Promise} promises array (or promise for an array) of promises
- * @returns {Promise} promise for array of settled state descriptors
- */
- function settle(promises) {
- return when(promises, Promise.settle);
- }
- /**
- * Promise-aware array map function, similar to `Array.prototype.map()`,
- * but input array may contain promises or values.
- * @param {Array|Promise} promises array of anything, may contain promises and values
- * @param {function(x:*, index:Number):*} mapFunc map function which may
- * return a promise or value
- * @returns {Promise} promise that will fulfill with an array of mapped values
- * or reject if any input promise rejects.
- */
- function map(promises, mapFunc) {
- return when(promises, function(promises) {
- return Promise.map(promises, mapFunc);
- });
- }
- /**
- * Filter the provided array of promises using the provided predicate. Input may
- * contain promises and values
- * @param {Array|Promise} promises array of promises and values
- * @param {function(x:*, index:Number):boolean} predicate filtering predicate.
- * Must return truthy (or promise for truthy) for items to retain.
- * @returns {Promise} promise that will fulfill with an array containing all items
- * for which predicate returned truthy.
- */
- function filter(promises, predicate) {
- return when(promises, function(promises) {
- return Promise.filter(promises, predicate);
- });
- }
- return when;
- });
- })(typeof define === 'function' && define.amd ? define : function (factory) { module.exports = factory(require); });
- },{"./lib/Promise":9,"./lib/TimeoutError":11,"./lib/apply":12,"./lib/decorators/array":13,"./lib/decorators/flow":14,"./lib/decorators/fold":15,"./lib/decorators/inspect":16,"./lib/decorators/iterate":17,"./lib/decorators/progress":18,"./lib/decorators/timed":19,"./lib/decorators/unhandledRejection":20,"./lib/decorators/with":21}]},{},[1])
- //# sourceMappingURL=when.debug.js.map
- (1)
- });
- ;
|