async.js 229 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889289028912892289328942895289628972898289929002901290229032904290529062907290829092910291129122913291429152916291729182919292029212922292329242925292629272928292929302931293229332934293529362937293829392940294129422943294429452946294729482949295029512952295329542955295629572958295929602961296229632964296529662967296829692970297129722973297429752976297729782979298029812982298329842985298629872988298929902991299229932994299529962997299829993000300130023003300430053006300730083009301030113012301330143015301630173018301930203021302230233024302530263027302830293030303130323033303430353036303730383039304030413042304330443045304630473048304930503051305230533054305530563057305830593060306130623063306430653066306730683069307030713072307330743075307630773078307930803081308230833084308530863087308830893090309130923093309430953096309730983099310031013102310331043105310631073108310931103111311231133114311531163117311831193120312131223123312431253126312731283129313031313132313331343135313631373138313931403141314231433144314531463147314831493150315131523153315431553156315731583159316031613162316331643165316631673168316931703171317231733174317531763177317831793180318131823183318431853186318731883189319031913192319331943195319631973198319932003201320232033204320532063207320832093210321132123213321432153216321732183219322032213222322332243225322632273228322932303231323232333234323532363237323832393240324132423243324432453246324732483249325032513252325332543255325632573258325932603261326232633264326532663267326832693270327132723273327432753276327732783279328032813282328332843285328632873288328932903291329232933294329532963297329832993300330133023303330433053306330733083309331033113312331333143315331633173318331933203321332233233324332533263327332833293330333133323333333433353336333733383339334033413342334333443345334633473348334933503351335233533354335533563357335833593360336133623363336433653366336733683369337033713372337333743375337633773378337933803381338233833384338533863387338833893390339133923393339433953396339733983399340034013402340334043405340634073408340934103411341234133414341534163417341834193420342134223423342434253426342734283429343034313432343334343435343634373438343934403441344234433444344534463447344834493450345134523453345434553456345734583459346034613462346334643465346634673468346934703471347234733474347534763477347834793480348134823483348434853486348734883489349034913492349334943495349634973498349935003501350235033504350535063507350835093510351135123513351435153516351735183519352035213522352335243525352635273528352935303531353235333534353535363537353835393540354135423543354435453546354735483549355035513552355335543555355635573558355935603561356235633564356535663567356835693570357135723573357435753576357735783579358035813582358335843585358635873588358935903591359235933594359535963597359835993600360136023603360436053606360736083609361036113612361336143615361636173618361936203621362236233624362536263627362836293630363136323633363436353636363736383639364036413642364336443645364636473648364936503651365236533654365536563657365836593660366136623663366436653666366736683669367036713672367336743675367636773678367936803681368236833684368536863687368836893690369136923693369436953696369736983699370037013702370337043705370637073708370937103711371237133714371537163717371837193720372137223723372437253726372737283729373037313732373337343735373637373738373937403741374237433744374537463747374837493750375137523753375437553756375737583759376037613762376337643765376637673768376937703771377237733774377537763777377837793780378137823783378437853786378737883789379037913792379337943795379637973798379938003801380238033804380538063807380838093810381138123813381438153816381738183819382038213822382338243825382638273828382938303831383238333834383538363837383838393840384138423843384438453846384738483849385038513852385338543855385638573858385938603861386238633864386538663867386838693870387138723873387438753876387738783879388038813882388338843885388638873888388938903891389238933894389538963897389838993900390139023903390439053906390739083909391039113912391339143915391639173918391939203921392239233924392539263927392839293930393139323933393439353936393739383939394039413942394339443945394639473948394939503951395239533954395539563957395839593960396139623963396439653966396739683969397039713972397339743975397639773978397939803981398239833984398539863987398839893990399139923993399439953996399739983999400040014002400340044005400640074008400940104011401240134014401540164017401840194020402140224023402440254026402740284029403040314032403340344035403640374038403940404041404240434044404540464047404840494050405140524053405440554056405740584059406040614062406340644065406640674068406940704071407240734074407540764077407840794080408140824083408440854086408740884089409040914092409340944095409640974098409941004101410241034104410541064107410841094110411141124113411441154116411741184119412041214122412341244125412641274128412941304131413241334134413541364137413841394140414141424143414441454146414741484149415041514152415341544155415641574158415941604161416241634164416541664167416841694170417141724173417441754176417741784179418041814182418341844185418641874188418941904191419241934194419541964197419841994200420142024203420442054206420742084209421042114212421342144215421642174218421942204221422242234224422542264227422842294230423142324233423442354236423742384239424042414242424342444245424642474248424942504251425242534254425542564257425842594260426142624263426442654266426742684269427042714272427342744275427642774278427942804281428242834284428542864287428842894290429142924293429442954296429742984299430043014302430343044305430643074308430943104311431243134314431543164317431843194320432143224323432443254326432743284329433043314332433343344335433643374338433943404341434243434344434543464347434843494350435143524353435443554356435743584359436043614362436343644365436643674368436943704371437243734374437543764377437843794380438143824383438443854386438743884389439043914392439343944395439643974398439944004401440244034404440544064407440844094410441144124413441444154416441744184419442044214422442344244425442644274428442944304431443244334434443544364437443844394440444144424443444444454446444744484449445044514452445344544455445644574458445944604461446244634464446544664467446844694470447144724473447444754476447744784479448044814482448344844485448644874488448944904491449244934494449544964497449844994500450145024503450445054506450745084509451045114512451345144515451645174518451945204521452245234524452545264527452845294530453145324533453445354536453745384539454045414542454345444545454645474548454945504551455245534554455545564557455845594560456145624563456445654566456745684569457045714572457345744575457645774578457945804581458245834584458545864587458845894590459145924593459445954596459745984599460046014602460346044605460646074608460946104611461246134614461546164617461846194620462146224623462446254626462746284629463046314632463346344635463646374638463946404641464246434644464546464647464846494650465146524653465446554656465746584659466046614662466346644665466646674668466946704671467246734674467546764677467846794680468146824683468446854686468746884689469046914692469346944695469646974698469947004701470247034704470547064707470847094710471147124713471447154716471747184719472047214722472347244725472647274728472947304731473247334734473547364737473847394740474147424743474447454746474747484749475047514752475347544755475647574758475947604761476247634764476547664767476847694770477147724773477447754776477747784779478047814782478347844785478647874788478947904791479247934794479547964797479847994800480148024803480448054806480748084809481048114812481348144815481648174818481948204821482248234824482548264827482848294830483148324833483448354836483748384839484048414842484348444845484648474848484948504851485248534854485548564857485848594860486148624863486448654866486748684869487048714872487348744875487648774878487948804881488248834884488548864887488848894890489148924893489448954896489748984899490049014902490349044905490649074908490949104911491249134914491549164917491849194920492149224923492449254926492749284929493049314932493349344935493649374938493949404941494249434944494549464947494849494950495149524953495449554956495749584959496049614962496349644965496649674968496949704971497249734974497549764977497849794980498149824983498449854986498749884989499049914992499349944995499649974998499950005001500250035004500550065007500850095010501150125013501450155016501750185019502050215022502350245025502650275028502950305031503250335034503550365037503850395040504150425043504450455046504750485049505050515052505350545055505650575058505950605061506250635064506550665067506850695070507150725073507450755076507750785079508050815082508350845085508650875088508950905091509250935094509550965097509850995100510151025103510451055106510751085109511051115112511351145115511651175118511951205121512251235124512551265127512851295130513151325133513451355136513751385139514051415142514351445145514651475148514951505151515251535154515551565157515851595160516151625163516451655166516751685169517051715172517351745175517651775178517951805181518251835184518551865187518851895190519151925193519451955196519751985199520052015202520352045205520652075208520952105211521252135214521552165217521852195220522152225223522452255226522752285229523052315232523352345235523652375238523952405241524252435244524552465247524852495250525152525253525452555256525752585259526052615262526352645265526652675268526952705271527252735274527552765277527852795280528152825283528452855286528752885289529052915292529352945295529652975298529953005301530253035304530553065307530853095310531153125313531453155316531753185319532053215322532353245325532653275328532953305331533253335334533553365337533853395340534153425343534453455346534753485349535053515352535353545355535653575358535953605361536253635364536553665367536853695370537153725373537453755376537753785379538053815382538353845385538653875388538953905391539253935394539553965397539853995400540154025403540454055406540754085409541054115412541354145415541654175418541954205421542254235424542554265427542854295430543154325433543454355436543754385439544054415442544354445445544654475448544954505451545254535454545554565457545854595460546154625463546454655466546754685469547054715472547354745475547654775478547954805481548254835484548554865487548854895490549154925493549454955496549754985499550055015502550355045505550655075508550955105511551255135514551555165517551855195520552155225523552455255526552755285529553055315532553355345535553655375538553955405541554255435544554555465547554855495550555155525553555455555556555755585559556055615562556355645565556655675568556955705571557255735574557555765577557855795580558155825583558455855586558755885589559055915592559355945595559655975598559956005601560256035604560556065607560856095610561156125613561456155616561756185619562056215622562356245625562656275628562956305631563256335634563556365637563856395640564156425643564456455646564756485649565056515652565356545655565656575658565956605661566256635664566556665667566856695670567156725673567456755676567756785679568056815682568356845685568656875688568956905691569256935694569556965697569856995700570157025703570457055706570757085709571057115712571357145715571657175718571957205721572257235724572557265727572857295730573157325733573457355736573757385739574057415742574357445745574657475748574957505751575257535754575557565757575857595760576157625763576457655766576757685769577057715772577357745775577657775778577957805781578257835784578557865787578857895790579157925793579457955796579757985799580058015802580358045805580658075808580958105811581258135814581558165817581858195820582158225823582458255826582758285829583058315832583358345835583658375838583958405841584258435844584558465847584858495850585158525853585458555856585758585859586058615862586358645865586658675868586958705871587258735874587558765877587858795880588158825883588458855886588758885889589058915892589358945895589658975898589959005901590259035904590559065907590859095910591159125913591459155916591759185919592059215922592359245925592659275928592959305931593259335934593559365937593859395940594159425943594459455946594759485949595059515952595359545955595659575958595959605961596259635964596559665967596859695970597159725973597459755976597759785979598059815982598359845985598659875988598959905991599259935994599559965997599859996000600160026003600460056006600760086009601060116012601360146015601660176018601960206021602260236024602560266027602860296030603160326033603460356036603760386039604060416042604360446045604660476048604960506051605260536054605560566057605860596060606160626063606460656066606760686069607060716072607360746075607660776078607960806081608260836084608560866087608860896090609160926093609460956096609760986099610061016102610361046105610661076108610961106111611261136114611561166117611861196120612161226123612461256126612761286129613061316132613361346135613661376138613961406141614261436144614561466147614861496150615161526153615461556156615761586159616061616162616361646165616661676168616961706171617261736174617561766177617861796180618161826183618461856186618761886189619061916192619361946195619661976198619962006201620262036204620562066207620862096210621162126213621462156216621762186219622062216222622362246225622662276228622962306231623262336234623562366237623862396240624162426243624462456246624762486249625062516252625362546255625662576258625962606261626262636264626562666267626862696270627162726273627462756276627762786279628062816282628362846285628662876288628962906291629262936294629562966297629862996300630163026303630463056306630763086309631063116312631363146315631663176318631963206321632263236324632563266327632863296330633163326333633463356336633763386339634063416342634363446345634663476348634963506351635263536354635563566357635863596360636163626363636463656366636763686369637063716372637363746375637663776378637963806381638263836384638563866387638863896390639163926393639463956396639763986399640064016402640364046405640664076408640964106411641264136414641564166417641864196420642164226423642464256426642764286429643064316432643364346435643664376438643964406441644264436444644564466447644864496450645164526453645464556456645764586459646064616462646364646465646664676468646964706471647264736474647564766477647864796480648164826483648464856486648764886489649064916492649364946495649664976498649965006501650265036504650565066507650865096510651165126513651465156516651765186519652065216522652365246525652665276528652965306531653265336534653565366537653865396540654165426543654465456546654765486549655065516552655365546555655665576558655965606561656265636564656565666567656865696570657165726573657465756576657765786579658065816582658365846585658665876588658965906591659265936594659565966597659865996600660166026603660466056606660766086609661066116612661366146615661666176618661966206621662266236624662566266627662866296630663166326633663466356636663766386639664066416642664366446645664666476648664966506651665266536654665566566657665866596660666166626663666466656666666766686669667066716672667366746675667666776678667966806681668266836684668566866687668866896690669166926693669466956696669766986699670067016702670367046705670667076708670967106711671267136714671567166717671867196720672167226723672467256726672767286729673067316732673367346735673667376738673967406741674267436744674567466747674867496750675167526753675467556756675767586759676067616762676367646765676667676768676967706771677267736774677567766777677867796780678167826783678467856786678767886789679067916792679367946795679667976798679968006801680268036804680568066807680868096810681168126813681468156816681768186819682068216822682368246825682668276828682968306831683268336834683568366837683868396840684168426843684468456846684768486849685068516852685368546855685668576858685968606861686268636864686568666867686868696870687168726873687468756876687768786879688068816882688368846885688668876888688968906891689268936894689568966897689868996900690169026903690469056906690769086909691069116912691369146915691669176918691969206921692269236924692569266927692869296930693169326933693469356936693769386939694069416942694369446945694669476948694969506951695269536954695569566957695869596960696169626963696469656966696769686969697069716972697369746975697669776978697969806981698269836984698569866987698869896990699169926993699469956996699769986999700070017002700370047005700670077008700970107011701270137014701570167017701870197020702170227023702470257026702770287029703070317032703370347035703670377038703970407041704270437044704570467047704870497050705170527053705470557056705770587059706070617062706370647065706670677068706970707071707270737074707570767077707870797080708170827083708470857086708770887089709070917092709370947095709670977098709971007101710271037104710571067107710871097110711171127113711471157116711771187119712071217122712371247125712671277128712971307131713271337134713571367137713871397140714171427143714471457146714771487149715071517152715371547155715671577158715971607161716271637164716571667167716871697170717171727173717471757176717771787179718071817182718371847185718671877188718971907191719271937194719571967197719871997200720172027203720472057206720772087209721072117212721372147215721672177218721972207221722272237224722572267227722872297230723172327233723472357236723772387239724072417242724372447245724672477248724972507251725272537254725572567257725872597260726172627263726472657266726772687269727072717272727372747275727672777278727972807281728272837284728572867287728872897290729172927293729472957296729772987299730073017302730373047305730673077308730973107311731273137314731573167317731873197320732173227323732473257326732773287329733073317332733373347335733673377338733973407341734273437344734573467347734873497350735173527353735473557356735773587359736073617362736373647365736673677368736973707371737273737374737573767377737873797380738173827383738473857386738773887389739073917392739373947395739673977398739974007401740274037404740574067407740874097410741174127413741474157416741774187419742074217422742374247425742674277428742974307431743274337434743574367437743874397440744174427443744474457446744774487449745074517452745374547455745674577458745974607461746274637464746574667467746874697470747174727473747474757476747774787479748074817482748374847485748674877488748974907491749274937494749574967497749874997500750175027503750475057506750775087509751075117512751375147515751675177518751975207521752275237524752575267527752875297530753175327533753475357536753775387539754075417542754375447545754675477548754975507551755275537554755575567557755875597560756175627563756475657566756775687569757075717572757375747575757675777578757975807581758275837584758575867587758875897590759175927593759475957596759775987599760076017602760376047605760676077608760976107611761276137614761576167617761876197620762176227623762476257626762776287629763076317632763376347635763676377638763976407641764276437644764576467647764876497650765176527653765476557656765776587659766076617662766376647665766676677668766976707671767276737674767576767677767876797680768176827683768476857686768776887689769076917692769376947695769676977698769977007701770277037704770577067707770877097710771177127713771477157716771777187719772077217722772377247725772677277728772977307731773277337734773577367737773877397740774177427743774477457746774777487749775077517752775377547755775677577758775977607761776277637764776577667767776877697770777177727773777477757776777777787779778077817782778377847785778677877788778977907791779277937794779577967797779877997800780178027803780478057806780778087809781078117812781378147815781678177818781978207821782278237824782578267827782878297830783178327833783478357836783778387839784078417842784378447845784678477848784978507851785278537854785578567857785878597860786178627863786478657866786778687869787078717872787378747875787678777878787978807881788278837884788578867887788878897890789178927893789478957896789778987899790079017902790379047905790679077908790979107911791279137914791579167917791879197920792179227923792479257926792779287929793079317932793379347935793679377938793979407941794279437944794579467947794879497950795179527953795479557956795779587959796079617962796379647965796679677968796979707971797279737974797579767977797879797980798179827983798479857986798779887989799079917992799379947995799679977998799980008001800280038004800580068007800880098010801180128013801480158016801780188019802080218022802380248025802680278028802980308031803280338034803580368037803880398040804180428043804480458046804780488049805080518052805380548055805680578058805980608061806280638064806580668067806880698070807180728073807480758076807780788079808080818082808380848085808680878088808980908091809280938094809580968097809880998100810181028103810481058106810781088109811081118112811381148115811681178118811981208121812281238124812581268127812881298130813181328133813481358136813781388139814081418142814381448145814681478148814981508151815281538154815581568157815881598160816181628163816481658166816781688169817081718172817381748175817681778178817981808181818281838184818581868187818881898190819181928193819481958196819781988199820082018202820382048205820682078208820982108211821282138214821582168217821882198220822182228223822482258226822782288229823082318232823382348235823682378238823982408241824282438244824582468247824882498250825182528253825482558256825782588259826082618262826382648265826682678268826982708271827282738274827582768277827882798280828182828283828482858286828782888289829082918292829382948295829682978298829983008301830283038304830583068307830883098310831183128313831483158316831783188319832083218322832383248325832683278328832983308331833283338334833583368337833883398340834183428343834483458346834783488349835083518352835383548355835683578358835983608361836283638364836583668367836883698370837183728373837483758376837783788379838083818382838383848385838683878388838983908391839283938394839583968397839883998400840184028403840484058406840784088409841084118412841384148415841684178418841984208421842284238424842584268427842884298430843184328433843484358436843784388439844084418442844384448445844684478448844984508451845284538454845584568457845884598460846184628463846484658466846784688469847084718472847384748475847684778478847984808481848284838484848584868487848884898490849184928493849484958496849784988499850085018502850385048505850685078508850985108511851285138514851585168517851885198520852185228523852485258526852785288529853085318532853385348535853685378538853985408541854285438544854585468547854885498550855185528553855485558556855785588559856085618562856385648565856685678568856985708571857285738574857585768577857885798580858185828583858485858586858785888589859085918592859385948595859685978598859986008601860286038604860586068607860886098610861186128613861486158616861786188619862086218622862386248625862686278628862986308631863286338634863586368637863886398640864186428643864486458646864786488649865086518652865386548655865686578658865986608661866286638664866586668667866886698670867186728673867486758676867786788679868086818682868386848685868686878688868986908691869286938694869586968697869886998700870187028703870487058706870787088709871087118712871387148715871687178718871987208721872287238724872587268727872887298730873187328733873487358736873787388739874087418742874387448745874687478748874987508751875287538754875587568757875887598760876187628763876487658766876787688769877087718772877387748775877687778778877987808781878287838784878587868787878887898790879187928793879487958796879787988799880088018802880388048805880688078808880988108811881288138814881588168817881888198820882188228823882488258826882788288829883088318832883388348835883688378838883988408841884288438844884588468847884888498850885188528853885488558856885788588859886088618862886388648865886688678868886988708871887288738874887588768877887888798880888188828883888488858886888788888889889088918892889388948895889688978898889989008901890289038904890589068907890889098910891189128913891489158916891789188919892089218922892389248925892689278928892989308931893289338934893589368937893889398940894189428943894489458946894789488949895089518952895389548955895689578958895989608961896289638964896589668967896889698970897189728973897489758976897789788979898089818982898389848985898689878988898989908991899289938994899589968997899889999000900190029003900490059006900790089009901090119012901390149015901690179018901990209021902290239024902590269027902890299030903190329033903490359036903790389039904090419042904390449045904690479048904990509051905290539054905590569057905890599060906190629063906490659066906790689069907090719072907390749075907690779078907990809081908290839084908590869087908890899090909190929093909490959096909790989099910091019102910391049105910691079108910991109111911291139114911591169117911891199120912191229123912491259126912791289129913091319132913391349135913691379138913991409141914291439144914591469147914891499150915191529153915491559156915791589159916091619162916391649165916691679168916991709171917291739174917591769177917891799180
  1. (function (global, factory) {
  2. /*jshint -W030 */
  3. 'use strict';
  4. typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) :
  5. typeof define === 'function' && define.amd ? define(['exports'], factory) :
  6. global.async ? factory(global.neo_async = global.neo_async || {}) :
  7. factory(global.async = global.async || {});
  8. }(this, function(exports) {
  9. 'use strict';
  10. var noop = function noop() {};
  11. var throwError = function throwError() {
  12. throw new Error('Callback was already called.');
  13. };
  14. var DEFAULT_TIMES = 5;
  15. var DEFAULT_INTERVAL = 0;
  16. var obj = 'object';
  17. var func = 'function';
  18. var isArray = Array.isArray;
  19. var nativeKeys = Object.keys;
  20. var nativePush = Array.prototype.push;
  21. var iteratorSymbol = typeof Symbol === func && Symbol.iterator;
  22. var nextTick, asyncNextTick, asyncSetImmediate;
  23. createImmediate();
  24. /**
  25. * @memberof async
  26. * @namespace each
  27. * @param {Array|Object} collection
  28. * @param {Function} iterator
  29. * @param {Function} callback
  30. * @example
  31. *
  32. * // array
  33. * var order = [];
  34. * var array = [1, 3, 2];
  35. * var iterator = function(num, done) {
  36. * setTimeout(function() {
  37. * order.push(num);
  38. * done();
  39. * }, num * 10);
  40. * };
  41. * async.each(array, iterator, function(err, res) {
  42. * console.log(res); // undefined
  43. * console.log(order); // [1, 2, 3]
  44. * });
  45. *
  46. * @example
  47. *
  48. * // array with index
  49. * var order = [];
  50. * var array = [1, 3, 2];
  51. * var iterator = function(num, index, done) {
  52. * setTimeout(function() {
  53. * order.push([num, index]);
  54. * done();
  55. * }, num * 10);
  56. * };
  57. * async.each(array, iterator, function(err, res) {
  58. * console.log(res); // undefined
  59. * console.log(order); // [[1, 0], [2, 2], [3, 1]]
  60. * });
  61. *
  62. * @example
  63. *
  64. * // object
  65. * var order = [];
  66. * var object = { a: 1, b: 3, c: 2 };
  67. * var iterator = function(num, done) {
  68. * setTimeout(function() {
  69. * order.push(num);
  70. * done();
  71. * }, num * 10);
  72. * };
  73. * async.each(object, iterator, function(err, res) {
  74. * console.log(res); // undefined
  75. * console.log(order); // [1, 2, 3]
  76. * });
  77. *
  78. * @example
  79. *
  80. * // object with key
  81. * var order = [];
  82. * var object = { a: 1, b: 3, c: 2 };
  83. * var iterator = function(num, key, done) {
  84. * setTimeout(function() {
  85. * order.push([num, key]);
  86. * done();
  87. * }, num * 10);
  88. * };
  89. * async.each(object, iterator, function(err, res) {
  90. * console.log(res); // undefined
  91. * console.log(order); // [[1, 'a'], [2, 'c'], [3, 'b']]
  92. * });
  93. *
  94. * @example
  95. *
  96. * // break
  97. * var order = [];
  98. * var array = [1, 3, 2];
  99. * var iterator = function(num, done) {
  100. * setTimeout(function() {
  101. * order.push(num);
  102. * done(null, num !== 2);
  103. * }, num * 10);
  104. * };
  105. * async.each(array, iterator, function(err, res) {
  106. * console.log(res); // undefined
  107. * console.log(order); // [1, 2]
  108. * });
  109. *
  110. */
  111. var each = createEach(arrayEach, baseEach, symbolEach);
  112. /**
  113. * @memberof async
  114. * @namespace map
  115. * @param {Array|Object} collection
  116. * @param {Function} iterator
  117. * @param {Function} callback
  118. * @example
  119. *
  120. * // array
  121. * var order = [];
  122. * var array = [1, 3, 2];
  123. * var iterator = function(num, done) {
  124. * setTimeout(function() {
  125. * order.push(num);
  126. * done(null, num);
  127. * }, num * 10);
  128. * };
  129. * async.map(array, iterator, function(err, res) {
  130. * console.log(res); // [1, 3, 2];
  131. * console.log(order); // [1, 2, 3]
  132. * });
  133. *
  134. * @example
  135. *
  136. * // array with index
  137. * var order = [];
  138. * var array = [1, 3, 2];
  139. * var iterator = function(num, index, done) {
  140. * setTimeout(function() {
  141. * order.push([num, index]);
  142. * done(null, num);
  143. * }, num * 10);
  144. * };
  145. * async.map(array, iterator, function(err, res) {
  146. * console.log(res); // [1, 3, 2]
  147. * console.log(order); // [[1, 0], [2, 2], [3, 1]]
  148. * });
  149. *
  150. * @example
  151. *
  152. * // object
  153. * var order = [];
  154. * var object = { a: 1, b: 3, c: 2 };
  155. * var iterator = function(num, done) {
  156. * setTimeout(function() {
  157. * order.push(num);
  158. * done(null, num);
  159. * }, num * 10);
  160. * };
  161. * async.map(object, iterator, function(err, res) {
  162. * console.log(res); // [1, 3, 2]
  163. * console.log(order); // [1, 2, 3]
  164. * });
  165. *
  166. * @example
  167. *
  168. * // object with key
  169. * var order = [];
  170. * var object = { a: 1, b: 3, c: 2 };
  171. * var iterator = function(num, key, done) {
  172. * setTimeout(function() {
  173. * order.push([num, key]);
  174. * done(null, num);
  175. * }, num * 10);
  176. * };
  177. * async.map(object, iterator, function(err, res) {
  178. * console.log(res); // [1, 3, 2]
  179. * console.log(order); // [[1, 'a'], [2, 'c'], [3, 'b']]
  180. * });
  181. *
  182. */
  183. var map = createMap(arrayEachIndex, baseEachIndex, symbolEachIndex, true);
  184. /**
  185. * @memberof async
  186. * @namespace mapValues
  187. * @param {Array|Object} collection
  188. * @param {Function} iterator
  189. * @param {Function} callback
  190. * @example
  191. *
  192. * // array
  193. * var order = [];
  194. * var array = [1, 3, 2];
  195. * var iterator = function(num, done) {
  196. * setTimeout(function() {
  197. * order.push(num);
  198. * done(null, num);
  199. * }, num * 10);
  200. * };
  201. * async.mapValues(array, iterator, function(err, res) {
  202. * console.log(res); // { '0': 1, '1': 3, '2': 2 }
  203. * console.log(order); // [1, 2, 3]
  204. * });
  205. *
  206. * @example
  207. *
  208. * // array with index
  209. * var order = [];
  210. * var array = [1, 3, 2];
  211. * var iterator = function(num, index, done) {
  212. * setTimeout(function() {
  213. * order.push([num, index]);
  214. * done(null, num);
  215. * }, num * 10);
  216. * };
  217. * async.mapValues(array, iterator, function(err, res) {
  218. * console.log(res); // { '0': 1, '1': 3, '2': 2 }
  219. * console.log(order); // [[1, 0], [2, 2], [3, 1]]
  220. * });
  221. *
  222. * @example
  223. *
  224. * // object
  225. * var order = [];
  226. * var object = { a: 1, b: 3, c: 2 };
  227. * var iterator = function(num, done) {
  228. * setTimeout(function() {
  229. * order.push(num);
  230. * done(null, num);
  231. * }, num * 10);
  232. * };
  233. * async.mapValues(object, iterator, function(err, res) {
  234. * console.log(res); // { a: 1, b: 3, c: 2 }
  235. * console.log(order); // [1, 2, 3]
  236. * });
  237. *
  238. * @example
  239. *
  240. * // object with key
  241. * var order = [];
  242. * var object = { a: 1, b: 3, c: 2 };
  243. * var iterator = function(num, key, done) {
  244. * setTimeout(function() {
  245. * order.push([num, key]);
  246. * done(null, num);
  247. * }, num * 10);
  248. * };
  249. * async.mapValues(object, iterator, function(err, res) {
  250. * console.log(res); // { a: 1, b: 3, c: 2 }
  251. * console.log(order); // [[1, 'a'], [2, 'c'], [3, 'b']]
  252. * });
  253. *
  254. */
  255. var mapValues = createMap(arrayEachIndex, baseEachKey, symbolEachKey, false);
  256. /**
  257. * @memberof async
  258. * @namespace filter
  259. * @param {Array|Object} collection
  260. * @param {Function} iterator
  261. * @param {Function} callback
  262. * @example
  263. *
  264. * // array
  265. * var order = [];
  266. * var array = [1, 3, 2];
  267. * var iterator = function(num, done) {
  268. * setTimeout(function() {
  269. * order.push(num);
  270. * done(null, num % 2);
  271. * }, num * 10);
  272. * };
  273. * async.filter(array, iterator, function(err, res) {
  274. * console.log(res); // [1, 3];
  275. * console.log(order); // [1, 2, 3]
  276. * });
  277. *
  278. * @example
  279. *
  280. * // array with index
  281. * var order = [];
  282. * var array = [1, 3, 2];
  283. * var iterator = function(num, index, done) {
  284. * setTimeout(function() {
  285. * order.push([num, index]);
  286. * done(null, num % 2);
  287. * }, num * 10);
  288. * };
  289. * async.filter(array, iterator, function(err, res) {
  290. * console.log(res); // [1, 3];
  291. * console.log(order); // [[1, 0], [2, 2], [3, 1]]
  292. * });
  293. *
  294. * @example
  295. *
  296. * // object
  297. * var order = [];
  298. * var object = { a: 1, b: 3, c: 2 };
  299. * var iterator = function(num, done) {
  300. * setTimeout(function() {
  301. * order.push(num);
  302. * done(null, num % 2);
  303. * }, num * 10);
  304. * };
  305. * async.filter(object, iterator, function(err, res) {
  306. * console.log(res); // [1, 3];
  307. * console.log(order); // [1, 2, 3]
  308. * });
  309. *
  310. * @example
  311. *
  312. * // object with key
  313. * var order = [];
  314. * var object = { a: 1, b: 3, c: 2 };
  315. * var iterator = function(num, key, done) {
  316. * setTimeout(function() {
  317. * order.push([num, key]);
  318. * done(null, num % 2);
  319. * }, num * 10);
  320. * };
  321. * async.filter(object, iterator, function(err, res) {
  322. * console.log(res); // [1, 3];
  323. * console.log(order); // [[1, 'a'], [2, 'c'], [3, 'b']]
  324. * });
  325. *
  326. */
  327. var filter = createFilter(arrayEachIndexValue, baseEachIndexValue, symbolEachIndexValue, true);
  328. /**
  329. * @memberof async
  330. * @namespace filterSeries
  331. * @param {Array|Object} collection
  332. * @param {Function} iterator
  333. * @param {Function} callback
  334. * @example
  335. *
  336. * // array
  337. * var order = [];
  338. * var array = [1, 3, 2];
  339. * var iterator = function(num, done) {
  340. * setTimeout(function() {
  341. * order.push(num);
  342. * done(null, num % 2);
  343. * }, num * 10);
  344. * };
  345. * async.filterSeries(array, iterator, function(err, res) {
  346. * console.log(res); // [1, 3];
  347. * console.log(order); // [1, 3, 2]
  348. * });
  349. *
  350. * @example
  351. *
  352. * // array with index
  353. * var order = [];
  354. * var array = [1, 3, 2];
  355. * var iterator = function(num, index, done) {
  356. * setTimeout(function() {
  357. * order.push([num, index]);
  358. * done(null, num % 2);
  359. * }, num * 10);
  360. * };
  361. * async.filterSeries(array, iterator, function(err, res) {
  362. * console.log(res); // [1, 3]
  363. * console.log(order); // [[1, 0], [3, 1], [2, 2]]
  364. * });
  365. *
  366. * @example
  367. *
  368. * // object
  369. * var order = [];
  370. * var object = { a: 1, b: 3, c: 2 };
  371. * var iterator = function(num, done) {
  372. * setTimeout(function() {
  373. * order.push(num);
  374. * done(null, num % 2);
  375. * }, num * 10);
  376. * };
  377. * async.filterSeries(object, iterator, function(err, res) {
  378. * console.log(res); // [1, 3]
  379. * console.log(order); // [1, 3, 2]
  380. * });
  381. *
  382. * @example
  383. *
  384. * // object with key
  385. * var order = [];
  386. * var object = { a: 1, b: 3, c: 2 };
  387. * var iterator = function(num, key, done) {
  388. * setTimeout(function() {
  389. * order.push([num, key]);
  390. * done(null, num % 2);
  391. * }, num * 10);
  392. * };
  393. * async.filterSeries(object, iterator, function(err, res) {
  394. * console.log(res); // [1, 3]
  395. * console.log(order); // [[1, 'a'], [3, 'b'], [2, 'c']]
  396. * });
  397. *
  398. */
  399. var filterSeries = createFilterSeries(true);
  400. /**
  401. * @memberof async
  402. * @namespace filterLimit
  403. * @param {Array|Object} collection
  404. * @param {number} limit - limit >= 1
  405. * @param {Function} iterator
  406. * @param {Function} callback
  407. * @example
  408. *
  409. * // array
  410. * var order = [];
  411. * var array = [1, 5, 3, 4, 2];
  412. * var iterator = function(num, done) {
  413. * setTimeout(function() {
  414. * order.push(num);
  415. * done(null, num % 2);
  416. * }, num * 10);
  417. * };
  418. * async.filterLimit(array, 2, iterator, function(err, res) {
  419. * console.log(res); // [1, 5, 3]
  420. * console.log(order); // [1, 3, 5, 2, 4]
  421. * });
  422. *
  423. * @example
  424. *
  425. * // array with index
  426. * var order = [];
  427. * var array = [1, 5, 3, 4, 2];
  428. * var iterator = function(num, index, done) {
  429. * setTimeout(function() {
  430. * order.push([num, index]);
  431. * done(null, num % 2);
  432. * }, num * 10);
  433. * };
  434. * async.filterLimit(array, 2, iterator, function(err, res) {
  435. * console.log(res); // [1, 5, 3]
  436. * console.log(order); // [[1, 0], [3, 2], [5, 1], [2, 4], [4, 3]]
  437. * });
  438. *
  439. * @example
  440. *
  441. * // object
  442. * var order = [];
  443. * var object = { a: 1, b: 5, c: 3, d: 4, e: 2 };
  444. * var iterator = function(num, done) {
  445. * setTimeout(function() {
  446. * order.push(num);
  447. * done(null, num % 2);
  448. * }, num * 10);
  449. * };
  450. * async.filterLimit(object, 2, iterator, function(err, res) {
  451. * console.log(res); // [1, 5, 3]
  452. * console.log(order); // [1, 3, 5, 2, 4]
  453. * });
  454. *
  455. * @example
  456. *
  457. * // object with key
  458. * var order = [];
  459. * var object = { a: 1, b: 5, c: 3, d: 4, e: 2 };
  460. * var iterator = function(num, key, done) {
  461. * setTimeout(function() {
  462. * order.push([num, key]);
  463. * done(null, num % 2);
  464. * }, num * 10);
  465. * };
  466. * async.filterLimit(object, 2, iterator, function(err, res) {
  467. * console.log(res); // [1, 5, 3]
  468. * console.log(order); // [[1, 'a'], [3, 'c'], [5, 'b'], [2, 'e'], [4, 'd']]
  469. * });
  470. *
  471. */
  472. var filterLimit = createFilterLimit(true);
  473. /**
  474. * @memberof async
  475. * @namespace reject
  476. * @param {Array|Object} collection
  477. * @param {Function} iterator
  478. * @param {Function} callback
  479. * @example
  480. *
  481. * // array
  482. * var order = [];
  483. * var array = [1, 3, 2];
  484. * var iterator = function(num, done) {
  485. * setTimeout(function() {
  486. * order.push(num);
  487. * done(null, num % 2);
  488. * }, num * 10);
  489. * };
  490. * async.reject(array, iterator, function(err, res) {
  491. * console.log(res); // [2];
  492. * console.log(order); // [1, 2, 3]
  493. * });
  494. *
  495. * @example
  496. *
  497. * // array with index
  498. * var order = [];
  499. * var array = [1, 3, 2];
  500. * var iterator = function(num, index, done) {
  501. * setTimeout(function() {
  502. * order.push([num, index]);
  503. * done(null, num % 2);
  504. * }, num * 10);
  505. * };
  506. * async.reject(array, iterator, function(err, res) {
  507. * console.log(res); // [2];
  508. * console.log(order); // [[1, 0], [2, 2], [3, 1]]
  509. * });
  510. *
  511. * @example
  512. *
  513. * // object
  514. * var order = [];
  515. * var object = { a: 1, b: 3, c: 2 };
  516. * var iterator = function(num, done) {
  517. * setTimeout(function() {
  518. * order.push(num);
  519. * done(null, num % 2);
  520. * }, num * 10);
  521. * };
  522. * async.reject(object, iterator, function(err, res) {
  523. * console.log(res); // [2];
  524. * console.log(order); // [1, 2, 3]
  525. * });
  526. *
  527. * @example
  528. *
  529. * // object with key
  530. * var order = [];
  531. * var object = { a: 1, b: 3, c: 2 };
  532. * var iterator = function(num, key, done) {
  533. * setTimeout(function() {
  534. * order.push([num, key]);
  535. * done(null, num % 2);
  536. * }, num * 10);
  537. * };
  538. * async.reject(object, iterator, function(err, res) {
  539. * console.log(res); // [2];
  540. * console.log(order); // [[1, 'a'], [2, 'c'], [3, 'b']]
  541. * });
  542. *
  543. */
  544. var reject = createFilter(arrayEachIndexValue, baseEachIndexValue, symbolEachIndexValue, false);
  545. /**
  546. * @memberof async
  547. * @namespace rejectSeries
  548. * @param {Array|Object} collection
  549. * @param {Function} iterator
  550. * @param {Function} callback
  551. * @example
  552. *
  553. * // array
  554. * var order = [];
  555. * var array = [1, 3, 2];
  556. * var iterator = function(num, done) {
  557. * setTimeout(function() {
  558. * order.push(num);
  559. * done(null, num % 2);
  560. * }, num * 10);
  561. * };
  562. * async.rejectSeries(array, iterator, function(err, res) {
  563. * console.log(res); // [2];
  564. * console.log(order); // [1, 3, 2]
  565. * });
  566. *
  567. * @example
  568. *
  569. * // object
  570. * var order = [];
  571. * var object = { a: 1, b: 3, c: 2 };
  572. * var iterator = function(num, done) {
  573. * setTimeout(function() {
  574. * order.push(num);
  575. * done(null, num % 2);
  576. * }, num * 10);
  577. * };
  578. * async.rejectSeries(object, iterator, function(err, res) {
  579. * console.log(res); // [2];
  580. * console.log(order); // [1, 3, 2]
  581. * });
  582. *
  583. * @example
  584. *
  585. * // object with key
  586. * var order = [];
  587. * var object = { a: 1, b: 3, c: 2 };
  588. * var iterator = function(num, key, done) {
  589. * setTimeout(function() {
  590. * order.push([num, key]);
  591. * done(null, num % 2);
  592. * }, num * 10);
  593. * };
  594. * async.rejectSeries(object, iterator, function(err, res) {
  595. * console.log(res); // [2];
  596. * console.log(order); // [[1, 'a'], [3, 'b'], [2, 'c']]
  597. * });
  598. *
  599. */
  600. var rejectSeries = createFilterSeries(false);
  601. /**
  602. * @memberof async
  603. * @namespace rejectLimit
  604. * @param {Array|Object} collection
  605. * @param {number} limit - limit >= 1
  606. * @param {Function} iterator
  607. * @param {Function} callback
  608. * @example
  609. *
  610. * // array
  611. * var order = [];
  612. * var array = [1, 5, 3, 4, 2];
  613. * var iterator = function(num, done) {
  614. * setTimeout(function() {
  615. * order.push(num);
  616. * done(null, num % 2);
  617. * }, num * 10);
  618. * };
  619. * async.rejectLimit(array, 2, iterator, function(err, res) {
  620. * console.log(res); // [4, 2]
  621. * console.log(order); // [1, 3, 5, 2, 4]
  622. * });
  623. *
  624. * @example
  625. *
  626. * // array with index
  627. * var order = [];
  628. * var array = [1, 5, 3, 4, 2];
  629. * var iterator = function(num, index, done) {
  630. * setTimeout(function() {
  631. * order.push([num, index]);
  632. * done(null, num % 2);
  633. * }, num * 10);
  634. * };
  635. * async.rejectLimit(array, 2, iterator, function(err, res) {
  636. * console.log(res); // [4, 2]
  637. * console.log(order); // [[1, 0], [3, 2], [5, 1], [2, 4], [4, 3]]
  638. * });
  639. *
  640. * @example
  641. *
  642. * // object
  643. * var order = [];
  644. * var object = { a: 1, b: 5, c: 3, d: 4, e: 2 };
  645. * var iterator = function(num, done) {
  646. * setTimeout(function() {
  647. * order.push(num);
  648. * done(null, num % 2);
  649. * }, num * 10);
  650. * };
  651. * async.rejectLimit(object, 2, iterator, function(err, res) {
  652. * console.log(res); // [4, 2]
  653. * console.log(order); // [1, 3, 5, 2, 4]
  654. * });
  655. *
  656. * @example
  657. *
  658. * // object with key
  659. * var order = [];
  660. * var object = { a: 1, b: 5, c: 3, d: 4, e: 2 };
  661. * var iterator = function(num, key, done) {
  662. * setTimeout(function() {
  663. * order.push([num, key]);
  664. * done(null, num % 2);
  665. * }, num * 10);
  666. * };
  667. * async.rejectLimit(object, 2, iterator, function(err, res) {
  668. * console.log(res); // [4, 2]
  669. * console.log(order); // [[1, 'a'], [3, 'c'], [5, 'b'], [2, 'e'], [4, 'd']]
  670. * });
  671. *
  672. */
  673. var rejectLimit = createFilterLimit(false);
  674. /**
  675. * @memberof async
  676. * @namespace detect
  677. * @param {Array|Object} collection
  678. * @param {Function} iterator
  679. * @param {Function} callback
  680. * @example
  681. *
  682. * // array
  683. * var order = [];
  684. * var array = [1, 3, 2];
  685. * var iterator = function(num, done) {
  686. * setTimeout(function() {
  687. * order.push(num);
  688. * done(null, num % 2);
  689. * }, num * 10);
  690. * };
  691. * async.detect(array, iterator, function(err, res) {
  692. * console.log(res); // 1
  693. * console.log(order); // [1]
  694. * });
  695. *
  696. * @example
  697. *
  698. * // array with index
  699. * var order = [];
  700. * var array = [1, 3, 2];
  701. * var iterator = function(num, index, done) {
  702. * setTimeout(function() {
  703. * order.push([num, index]);
  704. * done(null, num % 2);
  705. * }, num * 10);
  706. * };
  707. * async.detect(array, iterator, function(err, res) {
  708. * console.log(res); // 1
  709. * console.log(order); // [[1, 0]]
  710. * });
  711. *
  712. * @example
  713. *
  714. * // object
  715. * var order = [];
  716. * var object = { a: 1, b: 3, c: 2 };
  717. * var iterator = function(num, done) {
  718. * setTimeout(function() {
  719. * order.push(num);
  720. * done(null, num % 2);
  721. * }, num * 10);
  722. * };
  723. * async.detect(object, iterator, function(err, res) {
  724. * console.log(res); // 1
  725. * console.log(order); // [1]
  726. * });
  727. *
  728. * @example
  729. *
  730. * // object with key
  731. * var order = [];
  732. * var object = { a: 1, b: 3, c: 2 };
  733. * var iterator = function(num, key, done) {
  734. * setTimeout(function() {
  735. * order.push([num, key]);
  736. * done(null, num % 2);
  737. * }, num * 10);
  738. * };
  739. * async.detect(object, iterator, function(err, res) {
  740. * console.log(res); // 1
  741. * console.log(order); // [[1, 'a']]
  742. * });
  743. *
  744. */
  745. var detect = createDetect(arrayEachValue, baseEachValue, symbolEachValue, true);
  746. /**
  747. * @memberof async
  748. * @namespace detectSeries
  749. * @param {Array|Object} collection
  750. * @param {Function} iterator
  751. * @param {Function} callback
  752. * @example
  753. *
  754. * // array
  755. * var order = [];
  756. * var array = [1, 3, 2];
  757. * var iterator = function(num, done) {
  758. * setTimeout(function() {
  759. * order.push(num);
  760. * done(null, num % 2);
  761. * }, num * 10);
  762. * };
  763. * async.detectSeries(array, iterator, function(err, res) {
  764. * console.log(res); // 1
  765. * console.log(order); // [1]
  766. * });
  767. *
  768. * @example
  769. *
  770. * // array with index
  771. * var order = [];
  772. * var array = [1, 3, 2];
  773. * var iterator = function(num, index, done) {
  774. * setTimeout(function() {
  775. * order.push([num, index]);
  776. * done(null, num % 2);
  777. * }, num * 10);
  778. * };
  779. * async.detectSeries(array, iterator, function(err, res) {
  780. * console.log(res); // 1
  781. * console.log(order); // [[1, 0]]
  782. * });
  783. *
  784. * @example
  785. *
  786. * // object
  787. * var order = [];
  788. * var object = { a: 1, b: 3, c: 2 };
  789. * var iterator = function(num, done) {
  790. * setTimeout(function() {
  791. * order.push(num);
  792. * done(null, num % 2);
  793. * }, num * 10);
  794. * };
  795. * async.detectSeries(object, iterator, function(err, res) {
  796. * console.log(res); // 1
  797. * console.log(order); // [1]
  798. * });
  799. *
  800. * @example
  801. *
  802. * // object with key
  803. * var order = [];
  804. * var object = { a: 1, b: 3, c: 2 };
  805. * var iterator = function(num, key, done) {
  806. * setTimeout(function() {
  807. * order.push([num, key]);
  808. * done(null, num % 2);
  809. * }, num * 10);
  810. * };
  811. * async.detectSeries(object, iterator, function(err, res) {
  812. * console.log(res); // 1
  813. * console.log(order); // [[1, 'a']]
  814. * });
  815. *
  816. */
  817. var detectSeries = createDetectSeries(true);
  818. /**
  819. * @memberof async
  820. * @namespace detectLimit
  821. * @param {Array|Object} collection
  822. * @param {number} limit - limit >= 1
  823. * @param {Function} iterator
  824. * @param {Function} callback
  825. * @example
  826. *
  827. * // array
  828. * var order = [];
  829. * var array = [1, 5, 3, 4, 2];
  830. * var iterator = function(num, done) {
  831. * setTimeout(function() {
  832. * order.push(num);
  833. * done(null, num % 2);
  834. * }, num * 10);
  835. * };
  836. * async.detectLimit(array, 2, iterator, function(err, res) {
  837. * console.log(res); // 1
  838. * console.log(order); // [1]
  839. * });
  840. *
  841. * @example
  842. *
  843. * // array with index
  844. * var order = [];
  845. * var array = [1, 5, 3, 4, 2];
  846. * var iterator = function(num, index, done) {
  847. * setTimeout(function() {
  848. * order.push([num, index]);
  849. * done(null, num % 2);
  850. * }, num * 10);
  851. * };
  852. * async.detectLimit(array, 2, iterator, function(err, res) {
  853. * console.log(res); // 1
  854. * console.log(order); // [[1, 0]]
  855. * });
  856. *
  857. * @example
  858. *
  859. * // object
  860. * var order = [];
  861. * var object = { a: 1, b: 5, c: 3, d: 4, e: 2 };
  862. * var iterator = function(num, done) {
  863. * setTimeout(function() {
  864. * order.push(num);
  865. * done(null, num % 2);
  866. * }, num * 10);
  867. * };
  868. * async.detectLimit(object, 2, iterator, function(err, res) {
  869. * console.log(res); // 1
  870. * console.log(order); // [1]
  871. * });
  872. *
  873. * @example
  874. *
  875. * // object with key
  876. * var order = [];
  877. * var object = { a: 1, b: 5, c: 3, d: 4, e: 2 };
  878. * var iterator = function(num, key, done) {
  879. * setTimeout(function() {
  880. * order.push([num, key]);
  881. * done(null, num % 2);
  882. * }, num * 10);
  883. * };
  884. * async.detectLimit(object, 2, iterator, function(err, res) {
  885. * console.log(res); // 1
  886. * console.log(order); // [[1, 'a']]
  887. * });
  888. *
  889. */
  890. var detectLimit = createDetectLimit(true);
  891. /**
  892. * @memberof async
  893. * @namespace every
  894. * @param {Array|Object} collection
  895. * @param {Function} iterator
  896. * @param {Function} callback
  897. * @example
  898. *
  899. * // array
  900. * var order = [];
  901. * var array = [1, 3, 2];
  902. * var iterator = function(num, done) {
  903. * setTimeout(function() {
  904. * order.push(num);
  905. * done(null, num % 2);
  906. * }, num * 10);
  907. * };
  908. * async.every(array, iterator, function(err, res) {
  909. * console.log(res); // false
  910. * console.log(order); // [1, 2]
  911. * });
  912. *
  913. * @example
  914. *
  915. * // array with index
  916. * var order = [];
  917. * var array = [1, 3, 2];
  918. * var iterator = function(num, index, done) {
  919. * setTimeout(function() {
  920. * order.push([num, index]);
  921. * done(null, num % 2);
  922. * }, num * 10);
  923. * };
  924. * async.every(array, iterator, function(err, res) {
  925. * console.log(res); // false
  926. * console.log(order); // [[1, 0], [2, 2]]
  927. * });
  928. *
  929. * @example
  930. *
  931. * // object
  932. * var order = [];
  933. * var object = { a: 1, b: 3, c: 2 };
  934. * var iterator = function(num, done) {
  935. * setTimeout(function() {
  936. * order.push(num);
  937. * done(null, num % 2);
  938. * }, num * 10);
  939. * };
  940. * async.every(object, iterator, function(err, res) {
  941. * console.log(res); // false
  942. * console.log(order); // [1, 2]
  943. * });
  944. *
  945. * @example
  946. *
  947. * // object with key
  948. * var order = [];
  949. * var object = { a: 1, b: 3, c: 2 };
  950. * var iterator = function(num, key, done) {
  951. * setTimeout(function() {
  952. * order.push([num, key]);
  953. * done(null, num % 2);
  954. * }, num * 10);
  955. * };
  956. * async.every(object, iterator, function(err, res) {
  957. * console.log(res); // false
  958. * console.log(order); // [[1, 'a'], [2, 'c']]
  959. * });
  960. *
  961. */
  962. var every = createEvery(arrayEachValue, baseEachValue, symbolEachValue);
  963. /**
  964. * @memberof async
  965. * @namespace everySeries
  966. * @param {Array|Object} collection
  967. * @param {Function} iterator
  968. * @param {Function} callback
  969. * @example
  970. *
  971. * // array
  972. * var order = [];
  973. * var array = [1, 3, 2];
  974. * var iterator = function(num, done) {
  975. * setTimeout(function() {
  976. * order.push(num);
  977. * done(null, num % 2);
  978. * }, num * 10);
  979. * };
  980. * async.everySeries(array, iterator, function(err, res) {
  981. * console.log(res); // false
  982. * console.log(order); // [1, 3, 2]
  983. * });
  984. *
  985. * @example
  986. *
  987. * // array with index
  988. * var order = [];
  989. * var array = [1, 3, 2];
  990. * var iterator = function(num, index, done) {
  991. * setTimeout(function() {
  992. * order.push([num, index]);
  993. * done(null, num % 2);
  994. * }, num * 10);
  995. * };
  996. * async.everySeries(array, iterator, function(err, res) {
  997. * console.log(res); // false
  998. * console.log(order); // [[1, 0], [3, 1], [2, 2]]
  999. * });
  1000. *
  1001. * @example
  1002. *
  1003. * // object
  1004. * var order = [];
  1005. * var object = { a: 1, b: 3, c: 2 };
  1006. * var iterator = function(num, done) {
  1007. * setTimeout(function() {
  1008. * order.push(num);
  1009. * done(null, num % 2);
  1010. * }, num * 10);
  1011. * };
  1012. * async.everySeries(object, iterator, function(err, res) {
  1013. * console.log(res); // false
  1014. * console.log(order); // [1, 3, 2]
  1015. * });
  1016. *
  1017. * @example
  1018. *
  1019. * // object with key
  1020. * var order = [];
  1021. * var object = { a: 1, b: 3, c: 2 };
  1022. * var iterator = function(num, key, done) {
  1023. * setTimeout(function() {
  1024. * order.push([num, key]);
  1025. * done(null, num % 2);
  1026. * }, num * 10);
  1027. * };
  1028. * async.everySeries(object, iterator, function(err, res) {
  1029. * console.log(res); // false
  1030. * console.log(order); // [[1, 'a'], [3, 'b'] [2, 'c']]
  1031. * });
  1032. *
  1033. */
  1034. var everySeries = createEverySeries();
  1035. /**
  1036. * @memberof async
  1037. * @namespace everyLimit
  1038. * @param {Array|Object} collection
  1039. * @param {number} limit - limit >= 1
  1040. * @param {Function} iterator
  1041. * @param {Function} callback
  1042. * @example
  1043. *
  1044. * // array
  1045. * var order = [];
  1046. * var array = [1, 5, 3, 4, 2];
  1047. * var iterator = function(num, done) {
  1048. * setTimeout(function() {
  1049. * order.push(num);
  1050. * done(null, num % 2);
  1051. * }, num * 10);
  1052. * };
  1053. * async.everyLimit(array, 2, iterator, function(err, res) {
  1054. * console.log(res); // false
  1055. * console.log(order); // [1, 3, 5, 2]
  1056. * });
  1057. *
  1058. * @example
  1059. *
  1060. * // array with index
  1061. * var order = [];
  1062. * var array = [1, 5, 3, 4, 2];
  1063. * var iterator = function(num, index, done) {
  1064. * setTimeout(function() {
  1065. * order.push([num, index]);
  1066. * done(null, num % 2);
  1067. * }, num * 10);
  1068. * };
  1069. * async.everyLimit(array, 2, iterator, function(err, res) {
  1070. * console.log(res); // false
  1071. * console.log(order); // [[1, 0], [3, 2], [5, 1], [2, 4]]
  1072. * });
  1073. *
  1074. * @example
  1075. *
  1076. * // object
  1077. * var order = [];
  1078. * var object = { a: 1, b: 5, c: 3, d: 4, e: 2 };
  1079. * var iterator = function(num, done) {
  1080. * setTimeout(function() {
  1081. * order.push(num);
  1082. * done(null, num % 2);
  1083. * }, num * 10);
  1084. * };
  1085. * async.everyLimit(object, 2, iterator, function(err, res) {
  1086. * console.log(res); // false
  1087. * console.log(order); // [1, 3, 5, 2]
  1088. * });
  1089. *
  1090. * @example
  1091. *
  1092. * // object with key
  1093. * var order = [];
  1094. * var object = { a: 1, b: 5, c: 3, d: 4, e: 2 };
  1095. * var iterator = function(num, key, done) {
  1096. * setTimeout(function() {
  1097. * order.push([num, key]);
  1098. * done(null, num % 2);
  1099. * }, num * 10);
  1100. * };
  1101. * async.everyLimit(object, 2, iterator, function(err, res) {
  1102. * console.log(res); // false
  1103. * console.log(order); // [[1, 'a'], [3, 'c'], [5, 'b'], [2, 'e']]
  1104. * });
  1105. *
  1106. */
  1107. var everyLimit = createEveryLimit();
  1108. /**
  1109. * @memberof async
  1110. * @namespace pick
  1111. * @param {Array|Object} collection
  1112. * @param {Function} iterator
  1113. * @param {Function} callback
  1114. * @example
  1115. *
  1116. * // array
  1117. * var order = [];
  1118. * var array = [1, 3, 2, 4];
  1119. * var iterator = function(num, done) {
  1120. * setTimeout(function() {
  1121. * order.push(num);
  1122. * done(null, num % 2);
  1123. * }, num * 10);
  1124. * };
  1125. * async.pick(array, iterator, function(err, res) {
  1126. * console.log(res); // { '0': 1, '1': 3 }
  1127. * console.log(order); // [1, 2, 3, 4]
  1128. * });
  1129. *
  1130. * @example
  1131. *
  1132. * // array with index
  1133. * var order = [];
  1134. * var array = [1, 3, 2, 4];
  1135. * var iterator = function(num, index, done) {
  1136. * setTimeout(function() {
  1137. * order.push([num, index]);
  1138. * done(null, num % 2);
  1139. * }, num * 10);
  1140. * };
  1141. * async.pick(array, iterator, function(err, res) {
  1142. * console.log(res); // { '0': 1, '1': 3 }
  1143. * console.log(order); // [[0, 1], [2, 2], [3, 1], [4, 3]]
  1144. * });
  1145. *
  1146. * @example
  1147. *
  1148. * // object
  1149. * var order = [];
  1150. * var object = { a: 1, b: 3, c: 2, d: 4 };
  1151. * var iterator = function(num, done) {
  1152. * setTimeout(function() {
  1153. * order.push(num);
  1154. * done(null, num % 2);
  1155. * }, num * 10);
  1156. * };
  1157. * async.pick(object, iterator, function(err, res) {
  1158. * console.log(res); // { a: 1, b: 3 }
  1159. * console.log(order); // [1, 2, 3, 4]
  1160. * });
  1161. *
  1162. * @example
  1163. *
  1164. * // object with key
  1165. * var order = [];
  1166. * var object = { a: 1, b: 3, c: 2, d: 4 };
  1167. * var iterator = function(num, key, done) {
  1168. * setTimeout(function() {
  1169. * order.push([num, key]);
  1170. * done(null, num % 2);
  1171. * }, num * 10);
  1172. * };
  1173. * async.pick(object, iterator, function(err, res) {
  1174. * console.log(res); // { a: 1, b: 3 }
  1175. * console.log(order); // [[1, 'a'], [2, 'c'], [3, 'b'], [4, 'd']]
  1176. * });
  1177. *
  1178. */
  1179. var pick = createPick(arrayEachIndexValue, baseEachKeyValue, symbolEachKeyValue, true);
  1180. /**
  1181. * @memberof async
  1182. * @namespace pickSeries
  1183. * @param {Array|Object} collection
  1184. * @param {Function} iterator
  1185. * @param {Function} callback
  1186. * @example
  1187. *
  1188. * // array
  1189. * var order = [];
  1190. * var array = [1, 3, 2, 4];
  1191. * var iterator = function(num, done) {
  1192. * setTimeout(function() {
  1193. * order.push(num);
  1194. * done(null, num % 2);
  1195. * }, num * 10);
  1196. * };
  1197. * async.pickSeries(array, iterator, function(err, res) {
  1198. * console.log(res); // { '0': 1, '1': 3 }
  1199. * console.log(order); // [1, 3, 2, 4]
  1200. * });
  1201. *
  1202. * @example
  1203. *
  1204. * // array with index
  1205. * var order = [];
  1206. * var array = [1, 3, 2, 4];
  1207. * var iterator = function(num, index, done) {
  1208. * setTimeout(function() {
  1209. * order.push([num, index]);
  1210. * done(null, num % 2);
  1211. * }, num * 10);
  1212. * };
  1213. * async.pickSeries(array, iterator, function(err, res) {
  1214. * console.log(res); // { '0': 1, '1': 3 }
  1215. * console.log(order); // [[0, 1], [3, 1], [2, 2], [4, 3]]
  1216. * });
  1217. *
  1218. * @example
  1219. *
  1220. * // object
  1221. * var order = [];
  1222. * var object = { a: 1, b: 3, c: 2, d: 4 };
  1223. * var iterator = function(num, done) {
  1224. * setTimeout(function() {
  1225. * order.push(num);
  1226. * done(null, num % 2);
  1227. * }, num * 10);
  1228. * };
  1229. * async.pickSeries(object, iterator, function(err, res) {
  1230. * console.log(res); // { a: 1, b: 3 }
  1231. * console.log(order); // [1, 3, 2, 4]
  1232. * });
  1233. *
  1234. * @example
  1235. *
  1236. * // object with key
  1237. * var order = [];
  1238. * var object = { a: 1, b: 3, c: 2, d: 4 };
  1239. * var iterator = function(num, key, done) {
  1240. * setTimeout(function() {
  1241. * order.push([num, key]);
  1242. * done(null, num % 2);
  1243. * }, num * 10);
  1244. * };
  1245. * async.pickSeries(object, iterator, function(err, res) {
  1246. * console.log(res); // { a: 1, b: 3 }
  1247. * console.log(order); // [[1, 'a'], [3, 'b'], [2, 'c'], [4, 'd']]
  1248. * });
  1249. *
  1250. */
  1251. var pickSeries = createPickSeries(true);
  1252. /**
  1253. * @memberof async
  1254. * @namespace pickLimit
  1255. * @param {Array|Object} collection
  1256. * @param {number} limit - limit >= 1
  1257. * @param {Function} iterator
  1258. * @param {Function} callback
  1259. * @example
  1260. *
  1261. * // array
  1262. * var order = [];
  1263. * var array = [1, 5, 3, 4, 2];
  1264. * var iterator = function(num, done) {
  1265. * setTimeout(function() {
  1266. * order.push(num);
  1267. * done(null, num % 2);
  1268. * }, num * 10);
  1269. * };
  1270. * async.pickLimit(array, 2, iterator, function(err, res) {
  1271. * console.log(res); // { '0': 1, '1': 5, '2': 3 }
  1272. * console.log(order); // [1, 3, 5, 2, 4]
  1273. * });
  1274. *
  1275. * @example
  1276. *
  1277. * // array with index
  1278. * var order = [];
  1279. * var array = [1, 5, 3, 4, 2];
  1280. * var iterator = function(num, index, done) {
  1281. * setTimeout(function() {
  1282. * order.push([num, index]);
  1283. * done(null, num % 2);
  1284. * }, num * 10);
  1285. * };
  1286. * async.pickLimit(array, 2, iterator, function(err, res) {
  1287. * console.log(res); // { '0': 1, '1': 5, '2': 3 }
  1288. * console.log(order); // [[1, 0], [3, 2], [5, 1], [2, 4], [4, 3]]
  1289. * });
  1290. *
  1291. * @example
  1292. *
  1293. * // object
  1294. * var order = [];
  1295. * var object = { a: 1, b: 5, c: 3, d: 4, e: 2 };
  1296. * var iterator = function(num, done) {
  1297. * setTimeout(function() {
  1298. * order.push(num);
  1299. * done(null, num % 2);
  1300. * }, num * 10);
  1301. * };
  1302. * async.pickLimit(object, 2, iterator, function(err, res) {
  1303. * console.log(res); // { a: 1, b: 5, c: 3 }
  1304. * console.log(order); // [1, 3, 5, 2, 4]
  1305. * });
  1306. *
  1307. * @example
  1308. *
  1309. * // object with key
  1310. * var order = [];
  1311. * var object = { a: 1, b: 5, c: 3, d: 4, e: 2 };
  1312. * var iterator = function(num, key, done) {
  1313. * setTimeout(function() {
  1314. * order.push([num, key]);
  1315. * done(null, num % 2);
  1316. * }, num * 10);
  1317. * };
  1318. * async.pickLimit(object, 2, iterator, function(err, res) {
  1319. * console.log(res); // { a: 1, b: 5, c: 3 }
  1320. * console.log(order); // [[1, 'a'], [3, 'c'], [5, 'b'], [2, 'e'], [4, 'd']]
  1321. * });
  1322. *
  1323. */
  1324. var pickLimit = createPickLimit(true);
  1325. /**
  1326. * @memberof async
  1327. * @namespace omit
  1328. * @param {Array|Object} collection
  1329. * @param {Function} iterator
  1330. * @param {Function} callback
  1331. * @example
  1332. *
  1333. * // array
  1334. * var order = [];
  1335. * var array = [1, 3, 2, 4];
  1336. * var iterator = function(num, done) {
  1337. * setTimeout(function() {
  1338. * order.push(num);
  1339. * done(null, num % 2);
  1340. * }, num * 10);
  1341. * };
  1342. * async.omit(array, iterator, function(err, res) {
  1343. * console.log(res); // { '2': 2, '3': 4 }
  1344. * console.log(order); // [1, 2, 3, 4]
  1345. * });
  1346. *
  1347. * @example
  1348. *
  1349. * // array with index
  1350. * var order = [];
  1351. * var array = [1, 3, 2, 4];
  1352. * var iterator = function(num, index, done) {
  1353. * setTimeout(function() {
  1354. * order.push([num, index]);
  1355. * done(null, num % 2);
  1356. * }, num * 10);
  1357. * };
  1358. * async.omit(array, iterator, function(err, res) {
  1359. * console.log(res); // { '2': 2, '3': 4 }
  1360. * console.log(order); // [[0, 1], [2, 2], [3, 1], [4, 3]]
  1361. * });
  1362. *
  1363. * @example
  1364. *
  1365. * // object
  1366. * var order = [];
  1367. * var object = { a: 1, b: 3, c: 2, d: 4 };
  1368. * var iterator = function(num, done) {
  1369. * setTimeout(function() {
  1370. * order.push(num);
  1371. * done(null, num % 2);
  1372. * }, num * 10);
  1373. * };
  1374. * async.omit(object, iterator, function(err, res) {
  1375. * console.log(res); // { c: 2, d: 4 }
  1376. * console.log(order); // [1, 2, 3, 4]
  1377. * });
  1378. *
  1379. * @example
  1380. *
  1381. * // object with key
  1382. * var order = [];
  1383. * var object = { a: 1, b: 3, c: 2, d: 4 };
  1384. * var iterator = function(num, key, done) {
  1385. * setTimeout(function() {
  1386. * order.push([num, key]);
  1387. * done(null, num % 2);
  1388. * }, num * 10);
  1389. * };
  1390. * async.omit(object, iterator, function(err, res) {
  1391. * console.log(res); // { c: 2, d: 4 }
  1392. * console.log(order); // [[1, 'a'], [2, 'c'], [3, 'b'], [4, 'd']]
  1393. * });
  1394. *
  1395. */
  1396. var omit = createPick(arrayEachIndexValue, baseEachKeyValue, symbolEachKeyValue, false);
  1397. /**
  1398. * @memberof async
  1399. * @namespace omitSeries
  1400. * @param {Array|Object} collection
  1401. * @param {Function} iterator
  1402. * @param {Function} callback
  1403. * @example
  1404. *
  1405. * // array
  1406. * var order = [];
  1407. * var array = [1, 3, 2, 4];
  1408. * var iterator = function(num, done) {
  1409. * setTimeout(function() {
  1410. * order.push(num);
  1411. * done(null, num % 2);
  1412. * }, num * 10);
  1413. * };
  1414. * async.omitSeries(array, iterator, function(err, res) {
  1415. * console.log(res); // { '2': 2, '3': 4 }
  1416. * console.log(order); // [1, 3, 2, 4]
  1417. * });
  1418. *
  1419. * @example
  1420. *
  1421. * // array with index
  1422. * var order = [];
  1423. * var array = [1, 3, 2, 4];
  1424. * var iterator = function(num, index, done) {
  1425. * setTimeout(function() {
  1426. * order.push([num, index]);
  1427. * done(null, num % 2);
  1428. * }, num * 10);
  1429. * };
  1430. * async.omitSeries(array, iterator, function(err, res) {
  1431. * console.log(res); // { '2': 2, '3': 4 }
  1432. * console.log(order); // [[0, 1], [3, 1], [2, 2], [4, 3]]
  1433. * });
  1434. *
  1435. * @example
  1436. *
  1437. * // object
  1438. * var order = [];
  1439. * var object = { a: 1, b: 3, c: 2, d: 4 };
  1440. * var iterator = function(num, done) {
  1441. * setTimeout(function() {
  1442. * order.push(num);
  1443. * done(null, num % 2);
  1444. * }, num * 10);
  1445. * };
  1446. * async.omitSeries(object, iterator, function(err, res) {
  1447. * console.log(res); // { c: 2, d: 4 }
  1448. * console.log(order); // [1, 3, 2, 4]
  1449. * });
  1450. *
  1451. * @example
  1452. *
  1453. * // object with key
  1454. * var order = [];
  1455. * var object = { a: 1, b: 3, c: 2, d: 4 };
  1456. * var iterator = function(num, key, done) {
  1457. * setTimeout(function() {
  1458. * order.push([num, key]);
  1459. * done(null, num % 2);
  1460. * }, num * 10);
  1461. * };
  1462. * async.omitSeries(object, iterator, function(err, res) {
  1463. * console.log(res); // { c: 2, d: 4 }
  1464. * console.log(order); // [[1, 'a'], [3, 'b'], [2, 'c'], [4, 'd']]
  1465. * });
  1466. *
  1467. */
  1468. var omitSeries = createPickSeries(false);
  1469. /**
  1470. * @memberof async
  1471. * @namespace omitLimit
  1472. * @param {Array|Object} collection
  1473. * @param {number} limit - limit >= 1
  1474. * @param {Function} iterator
  1475. * @param {Function} callback
  1476. * @example
  1477. *
  1478. * // array
  1479. * var order = [];
  1480. * var array = [1, 5, 3, 4, 2];
  1481. * var iterator = function(num, done) {
  1482. * setTimeout(function() {
  1483. * order.push(num);
  1484. * done(null, num % 2);
  1485. * }, num * 10);
  1486. * };
  1487. * async.omitLimit(array, 2, iterator, function(err, res) {
  1488. * console.log(res); // { '3': 4, '4': 2 }
  1489. * console.log(order); // [1, 3, 5, 2, 4]
  1490. * });
  1491. *
  1492. * @example
  1493. *
  1494. * // array with index
  1495. * var order = [];
  1496. * var array = [1, 5, 3, 4, 2];
  1497. * var iterator = function(num, index, done) {
  1498. * setTimeout(function() {
  1499. * order.push([num, index]);
  1500. * done(null, num % 2);
  1501. * }, num * 10);
  1502. * };
  1503. * async.omitLimit(array, 2, iterator, function(err, res) {
  1504. * console.log(res); // { '3': 4, '4': 2 }
  1505. * console.log(order); // [[1, 0], [3, 2], [5, 1], [2, 4], [4, 3]]
  1506. * });
  1507. *
  1508. * @example
  1509. *
  1510. * // object
  1511. * var order = [];
  1512. * var object = { a: 1, b: 5, c: 3, d: 4, e: 2 };
  1513. * var iterator = function(num, done) {
  1514. * setTimeout(function() {
  1515. * order.push(num);
  1516. * done(null, num % 2);
  1517. * }, num * 10);
  1518. * };
  1519. * async.omitLimit(object, 2, iterator, function(err, res) {
  1520. * console.log(res); // { d: 4, e: 2 }
  1521. * console.log(order); // [1, 3, 5, 2, 4]
  1522. * });
  1523. *
  1524. * @example
  1525. *
  1526. * // object with key
  1527. * var order = [];
  1528. * var object = { a: 1, b: 5, c: 3, d: 4, e: 2 };
  1529. * var iterator = function(num, key, done) {
  1530. * setTimeout(function() {
  1531. * order.push([num, key]);
  1532. * done(null, num % 2);
  1533. * }, num * 10);
  1534. * };
  1535. * async.omitLimit(object, 2, iterator, function(err, res) {
  1536. * console.log(res); // { d: 4, e: 2 }
  1537. * console.log(order); // [[1, 'a'], [3, 'c'], [5, 'b'], [2, 'e'], [4, 'd']]
  1538. * });
  1539. *
  1540. */
  1541. var omitLimit = createPickLimit(false);
  1542. /**
  1543. * @memberof async
  1544. * @namespace transform
  1545. * @param {Array|Object} collection
  1546. * @param {Array|Object|Function} [accumulator]
  1547. * @param {Function} [iterator]
  1548. * @param {Function} [callback]
  1549. * @example
  1550. *
  1551. * // array
  1552. * var order = [];
  1553. * var collection = [1, 3, 2, 4];
  1554. * var iterator = function(result, num, done) {
  1555. * setTimeout(function() {
  1556. * order.push(num);
  1557. * result.push(num)
  1558. * done();
  1559. * }, num * 10);
  1560. * };
  1561. * async.transform(collection, iterator, function(err, res) {
  1562. * console.log(res); // [1, 2, 3, 4]
  1563. * console.log(order); // [1, 2, 3, 4]
  1564. * });
  1565. *
  1566. * @example
  1567. *
  1568. * // array with index and accumulator
  1569. * var order = [];
  1570. * var collection = [1, 3, 2, 4];
  1571. * var iterator = function(result, num, index, done) {
  1572. * setTimeout(function() {
  1573. * order.push([num, index]);
  1574. * result[index] = num;
  1575. * done();
  1576. * }, num * 10);
  1577. * };
  1578. * async.transform(collection, {}, iterator, function(err, res) {
  1579. * console.log(res); // { '0': 1, '1': 3, '2': 2, '3': 4 }
  1580. * console.log(order); // [[1, 0], [2, 2], [3, 1], [4, 3]]
  1581. * });
  1582. *
  1583. * @example
  1584. *
  1585. * // object with accumulator
  1586. * var order = [];
  1587. * var object = { a: 1, b: 3, c: 2, d: 4 };
  1588. * var iterator = function(result, num, done) {
  1589. * setTimeout(function() {
  1590. * order.push(num);
  1591. * result.push(num);
  1592. * done();
  1593. * }, num * 10);
  1594. * };
  1595. * async.transform(collection, [], iterator, function(err, res) {
  1596. * console.log(res); // [1, 2, 3, 4]
  1597. * console.log(order); // [1, 2, 3, 4]
  1598. * });
  1599. *
  1600. * @example
  1601. *
  1602. * // object with key
  1603. * var order = [];
  1604. * var object = { a: 1, b: 3, c: 2, d: 4 };
  1605. * var iterator = function(result, num, key, done) {
  1606. * setTimeout(function() {
  1607. * order.push([num, key]);
  1608. * result[key] = num;
  1609. * done();
  1610. * }, num * 10);
  1611. * };
  1612. * async.transform(collection, iterator, function(err, res) {
  1613. * console.log(res); // { a: 1, b: 3, c: 2, d: 4 }
  1614. * console.log(order); // [[1, 'a'], [2, 'c'], [3, 'b'], [4, 'd']]
  1615. * });
  1616. *
  1617. */
  1618. var transform = createTransform(arrayEachResult, baseEachResult, symbolEachResult);
  1619. /**
  1620. * @memberof async
  1621. * @namespace sortBy
  1622. * @param {Array|Object} collection
  1623. * @param {Function} iterator
  1624. * @param {Function} callback
  1625. * @example
  1626. *
  1627. * // array
  1628. * var order = [];
  1629. * var array = [1, 3, 2];
  1630. * var iterator = function(num, done) {
  1631. * setTimeout(function() {
  1632. * order.push(num);
  1633. * done(null, num);
  1634. * }, num * 10);
  1635. * };
  1636. * async.sortBy(array, iterator, function(err, res) {
  1637. * console.log(res); // [1, 2, 3];
  1638. * console.log(order); // [1, 2, 3]
  1639. * });
  1640. *
  1641. * @example
  1642. *
  1643. * // array with index
  1644. * var order = [];
  1645. * var array = [1, 3, 2];
  1646. * var iterator = function(num, index, done) {
  1647. * setTimeout(function() {
  1648. * order.push([num, index]);
  1649. * done(null, num);
  1650. * }, num * 10);
  1651. * };
  1652. * async.sortBy(array, iterator, function(err, res) {
  1653. * console.log(res); // [1, 2, 3]
  1654. * console.log(order); // [[1, 0], [2, 2], [3, 1]]
  1655. * });
  1656. *
  1657. * @example
  1658. *
  1659. * // object
  1660. * var order = [];
  1661. * var object = { a: 1, b: 3, c: 2 };
  1662. * var iterator = function(num, done) {
  1663. * setTimeout(function() {
  1664. * order.push(num);
  1665. * done(null, num);
  1666. * }, num * 10);
  1667. * };
  1668. * async.sortBy(object, iterator, function(err, res) {
  1669. * console.log(res); // [1, 2, 3]
  1670. * console.log(order); // [1, 2, 3]
  1671. * });
  1672. *
  1673. * @example
  1674. *
  1675. * // object with key
  1676. * var order = [];
  1677. * var object = { a: 1, b: 3, c: 2 };
  1678. * var iterator = function(num, key, done) {
  1679. * setTimeout(function() {
  1680. * order.push([num, key]);
  1681. * done(null, num);
  1682. * }, num * 10);
  1683. * };
  1684. * async.sortBy(object, iterator, function(err, res) {
  1685. * console.log(res); // [1, 2, 3]
  1686. * console.log(order); // [[1, 'a'], [2, 'c'], [3, 'b']]
  1687. * });
  1688. *
  1689. */
  1690. var sortBy = createSortBy(arrayEachIndexValue, baseEachIndexValue, symbolEachIndexValue);
  1691. /**
  1692. * @memberof async
  1693. * @namespace concat
  1694. * @param {Array|Object} collection
  1695. * @param {Function} iterator
  1696. * @param {Function} callback
  1697. * @example
  1698. *
  1699. * // array
  1700. * var order = [];
  1701. * var array = [1, 3, 2];
  1702. * var iterator = function(num, done) {
  1703. * setTimeout(function() {
  1704. * order.push(num);
  1705. * done(null, [num]);
  1706. * }, num * 10);
  1707. * };
  1708. * async.concat(array, iterator, function(err, res) {
  1709. * console.log(res); // [1, 2, 3];
  1710. * console.log(order); // [1, 2, 3]
  1711. * });
  1712. *
  1713. * @example
  1714. *
  1715. * // array with index
  1716. * var order = [];
  1717. * var array = [1, 3, 2];
  1718. * var iterator = function(num, index, done) {
  1719. * setTimeout(function() {
  1720. * order.push([num, index]);
  1721. * done(null, [num]);
  1722. * }, num * 10);
  1723. * };
  1724. * async.concat(array, iterator, function(err, res) {
  1725. * console.log(res); // [1, 2, 3]
  1726. * console.log(order); // [[1, 0], [2, 2], [3, 1]]
  1727. * });
  1728. *
  1729. * @example
  1730. *
  1731. * // object
  1732. * var order = [];
  1733. * var object = { a: 1, b: 3, c: 2 };
  1734. * var iterator = function(num, done) {
  1735. * setTimeout(function() {
  1736. * order.push(num);
  1737. * done(null, [num]);
  1738. * }, num * 10);
  1739. * };
  1740. * async.concat(object, iterator, function(err, res) {
  1741. * console.log(res); // [1, 2, 3]
  1742. * console.log(order); // [1, 2, 3]
  1743. * });
  1744. *
  1745. * @example
  1746. *
  1747. * // object with key
  1748. * var order = [];
  1749. * var object = { a: 1, b: 3, c: 2 };
  1750. * var iterator = function(num, key, done) {
  1751. * setTimeout(function() {
  1752. * order.push([num, key]);
  1753. * done(null, [num]);
  1754. * }, num * 10);
  1755. * };
  1756. * async.concat(object, iterator, function(err, res) {
  1757. * console.log(res); // [1, 2, 3]
  1758. * console.log(order); // [[1, 'a'], [2, 'c'], [3, 'b']]
  1759. * });
  1760. *
  1761. */
  1762. var concat = createConcat(arrayEachIndex, baseEachIndex, symbolEachIndex);
  1763. /**
  1764. * @memberof async
  1765. * @namespace groupBy
  1766. * @param {Array|Object} collection
  1767. * @param {Function} iterator
  1768. * @param {Function} callback
  1769. * @example
  1770. *
  1771. * // array
  1772. * var order = [];
  1773. * var array = [4.2, 6.4, 6.1];
  1774. * var iterator = function(num, done) {
  1775. * setTimeout(function() {
  1776. * order.push(num);
  1777. * done(null, Math.floor(num));
  1778. * }, num * 10);
  1779. * };
  1780. * async.groupBy(array, iterator, function(err, res) {
  1781. * console.log(res); // { '4': [4.2], '6': [6.1, 6.4] }
  1782. * console.log(order); // [4.2, 6.1, 6.4]
  1783. * });
  1784. *
  1785. * @example
  1786. *
  1787. * // array with index
  1788. * var order = [];
  1789. * var array = [4.2, 6.4, 6.1];
  1790. * var iterator = function(num, index, done) {
  1791. * setTimeout(function() {
  1792. * order.push([num, index]);
  1793. * done(null, Math.floor(num));
  1794. * }, num * 10);
  1795. * };
  1796. * async.groupBy(array, iterator, function(err, res) {
  1797. * console.log(res); // { '4': [4.2], '6': [6.1, 6.4] }
  1798. * console.log(order); // [[4.2, 0], [6.1, 2], [6.4, 1]]
  1799. * });
  1800. *
  1801. * @example
  1802. *
  1803. * // object
  1804. * var order = [];
  1805. * var object = { a: 4.2, b: 6.4, c: 6.1 };
  1806. * var iterator = function(num, done) {
  1807. * setTimeout(function() {
  1808. * order.push(num);
  1809. * done(null, Math.floor(num));
  1810. * }, num * 10);
  1811. * };
  1812. * async.groupBy(object, iterator, function(err, res) {
  1813. * console.log(res); // { '4': [4.2], '6': [6.1, 6.4] }
  1814. * console.log(order); // [4.2, 6.1, 6.4]
  1815. * });
  1816. *
  1817. * @example
  1818. *
  1819. * // object with key
  1820. * var order = [];
  1821. * var object = { a: 4.2, b: 6.4, c: 6.1 };
  1822. * var iterator = function(num, key, done) {
  1823. * setTimeout(function() {
  1824. * order.push([num, key]);
  1825. * done(null, Math.floor(num));
  1826. * }, num * 10);
  1827. * };
  1828. * async.groupBy(object, iterator, function(err, res) {
  1829. * console.log(res); // { '4': [4.2], '6': [6.1, 6.4] }
  1830. * console.log(order); // [[4.2, 'a'], [6.1, 'c'], [6.4, 'b']]
  1831. * });
  1832. *
  1833. */
  1834. var groupBy = createGroupBy(arrayEachValue, baseEachValue, symbolEachValue);
  1835. /**
  1836. * @memberof async
  1837. * @namespace parallel
  1838. * @param {Array|Object} tasks - functions
  1839. * @param {Function} callback
  1840. * @example
  1841. *
  1842. * var order = [];
  1843. * var tasks = [
  1844. * function(done) {
  1845. * setTimeout(function() {
  1846. * order.push(1);
  1847. * done(null, 1);
  1848. * }, 10);
  1849. * },
  1850. * function(done) {
  1851. * setTimeout(function() {
  1852. * order.push(2);
  1853. * done(null, 2);
  1854. * }, 30);
  1855. * },
  1856. * function(done) {
  1857. * setTimeout(function() {
  1858. * order.push(3);
  1859. * done(null, 3);
  1860. * }, 40);
  1861. * },
  1862. * function(done) {
  1863. * setTimeout(function() {
  1864. * order.push(4);
  1865. * done(null, 4);
  1866. * }, 20);
  1867. * }
  1868. * ];
  1869. * async.parallel(tasks, function(err, res) {
  1870. * console.log(res); // [1, 2, 3, 4];
  1871. * console.log(order); // [1, 4, 2, 3]
  1872. * });
  1873. *
  1874. * @example
  1875. *
  1876. * var order = [];
  1877. * var tasks = {
  1878. * 'a': function(done) {
  1879. * setTimeout(function() {
  1880. * order.push(1);
  1881. * done(null, 1);
  1882. * }, 10);
  1883. * },
  1884. * 'b': function(done) {
  1885. * setTimeout(function() {
  1886. * order.push(2);
  1887. * done(null, 2);
  1888. * }, 30);
  1889. * },
  1890. * 'c': function(done) {
  1891. * setTimeout(function() {
  1892. * order.push(3);
  1893. * done(null, 3);
  1894. * }, 40);
  1895. * },
  1896. * 'd': function(done) {
  1897. * setTimeout(function() {
  1898. * order.push(4);
  1899. * done(null, 4);
  1900. * }, 20);
  1901. * }
  1902. * };
  1903. * async.parallel(tasks, function(err, res) {
  1904. * console.log(res); // { a: 1, b: 2, c: 3, d:4 }
  1905. * console.log(order); // [1, 4, 2, 3]
  1906. * });
  1907. *
  1908. */
  1909. var parallel = createParallel(arrayEachFunc, baseEachFunc);
  1910. /**
  1911. * @memberof async
  1912. * @namespace applyEach
  1913. */
  1914. var applyEach = createApplyEach(map);
  1915. /**
  1916. * @memberof async
  1917. * @namespace applyEachSeries
  1918. */
  1919. var applyEachSeries = createApplyEach(mapSeries);
  1920. /**
  1921. * @memberof async
  1922. * @namespace log
  1923. */
  1924. var log = createLogger('log');
  1925. /**
  1926. * @memberof async
  1927. * @namespace dir
  1928. */
  1929. var dir = createLogger('dir');
  1930. /**
  1931. * @version 2.6.0
  1932. * @namespace async
  1933. */
  1934. var index = {
  1935. VERSION: '2.6.0',
  1936. // Collections
  1937. each: each,
  1938. eachSeries: eachSeries,
  1939. eachLimit: eachLimit,
  1940. forEach: each,
  1941. forEachSeries: eachSeries,
  1942. forEachLimit: eachLimit,
  1943. eachOf: each,
  1944. eachOfSeries: eachSeries,
  1945. eachOfLimit: eachLimit,
  1946. forEachOf: each,
  1947. forEachOfSeries: eachSeries,
  1948. forEachOfLimit: eachLimit,
  1949. map: map,
  1950. mapSeries: mapSeries,
  1951. mapLimit: mapLimit,
  1952. mapValues: mapValues,
  1953. mapValuesSeries: mapValuesSeries,
  1954. mapValuesLimit: mapValuesLimit,
  1955. filter: filter,
  1956. filterSeries: filterSeries,
  1957. filterLimit: filterLimit,
  1958. select: filter,
  1959. selectSeries: filterSeries,
  1960. selectLimit: filterLimit,
  1961. reject: reject,
  1962. rejectSeries: rejectSeries,
  1963. rejectLimit: rejectLimit,
  1964. detect: detect,
  1965. detectSeries: detectSeries,
  1966. detectLimit: detectLimit,
  1967. find: detect,
  1968. findSeries: detectSeries,
  1969. findLimit: detectLimit,
  1970. pick: pick,
  1971. pickSeries: pickSeries,
  1972. pickLimit: pickLimit,
  1973. omit: omit,
  1974. omitSeries: omitSeries,
  1975. omitLimit: omitLimit,
  1976. reduce: reduce,
  1977. inject: reduce,
  1978. foldl: reduce,
  1979. reduceRight: reduceRight,
  1980. foldr: reduceRight,
  1981. transform: transform,
  1982. transformSeries: transformSeries,
  1983. transformLimit: transformLimit,
  1984. sortBy: sortBy,
  1985. sortBySeries: sortBySeries,
  1986. sortByLimit: sortByLimit,
  1987. some: some,
  1988. someSeries: someSeries,
  1989. someLimit: someLimit,
  1990. any: some,
  1991. anySeries: someSeries,
  1992. anyLimit: someLimit,
  1993. every: every,
  1994. everySeries: everySeries,
  1995. everyLimit: everyLimit,
  1996. all: every,
  1997. allSeries: everySeries,
  1998. allLimit: everyLimit,
  1999. concat: concat,
  2000. concatSeries: concatSeries,
  2001. concatLimit: concatLimit,
  2002. groupBy: groupBy,
  2003. groupBySeries: groupBySeries,
  2004. groupByLimit: groupByLimit,
  2005. // Control Flow
  2006. parallel: parallel,
  2007. series: series,
  2008. parallelLimit: parallelLimit,
  2009. tryEach: tryEach,
  2010. waterfall: waterfall,
  2011. angelFall: angelFall,
  2012. angelfall: angelFall,
  2013. whilst: whilst,
  2014. doWhilst: doWhilst,
  2015. until: until,
  2016. doUntil: doUntil,
  2017. during: during,
  2018. doDuring: doDuring,
  2019. forever: forever,
  2020. compose: compose,
  2021. seq: seq,
  2022. applyEach: applyEach,
  2023. applyEachSeries: applyEachSeries,
  2024. queue: queue,
  2025. priorityQueue: priorityQueue,
  2026. cargo: cargo,
  2027. auto: auto,
  2028. autoInject: autoInject,
  2029. retry: retry,
  2030. retryable: retryable,
  2031. iterator: iterator,
  2032. times: times,
  2033. timesSeries: timesSeries,
  2034. timesLimit: timesLimit,
  2035. race: race,
  2036. // Utils
  2037. apply: apply,
  2038. nextTick: asyncNextTick,
  2039. setImmediate: asyncSetImmediate,
  2040. memoize: memoize,
  2041. unmemoize: unmemoize,
  2042. ensureAsync: ensureAsync,
  2043. constant: constant,
  2044. asyncify: asyncify,
  2045. wrapSync: asyncify,
  2046. log: log,
  2047. dir: dir,
  2048. reflect: reflect,
  2049. reflectAll: reflectAll,
  2050. timeout: timeout,
  2051. createLogger: createLogger,
  2052. // Mode
  2053. safe: safe,
  2054. fast: fast
  2055. };
  2056. exports['default'] = index;
  2057. baseEachSync(index, function(func, key) {
  2058. exports[key] = func;
  2059. }, nativeKeys(index));
  2060. /**
  2061. * @private
  2062. */
  2063. function createImmediate(safeMode) {
  2064. var delay = function delay(fn) {
  2065. var args = slice(arguments, 1);
  2066. setTimeout(function() {
  2067. fn.apply(null, args);
  2068. });
  2069. };
  2070. asyncSetImmediate = typeof setImmediate === func ? setImmediate : delay;
  2071. if (typeof process === obj && typeof process.nextTick === func) {
  2072. nextTick = /^v0.10/.test(process.version) ? asyncSetImmediate : process.nextTick;
  2073. asyncNextTick = /^v0/.test(process.version) ? asyncSetImmediate : process.nextTick;
  2074. } else {
  2075. asyncNextTick = nextTick = asyncSetImmediate;
  2076. }
  2077. if (safeMode === false) {
  2078. nextTick = function(cb) {
  2079. cb();
  2080. };
  2081. }
  2082. }
  2083. /* sync functions based on lodash */
  2084. /**
  2085. * Converts `arguments` to an array.
  2086. *
  2087. * @private
  2088. * @param {Array} array = The array to slice.
  2089. */
  2090. function createArray(array) {
  2091. var index = -1;
  2092. var size = array.length;
  2093. var result = Array(size);
  2094. while (++index < size) {
  2095. result[index] = array[index];
  2096. }
  2097. return result;
  2098. }
  2099. /**
  2100. * Create an array from `start`
  2101. *
  2102. * @private
  2103. * @param {Array} array - The array to slice.
  2104. * @param {number} start - The start position.
  2105. */
  2106. function slice(array, start) {
  2107. var end = array.length;
  2108. var index = -1;
  2109. var size = end - start;
  2110. if (size <= 0) {
  2111. return [];
  2112. }
  2113. var result = Array(size);
  2114. while (++index < size) {
  2115. result[index] = array[index + start];
  2116. }
  2117. return result;
  2118. }
  2119. /**
  2120. * @private
  2121. * @param {Object} object
  2122. */
  2123. function objectClone(object) {
  2124. var keys = nativeKeys(object);
  2125. var size = keys.length;
  2126. var index = -1;
  2127. var result = {};
  2128. while (++index < size) {
  2129. var key = keys[index];
  2130. result[key] = object[key];
  2131. }
  2132. return result;
  2133. }
  2134. /**
  2135. * Create an array with all falsey values removed.
  2136. *
  2137. * @private
  2138. * @param {Array} array - The array to compact.
  2139. */
  2140. function compact(array) {
  2141. var index = -1;
  2142. var size = array.length;
  2143. var result = [];
  2144. while (++index < size) {
  2145. var value = array[index];
  2146. if (value) {
  2147. result[result.length] = value;
  2148. }
  2149. }
  2150. return result;
  2151. }
  2152. /**
  2153. * Create an array of reverse sequence.
  2154. *
  2155. * @private
  2156. * @param {Array} array - The array to reverse.
  2157. */
  2158. function reverse(array) {
  2159. var index = -1;
  2160. var size = array.length;
  2161. var result = Array(size);
  2162. var resIndex = size;
  2163. while (++index < size) {
  2164. result[--resIndex] = array[index];
  2165. }
  2166. return result;
  2167. }
  2168. /**
  2169. * Checks if key exists in object property.
  2170. *
  2171. * @private
  2172. * @param {Object} object - The object to inspect.
  2173. * @param {string} key - The key to check.
  2174. */
  2175. function has(object, key) {
  2176. return object.hasOwnProperty(key);
  2177. }
  2178. /**
  2179. * Check if target exists in array.
  2180. * @private
  2181. * @param {Array} array
  2182. * @param {*} target
  2183. */
  2184. function notInclude(array, target) {
  2185. var index = -1;
  2186. var size = array.length;
  2187. while(++index < size) {
  2188. if (array[index] === target) {
  2189. return false;
  2190. }
  2191. }
  2192. return true;
  2193. }
  2194. /**
  2195. * @private
  2196. * @param {Array} array - The array to iterate over.
  2197. * @param {Function} iterator - The function invoked per iteration.
  2198. */
  2199. function arrayEachSync(array, iterator) {
  2200. var index = -1;
  2201. var size = array.length;
  2202. while (++index < size) {
  2203. iterator(array[index], index);
  2204. }
  2205. return array;
  2206. }
  2207. /**
  2208. * @private
  2209. * @param {Object} object - The object to iterate over.
  2210. * @param {Function} iterator - The function invoked per iteration.
  2211. * @param {Array} keys
  2212. */
  2213. function baseEachSync(object, iterator, keys) {
  2214. var index = -1;
  2215. var size = keys.length;
  2216. while (++index < size) {
  2217. var key = keys[index];
  2218. iterator(object[key], key);
  2219. }
  2220. return object;
  2221. }
  2222. /**
  2223. * @private
  2224. * @param {number} n
  2225. * @param {Function} iterator
  2226. */
  2227. function timesSync(n, iterator) {
  2228. var index = -1;
  2229. while (++index < n) {
  2230. iterator(index);
  2231. }
  2232. }
  2233. /**
  2234. * @private
  2235. * @param {Array} array
  2236. * @param {number[]} criteria
  2237. */
  2238. function sortByCriteria(array, criteria) {
  2239. var l = array.length;
  2240. var indices = Array(l);
  2241. var i;
  2242. for (i = 0; i < l; i++) {
  2243. indices[i] = i;
  2244. }
  2245. quickSort(criteria, 0, l - 1, indices);
  2246. var result = Array(l);
  2247. for (var n = 0; n < l; n++) {
  2248. i = indices[n];
  2249. result[n] = i === undefined ? array[n] : array[i];
  2250. }
  2251. return result;
  2252. }
  2253. function partition(array, i, j, mid, indices) {
  2254. var l = i;
  2255. var r = j;
  2256. while (l <= r) {
  2257. i = l;
  2258. while (l < r && array[l] < mid) {
  2259. l++;
  2260. }
  2261. while (r >= i && array[r] >= mid) {
  2262. r--;
  2263. }
  2264. if (l > r) {
  2265. break;
  2266. }
  2267. swap(array, indices, l++, r--);
  2268. }
  2269. return l;
  2270. }
  2271. function swap(array, indices, l, r) {
  2272. var n = array[l];
  2273. array[l] = array[r];
  2274. array[r] = n;
  2275. var i = indices[l];
  2276. indices[l] = indices[r];
  2277. indices[r] = i;
  2278. }
  2279. function quickSort(array, i, j, indices) {
  2280. if (i === j) {
  2281. return;
  2282. }
  2283. var k = i;
  2284. while (++k <= j && array[i] === array[k]) {
  2285. var l = k - 1;
  2286. if (indices[l] > indices[k]) {
  2287. var index = indices[l];
  2288. indices[l] = indices[k];
  2289. indices[k] = index;
  2290. }
  2291. }
  2292. if (k > j) {
  2293. return;
  2294. }
  2295. var p = array[i] > array[k] ? i : k;
  2296. k = partition(array, i, j, array[p], indices);
  2297. quickSort(array, i, k - 1, indices);
  2298. quickSort(array, k, j, indices);
  2299. }
  2300. /**
  2301. * @Private
  2302. */
  2303. function makeConcatResult(array) {
  2304. var result = [];
  2305. arrayEachSync(array, function(value) {
  2306. if (value === noop) {
  2307. return;
  2308. }
  2309. if (isArray(value)) {
  2310. nativePush.apply(result, value);
  2311. } else {
  2312. result.push(value);
  2313. }
  2314. });
  2315. return result;
  2316. }
  2317. /* async functions */
  2318. /**
  2319. * @private
  2320. */
  2321. function arrayEach(array, iterator, callback) {
  2322. var index = -1;
  2323. var size = array.length;
  2324. if (iterator.length === 3) {
  2325. while (++index < size) {
  2326. iterator(array[index], index, onlyOnce(callback));
  2327. }
  2328. } else {
  2329. while (++index < size) {
  2330. iterator(array[index], onlyOnce(callback));
  2331. }
  2332. }
  2333. }
  2334. /**
  2335. * @private
  2336. */
  2337. function baseEach(object, iterator, callback, keys) {
  2338. var key;
  2339. var index = -1;
  2340. var size = keys.length;
  2341. if (iterator.length === 3) {
  2342. while (++index < size) {
  2343. key = keys[index];
  2344. iterator(object[key], key, onlyOnce(callback));
  2345. }
  2346. } else {
  2347. while (++index < size) {
  2348. iterator(object[keys[index]], onlyOnce(callback));
  2349. }
  2350. }
  2351. }
  2352. /**
  2353. * @private
  2354. */
  2355. function symbolEach(collection, iterator, callback) {
  2356. var iter = collection[iteratorSymbol]();
  2357. var index = 0;
  2358. var item;
  2359. if (iterator.length === 3) {
  2360. while ((item = iter.next()).done === false) {
  2361. iterator(item.value, index++, onlyOnce(callback));
  2362. }
  2363. } else {
  2364. while ((item = iter.next()).done === false) {
  2365. index++;
  2366. iterator(item.value, onlyOnce(callback));
  2367. }
  2368. }
  2369. return index;
  2370. }
  2371. /**
  2372. * @private
  2373. */
  2374. function arrayEachResult(array, result, iterator, callback) {
  2375. var index = -1;
  2376. var size = array.length;
  2377. if (iterator.length === 4) {
  2378. while (++index < size) {
  2379. iterator(result, array[index], index, onlyOnce(callback));
  2380. }
  2381. } else {
  2382. while (++index < size) {
  2383. iterator(result, array[index], onlyOnce(callback));
  2384. }
  2385. }
  2386. }
  2387. /**
  2388. * @private
  2389. */
  2390. function baseEachResult(object, result, iterator, callback, keys) {
  2391. var key;
  2392. var index = -1;
  2393. var size = keys.length;
  2394. if (iterator.length === 4) {
  2395. while (++index < size) {
  2396. key = keys[index];
  2397. iterator(result, object[key], key, onlyOnce(callback));
  2398. }
  2399. } else {
  2400. while (++index < size) {
  2401. iterator(result, object[keys[index]], onlyOnce(callback));
  2402. }
  2403. }
  2404. }
  2405. /**
  2406. * @private
  2407. */
  2408. function symbolEachResult(collection, result, iterator, callback) {
  2409. var item;
  2410. var index = 0;
  2411. var iter = collection[iteratorSymbol]();
  2412. if (iterator.length === 4) {
  2413. while ((item = iter.next()).done === false) {
  2414. iterator(result, item.value, index++, onlyOnce(callback));
  2415. }
  2416. } else {
  2417. while ((item = iter.next()).done === false) {
  2418. index++;
  2419. iterator(result, item.value, onlyOnce(callback));
  2420. }
  2421. }
  2422. return index;
  2423. }
  2424. /**
  2425. * @private
  2426. */
  2427. function arrayEachFunc(array, createCallback) {
  2428. var index = -1;
  2429. var size = array.length;
  2430. while (++index < size) {
  2431. array[index](createCallback(index));
  2432. }
  2433. }
  2434. /**
  2435. * @private
  2436. */
  2437. function baseEachFunc(object, createCallback, keys) {
  2438. var key;
  2439. var index = -1;
  2440. var size = keys.length;
  2441. while (++index < size) {
  2442. key = keys[index];
  2443. object[key](createCallback(key));
  2444. }
  2445. }
  2446. /**
  2447. * @private
  2448. */
  2449. function arrayEachIndex(array, iterator, createCallback) {
  2450. var index = -1;
  2451. var size = array.length;
  2452. if (iterator.length === 3) {
  2453. while (++index < size) {
  2454. iterator(array[index], index, createCallback(index));
  2455. }
  2456. } else {
  2457. while (++index < size) {
  2458. iterator(array[index], createCallback(index));
  2459. }
  2460. }
  2461. }
  2462. /**
  2463. * @private
  2464. */
  2465. function baseEachIndex(object, iterator, createCallback, keys) {
  2466. var key;
  2467. var index = -1;
  2468. var size = keys.length;
  2469. if (iterator.length === 3) {
  2470. while (++index < size) {
  2471. key = keys[index];
  2472. iterator(object[key], key, createCallback(index));
  2473. }
  2474. } else {
  2475. while (++index < size) {
  2476. iterator(object[keys[index]], createCallback(index));
  2477. }
  2478. }
  2479. }
  2480. /**
  2481. * @private
  2482. */
  2483. function symbolEachIndex(collection, iterator, createCallback) {
  2484. var item;
  2485. var index = 0;
  2486. var iter = collection[iteratorSymbol]();
  2487. if (iterator.length === 3) {
  2488. while ((item = iter.next()).done === false) {
  2489. iterator(item.value, index, createCallback(index++));
  2490. }
  2491. } else {
  2492. while ((item = iter.next()).done === false) {
  2493. iterator(item.value, createCallback(index++));
  2494. }
  2495. }
  2496. return index;
  2497. }
  2498. /**
  2499. * @private
  2500. */
  2501. function baseEachKey(object, iterator, createCallback, keys) {
  2502. var key;
  2503. var index = -1;
  2504. var size = keys.length;
  2505. if (iterator.length === 3) {
  2506. while (++index < size) {
  2507. key = keys[index];
  2508. iterator(object[key], key, createCallback(key));
  2509. }
  2510. } else {
  2511. while (++index < size) {
  2512. key = keys[index];
  2513. iterator(object[key], createCallback(key));
  2514. }
  2515. }
  2516. }
  2517. /**
  2518. * @private
  2519. */
  2520. function symbolEachKey(collection, iterator, createCallback) {
  2521. var item;
  2522. var index = 0;
  2523. var iter = collection[iteratorSymbol]();
  2524. if (iterator.length === 3) {
  2525. while ((item = iter.next()).done === false) {
  2526. iterator(item.value, index, createCallback(index++));
  2527. }
  2528. } else {
  2529. while ((item = iter.next()).done === false) {
  2530. iterator(item.value, createCallback(index++));
  2531. }
  2532. }
  2533. return index;
  2534. }
  2535. /**
  2536. * @private
  2537. */
  2538. function arrayEachValue(array, iterator, createCallback) {
  2539. var value;
  2540. var index = -1;
  2541. var size = array.length;
  2542. if (iterator.length === 3) {
  2543. while (++index < size) {
  2544. value = array[index];
  2545. iterator(value, index, createCallback(value));
  2546. }
  2547. } else {
  2548. while (++index < size) {
  2549. value = array[index];
  2550. iterator(value, createCallback(value));
  2551. }
  2552. }
  2553. }
  2554. /**
  2555. * @private
  2556. */
  2557. function baseEachValue(object, iterator, createCallback, keys) {
  2558. var key, value;
  2559. var index = -1;
  2560. var size = keys.length;
  2561. if (iterator.length === 3) {
  2562. while (++index < size) {
  2563. key = keys[index];
  2564. value = object[key];
  2565. iterator(value, key, createCallback(value));
  2566. }
  2567. } else {
  2568. while (++index < size) {
  2569. value = object[keys[index]];
  2570. iterator(value, createCallback(value));
  2571. }
  2572. }
  2573. }
  2574. /**
  2575. * @private
  2576. */
  2577. function symbolEachValue(collection, iterator, createCallback) {
  2578. var value, item;
  2579. var index = 0;
  2580. var iter = collection[iteratorSymbol]();
  2581. if (iterator.length === 3) {
  2582. while ((item = iter.next()).done === false) {
  2583. value = item.value;
  2584. iterator(value, index++, createCallback(value));
  2585. }
  2586. } else {
  2587. while ((item = iter.next()).done === false) {
  2588. index++;
  2589. value = item.value;
  2590. iterator(value, createCallback(value));
  2591. }
  2592. }
  2593. return index;
  2594. }
  2595. /**
  2596. * @private
  2597. */
  2598. function arrayEachIndexValue(array, iterator, createCallback) {
  2599. var value;
  2600. var index = -1;
  2601. var size = array.length;
  2602. if (iterator.length === 3) {
  2603. while (++index < size) {
  2604. value = array[index];
  2605. iterator(value, index, createCallback(index, value));
  2606. }
  2607. } else {
  2608. while (++index < size) {
  2609. value = array[index];
  2610. iterator(value, createCallback(index, value));
  2611. }
  2612. }
  2613. }
  2614. /**
  2615. * @private
  2616. */
  2617. function baseEachIndexValue(object, iterator, createCallback, keys) {
  2618. var key, value;
  2619. var index = -1;
  2620. var size = keys.length;
  2621. if (iterator.length === 3) {
  2622. while (++index < size) {
  2623. key = keys[index];
  2624. value = object[key];
  2625. iterator(value, key, createCallback(index, value));
  2626. }
  2627. } else {
  2628. while (++index < size) {
  2629. value = object[keys[index]];
  2630. iterator(value, createCallback(index, value));
  2631. }
  2632. }
  2633. }
  2634. /**
  2635. * @private
  2636. */
  2637. function symbolEachIndexValue(collection, iterator, createCallback) {
  2638. var value, item;
  2639. var index = 0;
  2640. var iter = collection[iteratorSymbol]();
  2641. if (iterator.length === 3) {
  2642. while ((item = iter.next()).done === false) {
  2643. value = item.value;
  2644. iterator(value, index, createCallback(index++, value));
  2645. }
  2646. } else {
  2647. while ((item = iter.next()).done === false) {
  2648. value = item.value;
  2649. iterator(value, createCallback(index++, value));
  2650. }
  2651. }
  2652. return index;
  2653. }
  2654. /**
  2655. * @private
  2656. */
  2657. function baseEachKeyValue(object, iterator, createCallback, keys) {
  2658. var key, value;
  2659. var index = -1;
  2660. var size = keys.length;
  2661. if (iterator.length === 3) {
  2662. while (++index < size) {
  2663. key = keys[index];
  2664. value = object[key];
  2665. iterator(value, key, createCallback(key, value));
  2666. }
  2667. } else {
  2668. while (++index < size) {
  2669. key = keys[index];
  2670. value = object[key];
  2671. iterator(value, createCallback(key, value));
  2672. }
  2673. }
  2674. }
  2675. /**
  2676. * @private
  2677. */
  2678. function symbolEachKeyValue(collection, iterator, createCallback) {
  2679. var value, item;
  2680. var index = 0;
  2681. var iter = collection[iteratorSymbol]();
  2682. if (iterator.length === 3) {
  2683. while ((item = iter.next()).done === false) {
  2684. value = item.value;
  2685. iterator(value, index, createCallback(index++, value));
  2686. }
  2687. } else {
  2688. while ((item = iter.next()).done === false) {
  2689. value = item.value;
  2690. iterator(value, createCallback(index++, value));
  2691. }
  2692. }
  2693. return index;
  2694. }
  2695. /**
  2696. * @private
  2697. * @param {Function} func
  2698. */
  2699. function onlyOnce(func) {
  2700. return function(err, res) {
  2701. var fn = func;
  2702. func = throwError;
  2703. fn(err, res);
  2704. };
  2705. }
  2706. /**
  2707. * @private
  2708. * @param {Function} func
  2709. */
  2710. function once(func) {
  2711. return function(err, res) {
  2712. var fn = func;
  2713. func = noop;
  2714. fn(err, res);
  2715. };
  2716. }
  2717. /**
  2718. * @private
  2719. * @param {Function} arrayEach
  2720. * @param {Function} baseEach
  2721. */
  2722. function createEach(arrayEach, baseEach, symbolEach) {
  2723. return function each(collection, iterator, callback) {
  2724. callback = once(callback || noop);
  2725. var size, keys;
  2726. var completed = 0;
  2727. if (isArray(collection)) {
  2728. size = collection.length;
  2729. arrayEach(collection, iterator, done);
  2730. } else if (!collection) {
  2731. } else if (iteratorSymbol && collection[iteratorSymbol]) {
  2732. size = symbolEach(collection, iterator, done);
  2733. size && size === completed && callback(null);
  2734. } else if (typeof collection === obj) {
  2735. keys = nativeKeys(collection);
  2736. size = keys.length;
  2737. baseEach(collection, iterator, done, keys);
  2738. }
  2739. if (!size) {
  2740. callback(null);
  2741. }
  2742. function done(err, bool) {
  2743. if (err) {
  2744. callback = once(callback);
  2745. callback(err);
  2746. } else if (++completed === size) {
  2747. callback(null);
  2748. } else if (bool === false) {
  2749. callback = once(callback);
  2750. callback(null);
  2751. }
  2752. }
  2753. };
  2754. }
  2755. /**
  2756. * @private
  2757. * @param {Function} arrayEach
  2758. * @param {Function} baseEach
  2759. * @param {Function} symbolEach
  2760. */
  2761. function createMap(arrayEach, baseEach, symbolEach, useArray) {
  2762. var init, clone;
  2763. if (useArray) {
  2764. init = Array;
  2765. clone = createArray;
  2766. } else {
  2767. init = function() {
  2768. return {};
  2769. };
  2770. clone = objectClone;
  2771. }
  2772. return function(collection, iterator, callback) {
  2773. callback = callback || noop;
  2774. var size, keys, result;
  2775. var completed = 0;
  2776. if (isArray(collection)) {
  2777. size = collection.length;
  2778. result = init(size);
  2779. arrayEach(collection, iterator, createCallback);
  2780. } else if (!collection) {
  2781. } else if (iteratorSymbol && collection[iteratorSymbol]) {
  2782. // TODO: size could be changed
  2783. result = init(0);
  2784. size = symbolEach(collection, iterator, createCallback);
  2785. size && size === completed && callback(null, result);
  2786. } else if (typeof collection === obj) {
  2787. keys = nativeKeys(collection);
  2788. size = keys.length;
  2789. result = init(size);
  2790. baseEach(collection, iterator, createCallback, keys);
  2791. }
  2792. if (!size) {
  2793. callback(null, init());
  2794. }
  2795. function createCallback(key) {
  2796. return function done(err, res) {
  2797. if (key === null) {
  2798. throwError();
  2799. }
  2800. if (err) {
  2801. key = null;
  2802. callback = once(callback);
  2803. callback(err, clone(result));
  2804. return;
  2805. }
  2806. result[key] = res;
  2807. key = null;
  2808. if (++completed === size) {
  2809. callback(null, result);
  2810. }
  2811. };
  2812. }
  2813. };
  2814. }
  2815. /**
  2816. * @private
  2817. * @param {Function} arrayEach
  2818. * @param {Function} baseEach
  2819. * @param {Function} symbolEach
  2820. * @param {boolean} bool
  2821. */
  2822. function createFilter(arrayEach, baseEach, symbolEach, bool) {
  2823. return function(collection, iterator, callback) {
  2824. callback = callback || noop;
  2825. var size, keys, result;
  2826. var completed = 0;
  2827. if (isArray(collection)) {
  2828. size = collection.length;
  2829. result = Array(size);
  2830. arrayEach(collection, iterator, createCallback);
  2831. } else if (!collection) {
  2832. } else if (iteratorSymbol && collection[iteratorSymbol]) {
  2833. result = [];
  2834. size = symbolEach(collection, iterator, createCallback);
  2835. size && size === completed && callback(null, compact(result));
  2836. } else if (typeof collection === obj) {
  2837. keys = nativeKeys(collection);
  2838. size = keys.length;
  2839. result = Array(size);
  2840. baseEach(collection, iterator, createCallback, keys);
  2841. }
  2842. if (!size) {
  2843. return callback(null, []);
  2844. }
  2845. function createCallback(index, value) {
  2846. return function done(err, res) {
  2847. if (index === null) {
  2848. throwError();
  2849. }
  2850. if (err) {
  2851. index = null;
  2852. callback = once(callback);
  2853. callback(err);
  2854. return;
  2855. }
  2856. if (!!res === bool) {
  2857. result[index] = value;
  2858. }
  2859. index = null;
  2860. if (++completed === size) {
  2861. callback(null, compact(result));
  2862. }
  2863. };
  2864. }
  2865. };
  2866. }
  2867. /**
  2868. * @private
  2869. * @param {boolean} bool
  2870. */
  2871. function createFilterSeries(bool) {
  2872. return function(collection, iterator, callback) {
  2873. callback = onlyOnce(callback || noop);
  2874. var size, key, value, keys, iter, item, iterate;
  2875. var sync = false;
  2876. var completed = 0;
  2877. var result = [];
  2878. if (isArray(collection)) {
  2879. size = collection.length;
  2880. iterate = iterator.length === 3 ? arrayIteratorWithIndex : arrayIterator;
  2881. } else if (!collection) {
  2882. } else if (iteratorSymbol && collection[iteratorSymbol]) {
  2883. size = Infinity;
  2884. iter = collection[iteratorSymbol]();
  2885. iterate = iterator.length === 3 ? symbolIteratorWithKey : symbolIterator;
  2886. } else if (typeof collection === obj) {
  2887. keys = nativeKeys(collection);
  2888. size = keys.length;
  2889. iterate = iterator.length === 3 ? objectIteratorWithKey : objectIterator;
  2890. }
  2891. if (!size) {
  2892. return callback(null, []);
  2893. }
  2894. iterate();
  2895. function arrayIterator() {
  2896. value = collection[completed];
  2897. iterator(value, done);
  2898. }
  2899. function arrayIteratorWithIndex() {
  2900. value = collection[completed];
  2901. iterator(value, completed, done);
  2902. }
  2903. function symbolIterator() {
  2904. item = iter.next();
  2905. value = item.value;
  2906. item.done ? callback(null, result) : iterator(value, done);
  2907. }
  2908. function symbolIteratorWithKey() {
  2909. item = iter.next();
  2910. value = item.value;
  2911. item.done ? callback(null, result) : iterator(value, completed, done);
  2912. }
  2913. function objectIterator() {
  2914. key = keys[completed];
  2915. value = collection[key];
  2916. iterator(value, done);
  2917. }
  2918. function objectIteratorWithKey() {
  2919. key = keys[completed];
  2920. value = collection[key];
  2921. iterator(value, key, done);
  2922. }
  2923. function done(err, res) {
  2924. if (err) {
  2925. callback(err);
  2926. return;
  2927. }
  2928. if (!!res === bool) {
  2929. result[result.length] = value;
  2930. }
  2931. if (++completed === size) {
  2932. iterate = throwError;
  2933. callback(null, result);
  2934. } else if (sync) {
  2935. nextTick(iterate);
  2936. } else {
  2937. sync = true;
  2938. iterate();
  2939. }
  2940. sync = false;
  2941. }
  2942. };
  2943. }
  2944. /**
  2945. * @private
  2946. * @param {boolean} bool
  2947. */
  2948. function createFilterLimit(bool) {
  2949. return function(collection, limit, iterator, callback) {
  2950. callback = callback || noop;
  2951. var size, index, key, value, keys, iter, item, iterate, result;
  2952. var sync = false;
  2953. var started = 0;
  2954. var completed = 0;
  2955. if (isArray(collection)) {
  2956. size = collection.length;
  2957. iterate = iterator.length === 3 ? arrayIteratorWithIndex : arrayIterator;
  2958. } else if (!collection) {
  2959. } else if (iteratorSymbol && collection[iteratorSymbol]) {
  2960. size = Infinity;
  2961. result = [];
  2962. iter = collection[iteratorSymbol]();
  2963. iterate = iterator.length === 3 ? symbolIteratorWithKey : symbolIterator;
  2964. } else if (typeof collection === obj) {
  2965. keys = nativeKeys(collection);
  2966. size = keys.length;
  2967. iterate = iterator.length === 3 ? objectIteratorWithKey : objectIterator;
  2968. }
  2969. if (!size || isNaN(limit) || limit < 1) {
  2970. return callback(null, []);
  2971. }
  2972. result = result || Array(size);
  2973. timesSync(limit > size ? size : limit, iterate);
  2974. function arrayIterator() {
  2975. index = started++;
  2976. if (index < size) {
  2977. value = collection[index];
  2978. iterator(value, createCallback(value, index));
  2979. }
  2980. }
  2981. function arrayIteratorWithIndex() {
  2982. index = started++;
  2983. if (index < size) {
  2984. value = collection[index];
  2985. iterator(value, index, createCallback(value, index));
  2986. }
  2987. }
  2988. function symbolIterator() {
  2989. item = iter.next();
  2990. if (item.done === false) {
  2991. value = item.value;
  2992. iterator(value, createCallback(value, started++));
  2993. } else if (completed >= collection.size && iterator !== noop) {
  2994. iterator = noop;
  2995. callback(null, compact(result));
  2996. }
  2997. }
  2998. function symbolIteratorWithKey() {
  2999. item = iter.next();
  3000. if (item.done === false) {
  3001. value = item.value;
  3002. iterator(value, started, createCallback(value, started++));
  3003. } else if (completed >= collection.size && iterator !== noop) {
  3004. iterator = noop;
  3005. callback(null, compact(result));
  3006. }
  3007. }
  3008. function objectIterator() {
  3009. index = started++;
  3010. if (index < size) {
  3011. value = collection[keys[index]];
  3012. iterator(value, createCallback(value, index));
  3013. }
  3014. }
  3015. function objectIteratorWithKey() {
  3016. index = started++;
  3017. if (index < size) {
  3018. key = keys[index];
  3019. value = collection[key];
  3020. iterator(value, key, createCallback(value, index));
  3021. }
  3022. }
  3023. function createCallback(value, index) {
  3024. return function(err, res) {
  3025. if (index === null) {
  3026. throwError();
  3027. }
  3028. if (err) {
  3029. index = null;
  3030. iterate = noop;
  3031. callback = once(callback);
  3032. callback(err);
  3033. return;
  3034. }
  3035. if (!!res === bool) {
  3036. result[index] = value;
  3037. }
  3038. index = null;
  3039. if (++completed === size) {
  3040. callback = onlyOnce(callback);
  3041. callback(null, compact(result));
  3042. } else if (sync) {
  3043. nextTick(iterate);
  3044. } else {
  3045. sync = true;
  3046. iterate();
  3047. }
  3048. sync = false;
  3049. };
  3050. }
  3051. };
  3052. }
  3053. /**
  3054. * @memberof async
  3055. * @namespace eachSeries
  3056. * @param {Array|Object} collection
  3057. * @param {Function} iterator
  3058. * @param {Function} callback
  3059. * @example
  3060. *
  3061. * // array
  3062. * var order = [];
  3063. * var array = [1, 3, 2];
  3064. * var iterator = function(num, done) {
  3065. * setTimeout(function() {
  3066. * order.push(num);
  3067. * done();
  3068. * }, num * 10);
  3069. * };
  3070. * async.eachSeries(array, iterator, function(err, res) {
  3071. * console.log(res); // undefined
  3072. * console.log(order); // [1, 3, 2]
  3073. * });
  3074. *
  3075. * @example
  3076. *
  3077. * // array with index
  3078. * var order = [];
  3079. * var array = [1, 3, 2];
  3080. * var iterator = function(num, index, done) {
  3081. * setTimeout(function() {
  3082. * order.push([num, index]);
  3083. * done();
  3084. * }, num * 10);
  3085. * };
  3086. * async.eachSeries(array, iterator, function(err, res) {
  3087. * console.log(res); // undefined
  3088. * console.log(order); // [[1, 0], [3, 1], [2, 2]]
  3089. * });
  3090. *
  3091. * @example
  3092. *
  3093. * // object
  3094. * var order = [];
  3095. * var object = { a: 1, b: 3, c: 2 };
  3096. * var iterator = function(num, done) {
  3097. * setTimeout(function() {
  3098. * order.push(num);
  3099. * done();
  3100. * }, num * 10);
  3101. * };
  3102. * async.eachSeries(object, iterator, function(err, res) {
  3103. * console.log(res); // undefined
  3104. * console.log(order); // [1, 3, 2]
  3105. * });
  3106. *
  3107. * @example
  3108. *
  3109. * // object with key
  3110. * var order = [];
  3111. * var object = { a: 1, b: 3, c: 2 };
  3112. * var iterator = function(num, key, done) {
  3113. * setTimeout(function() {
  3114. * order.push([num, key]);
  3115. * done();
  3116. * }, num * 10);
  3117. * };
  3118. * async.eachSeries(object, iterator, function(err, res) {
  3119. * console.log(res); // undefined
  3120. * console.log(order); // [[1, 'a'], [3, 'b'], [2, 'b']]
  3121. * });
  3122. *
  3123. * @example
  3124. *
  3125. * // break
  3126. * var order = [];
  3127. * var array = [1, 3, 2];
  3128. * var iterator = function(num, done) {
  3129. * setTimeout(function() {
  3130. * order.push(num);
  3131. * done(null, num !== 3);
  3132. * }, num * 10);
  3133. * };
  3134. * async.eachSeries(array, iterator, function(err, res) {
  3135. * console.log(res); // undefined
  3136. * console.log(order); // [1, 3]
  3137. * });
  3138. */
  3139. function eachSeries(collection, iterator, callback) {
  3140. callback = onlyOnce(callback || noop);
  3141. var size, key, keys, iter, item, iterate;
  3142. var sync = false;
  3143. var completed = 0;
  3144. if (isArray(collection)) {
  3145. size = collection.length;
  3146. iterate = iterator.length === 3 ? arrayIteratorWithIndex : arrayIterator;
  3147. } else if (!collection) {
  3148. } else if (iteratorSymbol && collection[iteratorSymbol]) {
  3149. size = Infinity;
  3150. iter = collection[iteratorSymbol]();
  3151. iterate = iterator.length === 3 ? symbolIteratorWithKey : symbolIterator;
  3152. } else if (typeof collection === obj) {
  3153. keys = nativeKeys(collection);
  3154. size = keys.length;
  3155. iterate = iterator.length === 3 ? objectIteratorWithKey : objectIterator;
  3156. }
  3157. if (!size) {
  3158. return callback(null);
  3159. }
  3160. iterate();
  3161. function arrayIterator() {
  3162. iterator(collection[completed], done);
  3163. }
  3164. function arrayIteratorWithIndex() {
  3165. iterator(collection[completed], completed, done);
  3166. }
  3167. function symbolIterator() {
  3168. item = iter.next();
  3169. item.done ? callback(null) : iterator(item.value, done);
  3170. }
  3171. function symbolIteratorWithKey() {
  3172. item = iter.next();
  3173. item.done ? callback(null) : iterator(item.value, completed, done);
  3174. }
  3175. function objectIterator() {
  3176. iterator(collection[keys[completed]], done);
  3177. }
  3178. function objectIteratorWithKey() {
  3179. key = keys[completed];
  3180. iterator(collection[key], key, done);
  3181. }
  3182. function done(err, bool) {
  3183. if (err) {
  3184. callback(err);
  3185. } else if (++completed === size || bool === false) {
  3186. iterate = throwError;
  3187. callback(null);
  3188. } else if (sync) {
  3189. nextTick(iterate);
  3190. } else {
  3191. sync = true;
  3192. iterate();
  3193. }
  3194. sync = false;
  3195. }
  3196. }
  3197. /**
  3198. * @memberof async
  3199. * @namespace eachLimit
  3200. * @param {Array|Object} collection
  3201. * @param {number} limit - limit >= 1
  3202. * @param {Function} iterator
  3203. * @param {Function} callback
  3204. * @example
  3205. *
  3206. * // array
  3207. * var order = [];
  3208. * var array = [1, 5, 3, 4, 2];
  3209. * var iterator = function(num, done) {
  3210. * setTimeout(function() {
  3211. * order.push(num);
  3212. * done();
  3213. * }, num * 10);
  3214. * };
  3215. * async.eachLimit(array, 2, iterator, function(err, res) {
  3216. * console.log(res); // undefined
  3217. * console.log(order); // [1, 3, 5, 2, 4]
  3218. * });
  3219. *
  3220. * @example
  3221. *
  3222. * // array with index
  3223. * var order = [];
  3224. * var array = [1, 5, 3, 4, 2];
  3225. * var iterator = function(num, index, done) {
  3226. * setTimeout(function() {
  3227. * order.push([num, index]);
  3228. * done();
  3229. * }, num * 10);
  3230. * };
  3231. * async.eachLimit(array, 2, iterator, function(err, res) {
  3232. * console.log(res); // undefined
  3233. * console.log(order); // [[1, 0], [3, 2], [5, 1], [2, 4], [4, 3]]
  3234. * });
  3235. *
  3236. * @example
  3237. *
  3238. * // object
  3239. * var order = [];
  3240. * var object = { a: 1, b: 5, c: 3, d: 4, e: 2 };
  3241. * var iterator = function(num, done) {
  3242. * setTimeout(function() {
  3243. * order.push(num);
  3244. * done();
  3245. * }, num * 10);
  3246. * };
  3247. * async.eachLimit(object, 2, iterator, function(err, res) {
  3248. * console.log(res); // undefined
  3249. * console.log(order); // [1, 3, 5, 2, 4]
  3250. * });
  3251. *
  3252. * @example
  3253. *
  3254. * // object with key
  3255. * var order = [];
  3256. * var object = { a: 1, b: 5, c: 3, d: 4, e: 2 };
  3257. * var iterator = function(num, key, done) {
  3258. * setTimeout(function() {
  3259. * order.push([num, key]);
  3260. * done();
  3261. * }, num * 10);
  3262. * };
  3263. * async.eachLimit(object, 2, iterator, function(err, res) {
  3264. * console.log(res); // undefined
  3265. * console.log(order); // [[1, 'a'], [3, 'c'], [5, 'b'], [2, 'e'], [4, 'd']]
  3266. * });
  3267. *
  3268. * @example
  3269. *
  3270. * // break
  3271. * var order = [];
  3272. * var array = [1, 5, 3, 4, 2];
  3273. * var iterator = function(num, done) {
  3274. * setTimeout(function() {
  3275. * order.push(num);
  3276. * done(null, num !== 5);
  3277. * }, num * 10);
  3278. * };
  3279. * async.eachLimit(array, 2, iterator, function(err, res) {
  3280. * console.log(res); // undefined
  3281. * console.log(order); // [1, 3, 5]
  3282. * });
  3283. *
  3284. */
  3285. function eachLimit(collection, limit, iterator, callback) {
  3286. callback = callback || noop;
  3287. var size, index, key, keys, iter, item, iterate;
  3288. var sync = false;
  3289. var started = 0;
  3290. var completed = 0;
  3291. if (isArray(collection)) {
  3292. size = collection.length;
  3293. iterate = iterator.length === 3 ? arrayIteratorWithIndex : arrayIterator;
  3294. } else if (!collection) {
  3295. } else if (iteratorSymbol && collection[iteratorSymbol]) {
  3296. size = Infinity;
  3297. iter = collection[iteratorSymbol]();
  3298. iterate = iterator.length === 3 ? symbolIteratorWithKey : symbolIterator;
  3299. } else if (typeof collection === obj) {
  3300. keys = nativeKeys(collection);
  3301. size = keys.length;
  3302. iterate = iterator.length === 3 ? objectIteratorWithKey : objectIterator;
  3303. } else {
  3304. return callback(null);
  3305. }
  3306. if (!size || isNaN(limit) || limit < 1) {
  3307. return callback(null);
  3308. }
  3309. timesSync(limit > size ? size : limit, iterate);
  3310. function arrayIterator() {
  3311. if (started < size) {
  3312. iterator(collection[started++], done);
  3313. }
  3314. }
  3315. function arrayIteratorWithIndex() {
  3316. index = started++;
  3317. if (index < size) {
  3318. iterator(collection[index], index, done);
  3319. }
  3320. }
  3321. function symbolIterator() {
  3322. item = iter.next();
  3323. if (item.done === false) {
  3324. iterator(item.value, done);
  3325. } else if (completed >= collection.size && iterator !== noop) {
  3326. iterator = noop;
  3327. callback(null);
  3328. }
  3329. }
  3330. function symbolIteratorWithKey() {
  3331. item = iter.next();
  3332. if (item.done === false) {
  3333. iterator(item.value, started++, done);
  3334. } else if (completed >= collection.size && iterator !== noop) {
  3335. iterator = noop;
  3336. callback(null);
  3337. }
  3338. }
  3339. function objectIterator() {
  3340. if (started < size) {
  3341. iterator(collection[keys[started++]], done);
  3342. }
  3343. }
  3344. function objectIteratorWithKey() {
  3345. index = started++;
  3346. if (index < size) {
  3347. key = keys[index];
  3348. iterator(collection[key], key, done);
  3349. }
  3350. }
  3351. function done(err, bool) {
  3352. if (err || bool === false) {
  3353. iterate = noop;
  3354. callback = once(callback);
  3355. callback(err);
  3356. } else if (++completed === size) {
  3357. iterator = noop;
  3358. iterate = throwError;
  3359. callback = onlyOnce(callback);
  3360. callback(null);
  3361. } else if (sync) {
  3362. nextTick(iterate);
  3363. } else {
  3364. sync = true;
  3365. iterate();
  3366. }
  3367. sync = false;
  3368. }
  3369. }
  3370. /**
  3371. * @memberof async
  3372. * @namespace mapSeries
  3373. * @param {Array|Object} collection
  3374. * @param {Function} iterator
  3375. * @param {Function} callback
  3376. * @example
  3377. *
  3378. * // array
  3379. * var order = [];
  3380. * var array = [1, 3, 2];
  3381. * var iterator = function(num, done) {
  3382. * setTimeout(function() {
  3383. * order.push(num);
  3384. * done(null, num);
  3385. * }, num * 10);
  3386. * };
  3387. * async.mapSeries(array, iterator, function(err, res) {
  3388. * console.log(res); // [1, 3, 2];
  3389. * console.log(order); // [1, 3, 2]
  3390. * });
  3391. *
  3392. * @example
  3393. *
  3394. * // array with index
  3395. * var order = [];
  3396. * var array = [1, 3, 2];
  3397. * var iterator = function(num, index, done) {
  3398. * setTimeout(function() {
  3399. * order.push([num, index]);
  3400. * done(null, num);
  3401. * }, num * 10);
  3402. * };
  3403. * async.mapSeries(array, iterator, function(err, res) {
  3404. * console.log(res); // [1, 3, 2]
  3405. * console.log(order); // [[1, 0], [3, 1], [2, 2]]
  3406. * });
  3407. *
  3408. * @example
  3409. *
  3410. * // object
  3411. * var order = [];
  3412. * var object = { a: 1, b: 3, c: 2 };
  3413. * var iterator = function(num, done) {
  3414. * setTimeout(function() {
  3415. * order.push(num);
  3416. * done(null, num);
  3417. * }, num * 10);
  3418. * };
  3419. * async.mapSeries(object, iterator, function(err, res) {
  3420. * console.log(res); // [1, 3, 2]
  3421. * console.log(order); // [1, 3, 2]
  3422. * });
  3423. *
  3424. * @example
  3425. *
  3426. * // object with key
  3427. * var order = [];
  3428. * var object = { a: 1, b: 3, c: 2 };
  3429. * var iterator = function(num, key, done) {
  3430. * setTimeout(function() {
  3431. * order.push([num, key]);
  3432. * done(null, num);
  3433. * }, num * 10);
  3434. * };
  3435. * async.mapSeries(object, iterator, function(err, res) {
  3436. * console.log(res); // [1, 3, 2]
  3437. * console.log(order); // [[1, 'a'], [3, 'b'], [2, 'c']]
  3438. * });
  3439. *
  3440. */
  3441. function mapSeries(collection, iterator, callback) {
  3442. callback = callback || noop;
  3443. var size, key, keys, iter, item, result, iterate;
  3444. var sync = false;
  3445. var completed = 0;
  3446. if (isArray(collection)) {
  3447. size = collection.length;
  3448. iterate = iterator.length === 3 ? arrayIteratorWithIndex : arrayIterator;
  3449. } else if (!collection) {
  3450. } else if (iteratorSymbol && collection[iteratorSymbol]) {
  3451. size = Infinity;
  3452. result = [];
  3453. iter = collection[iteratorSymbol]();
  3454. iterate = iterator.length === 3 ? symbolIteratorWithKey : symbolIterator;
  3455. } else if (typeof collection === obj) {
  3456. keys = nativeKeys(collection);
  3457. size = keys.length;
  3458. iterate = iterator.length === 3 ? objectIteratorWithKey : objectIterator;
  3459. }
  3460. if (!size) {
  3461. return callback(null, []);
  3462. }
  3463. result = result || Array(size);
  3464. iterate();
  3465. function arrayIterator() {
  3466. iterator(collection[completed], done);
  3467. }
  3468. function arrayIteratorWithIndex() {
  3469. iterator(collection[completed], completed, done);
  3470. }
  3471. function symbolIterator() {
  3472. item = iter.next();
  3473. item.done ? callback(null, result) : iterator(item.value, done);
  3474. }
  3475. function symbolIteratorWithKey() {
  3476. item = iter.next();
  3477. item.done ? callback(null, result) : iterator(item.value, completed, done);
  3478. }
  3479. function objectIterator() {
  3480. iterator(collection[keys[completed]], done);
  3481. }
  3482. function objectIteratorWithKey() {
  3483. key = keys[completed];
  3484. iterator(collection[key], key, done);
  3485. }
  3486. function done(err, res) {
  3487. if (err) {
  3488. iterate = throwError;
  3489. callback = onlyOnce(callback);
  3490. callback(err, createArray(result));
  3491. return;
  3492. }
  3493. result[completed] = res;
  3494. if (++completed === size) {
  3495. iterate = throwError;
  3496. callback(null, result);
  3497. callback = throwError;
  3498. } else if (sync) {
  3499. nextTick(iterate);
  3500. } else {
  3501. sync = true;
  3502. iterate();
  3503. }
  3504. sync = false;
  3505. }
  3506. }
  3507. /**
  3508. * @memberof async
  3509. * @namespace mapLimit
  3510. * @param {Array|Object} collection
  3511. * @param {number} limit - limit >= 1
  3512. * @param {Function} iterator
  3513. * @param {Function} callback
  3514. * @example
  3515. *
  3516. * // array
  3517. * var order = [];
  3518. * var array = [1, 5, 3, 4, 2];
  3519. * var iterator = function(num, done) {
  3520. * setTimeout(function() {
  3521. * order.push(num);
  3522. * done(null, num);
  3523. * }, num * 10);
  3524. * };
  3525. * async.mapLimit(array, 2, iterator, function(err, res) {
  3526. * console.log(res); // [1, 5, 3, 4, 2]
  3527. * console.log(order); // [1, 3, 5, 2, 4]
  3528. * });
  3529. *
  3530. * @example
  3531. *
  3532. * // array with index
  3533. * var order = [];
  3534. * var array = [1, 5, 3, 4, 2];
  3535. * var iterator = function(num, index, done) {
  3536. * setTimeout(function() {
  3537. * order.push([num, index]);
  3538. * done(null, num);
  3539. * }, num * 10);
  3540. * };
  3541. * async.mapLimit(array, 2, iterator, function(err, res) {
  3542. * console.log(res); // [1, 5, 3, 4, 2]
  3543. * console.log(order); // [[1, 0], [3, 2], [5, 1], [2, 4], [4, 3]]
  3544. * });
  3545. *
  3546. * @example
  3547. *
  3548. * // object
  3549. * var order = [];
  3550. * var object = { a: 1, b: 5, c: 3, d: 4, e: 2 };
  3551. * var iterator = function(num, done) {
  3552. * setTimeout(function() {
  3553. * order.push(num);
  3554. * done(null, num);
  3555. * }, num * 10);
  3556. * };
  3557. * async.mapLimit(object, 2, iterator, function(err, res) {
  3558. * console.log(res); // [1, 5, 3, 4, 2]
  3559. * console.log(order); // [1, 3, 5, 2, 4]
  3560. * });
  3561. *
  3562. * @example
  3563. *
  3564. * // object with key
  3565. * var order = [];
  3566. * var object = { a: 1, b: 5, c: 3, d: 4, e: 2 };
  3567. * var iterator = function(num, key, done) {
  3568. * setTimeout(function() {
  3569. * order.push([num, key]);
  3570. * done(null, num);
  3571. * }, num * 10);
  3572. * };
  3573. * async.mapLimit(object, 2, iterator, function(err, res) {
  3574. * console.log(res); // [1, 5, 3, 4, 2]
  3575. * console.log(order); // [[1, 'a'], [3, 'c'], [5, 'b'], [2, 'e'], [4, 'd']]
  3576. * });
  3577. *
  3578. */
  3579. function mapLimit(collection, limit, iterator, callback) {
  3580. callback = callback || noop;
  3581. var size, index, key, keys, iter, item, result, iterate;
  3582. var sync = false;
  3583. var started = 0;
  3584. var completed = 0;
  3585. if (isArray(collection)) {
  3586. size = collection.length;
  3587. iterate = iterator.length === 3 ? arrayIteratorWithIndex : arrayIterator;
  3588. } else if (!collection) {
  3589. } else if (iteratorSymbol && collection[iteratorSymbol]) {
  3590. size = Infinity;
  3591. result = [];
  3592. iter = collection[iteratorSymbol]();
  3593. iterate = iterator.length === 3 ? symbolIteratorWithKey : symbolIterator;
  3594. } else if (typeof collection === obj) {
  3595. keys = nativeKeys(collection);
  3596. size = keys.length;
  3597. iterate = iterator.length === 3 ? objectIteratorWithKey : objectIterator;
  3598. }
  3599. if (!size || isNaN(limit) || limit < 1) {
  3600. return callback(null, []);
  3601. }
  3602. result = result || Array(size);
  3603. timesSync(limit > size ? size : limit, iterate);
  3604. function arrayIterator() {
  3605. index = started++;
  3606. if (index < size) {
  3607. iterator(collection[index], createCallback(index));
  3608. }
  3609. }
  3610. function arrayIteratorWithIndex() {
  3611. index = started++;
  3612. if (index < size) {
  3613. iterator(collection[index], index, createCallback(index));
  3614. }
  3615. }
  3616. function symbolIterator() {
  3617. item = iter.next();
  3618. if (item.done === false) {
  3619. iterator(item.value, createCallback(started++));
  3620. } else if (completed >= collection.size && iterator !== noop) {
  3621. iterator = noop;
  3622. callback(null, result);
  3623. }
  3624. }
  3625. function symbolIteratorWithKey() {
  3626. item = iter.next();
  3627. if (item.done === false) {
  3628. iterator(item.value, started, createCallback(started++));
  3629. } else if (completed >= collection.size && iterator !== noop) {
  3630. iterator = noop;
  3631. callback(null, result);
  3632. }
  3633. }
  3634. function objectIterator() {
  3635. index = started++;
  3636. if (index < size) {
  3637. iterator(collection[keys[index]], createCallback(index));
  3638. }
  3639. }
  3640. function objectIteratorWithKey() {
  3641. index = started++;
  3642. if (index < size) {
  3643. key = keys[index];
  3644. iterator(collection[key], key, createCallback(index));
  3645. }
  3646. }
  3647. function createCallback(index) {
  3648. return function(err, res) {
  3649. if (index === null) {
  3650. throwError();
  3651. }
  3652. if (err) {
  3653. index = null;
  3654. iterate = noop;
  3655. callback = once(callback);
  3656. callback(err, createArray(result));
  3657. return;
  3658. }
  3659. result[index] = res;
  3660. index = null;
  3661. if (++completed === size) {
  3662. iterate = throwError;
  3663. callback(null, result);
  3664. callback = throwError;
  3665. } else if (sync) {
  3666. nextTick(iterate);
  3667. } else {
  3668. sync = true;
  3669. iterate();
  3670. }
  3671. sync = false;
  3672. };
  3673. }
  3674. }
  3675. /**
  3676. * @memberof async
  3677. * @namespace mapValuesSeries
  3678. * @param {Array|Object} collection
  3679. * @param {Function} iterator
  3680. * @param {Function} callback
  3681. * @example
  3682. *
  3683. * // array
  3684. * var order = [];
  3685. * var array = [1, 3, 2];
  3686. * var iterator = function(num, done) {
  3687. * setTimeout(function() {
  3688. * order.push(num);
  3689. * done(null, num);
  3690. * }, num * 10);
  3691. * };
  3692. * async.mapValuesSeries(array, iterator, function(err, res) {
  3693. * console.log(res); // { '0': 1, '1': 3, '2': 2 }
  3694. * console.log(order); // [1, 3, 2]
  3695. * });
  3696. *
  3697. * @example
  3698. *
  3699. * // array with index
  3700. * var order = [];
  3701. * var array = [1, 3, 2];
  3702. * var iterator = function(num, index, done) {
  3703. * setTimeout(function() {
  3704. * order.push([num, index]);
  3705. * done(null, num);
  3706. * }, num * 10);
  3707. * };
  3708. * async.mapValuesSeries(array, iterator, function(err, res) {
  3709. * console.log(res); // { '0': 1, '1': 3, '2': 2 }
  3710. * console.log(order); // [[1, 0], [3, 1], [2, 2]]
  3711. * });
  3712. *
  3713. * @example
  3714. *
  3715. * // object
  3716. * var order = [];
  3717. * var object = { a: 1, b: 3, c: 2 };
  3718. * var iterator = function(num, done) {
  3719. * setTimeout(function() {
  3720. * order.push(num);
  3721. * done(null, num);
  3722. * }, num * 10);
  3723. * };
  3724. * async.mapValuesSeries(object, iterator, function(err, res) {
  3725. * console.log(res); // { a: 1, b: 3, c: 2 }
  3726. * console.log(order); // [1, 3, 2]
  3727. * });
  3728. *
  3729. * @example
  3730. *
  3731. * // object with key
  3732. * var order = [];
  3733. * var object = { a: 1, b: 3, c: 2 };
  3734. * var iterator = function(num, key, done) {
  3735. * setTimeout(function() {
  3736. * order.push([num, key]);
  3737. * done(null, num);
  3738. * }, num * 10);
  3739. * };
  3740. * async.mapValuesSeries(object, iterator, function(err, res) {
  3741. * console.log(res); // { a: 1, b: 3, c: 2 }
  3742. * console.log(order); // [[1, 'a'], [3, 'b'], [2, 'c']]
  3743. * });
  3744. *
  3745. */
  3746. function mapValuesSeries(collection, iterator, callback) {
  3747. callback = callback || noop;
  3748. var size, key, keys, iter, item, iterate;
  3749. var sync = false;
  3750. var result = {};
  3751. var completed = 0;
  3752. if (isArray(collection)) {
  3753. size = collection.length;
  3754. iterate = iterator.length === 3 ? arrayIteratorWithIndex : arrayIterator;
  3755. } else if (!collection) {
  3756. } else if (iteratorSymbol && collection[iteratorSymbol]) {
  3757. size = Infinity;
  3758. iter = collection[iteratorSymbol]();
  3759. iterate = iterator.length === 3 ? symbolIteratorWithKey : symbolIterator;
  3760. } else if (typeof collection === obj) {
  3761. keys = nativeKeys(collection);
  3762. size = keys.length;
  3763. iterate = iterator.length === 3 ? objectIteratorWithKey : objectIterator;
  3764. }
  3765. if (!size) {
  3766. return callback(null, result);
  3767. }
  3768. iterate();
  3769. function arrayIterator() {
  3770. key = completed;
  3771. iterator(collection[completed], done);
  3772. }
  3773. function arrayIteratorWithIndex() {
  3774. key = completed;
  3775. iterator(collection[completed], completed, done);
  3776. }
  3777. function symbolIterator() {
  3778. key = completed;
  3779. item = iter.next();
  3780. item.done ? callback(null, result) : iterator(item.value, done);
  3781. }
  3782. function symbolIteratorWithKey() {
  3783. key = completed;
  3784. item = iter.next();
  3785. item.done ? callback(null, result) : iterator(item.value, completed, done);
  3786. }
  3787. function objectIterator() {
  3788. key = keys[completed];
  3789. iterator(collection[key], done);
  3790. }
  3791. function objectIteratorWithKey() {
  3792. key = keys[completed];
  3793. iterator(collection[key], key, done);
  3794. }
  3795. function done(err, res) {
  3796. if (err) {
  3797. iterate = throwError;
  3798. callback = onlyOnce(callback);
  3799. callback(err, objectClone(result));
  3800. return;
  3801. }
  3802. result[key] = res;
  3803. if (++completed === size) {
  3804. iterate = throwError;
  3805. callback(null, result);
  3806. callback = throwError;
  3807. } else if (sync) {
  3808. nextTick(iterate);
  3809. } else {
  3810. sync = true;
  3811. iterate();
  3812. }
  3813. sync = false;
  3814. }
  3815. }
  3816. /**
  3817. * @memberof async
  3818. * @namespace mapValuesLimit
  3819. * @param {Array|Object} collection
  3820. * @param {number} limit - limit >= 1
  3821. * @param {Function} iterator
  3822. * @param {Function} callback
  3823. * @example
  3824. *
  3825. * // array
  3826. * var order = [];
  3827. * var array = [1, 5, 3, 4, 2];
  3828. * var iterator = function(num, done) {
  3829. * setTimeout(function() {
  3830. * order.push(num);
  3831. * done(null, num);
  3832. * }, num * 10);
  3833. * };
  3834. * async.mapValuesLimit(array, 2, iterator, function(err, res) {
  3835. * console.log(res); // { '0': 1, '1': 5, '2': 3, '3': 4, '4': 2 }
  3836. * console.log(order); // [1, 3, 5, 2, 4]
  3837. * });
  3838. *
  3839. * @example
  3840. *
  3841. * // array with index
  3842. * var order = [];
  3843. * var array = [1, 5, 3, 4, 2];
  3844. * var iterator = function(num, index, done) {
  3845. * setTimeout(function() {
  3846. * order.push([num, index]);
  3847. * done(null, num);
  3848. * }, num * 10);
  3849. * };
  3850. * async.mapValuesLimit(array, 2, iterator, function(err, res) {
  3851. * console.log(res); // { '0': 1, '1': 5, '2': 3, '3': 4, '4': 2 }
  3852. * console.log(order); // [[1, 0], [3, 2], [5, 1], [2, 4], [4, 3]]
  3853. * });
  3854. *
  3855. * @example
  3856. *
  3857. * // object
  3858. * var order = [];
  3859. * var object = { a: 1, b: 5, c: 3, d: 4, e: 2 };
  3860. * var iterator = function(num, done) {
  3861. * setTimeout(function() {
  3862. * order.push(num);
  3863. * done(null, num);
  3864. * }, num * 10);
  3865. * };
  3866. * async.mapValuesLimit(object, 2, iterator, function(err, res) {
  3867. * console.log(res); // { a: 1, b: 5, c: 3, d: 4, e: 2 }
  3868. * console.log(order); // [1, 3, 5, 2, 4]
  3869. * });
  3870. *
  3871. * @example
  3872. *
  3873. * // object with key
  3874. * var order = [];
  3875. * var object = { a: 1, b: 5, c: 3, d: 4, e: 2 };
  3876. * var iterator = function(num, key, done) {
  3877. * setTimeout(function() {
  3878. * order.push([num, key]);
  3879. * done(null, num);
  3880. * }, num * 10);
  3881. * };
  3882. * async.mapValuesLimit(object, 2, iterator, function(err, res) {
  3883. * console.log(res); // { a: 1, b: 5, c: 3, d: 4, e: 2 }
  3884. * console.log(order); // [[1, 'a'], [3, 'c'], [5, 'b'], [2, 'e'], [4, 'd']]
  3885. * });
  3886. *
  3887. */
  3888. function mapValuesLimit(collection, limit, iterator, callback) {
  3889. callback = callback || noop;
  3890. var size, index, key, keys, iter, item, iterate;
  3891. var sync = false;
  3892. var result = {};
  3893. var started = 0;
  3894. var completed = 0;
  3895. if (isArray(collection)) {
  3896. size = collection.length;
  3897. iterate = iterator.length === 3 ? arrayIteratorWithIndex : arrayIterator;
  3898. } else if (!collection) {
  3899. } else if (iteratorSymbol && collection[iteratorSymbol]) {
  3900. size = Infinity;
  3901. iter = collection[iteratorSymbol]();
  3902. iterate = iterator.length === 3 ? symbolIteratorWithKey : symbolIterator;
  3903. } else if (typeof collection === obj) {
  3904. keys = nativeKeys(collection);
  3905. size = keys.length;
  3906. iterate = iterator.length === 3 ? objectIteratorWithKey : objectIterator;
  3907. }
  3908. if (!size || isNaN(limit) || limit < 1) {
  3909. return callback(null, result);
  3910. }
  3911. timesSync(limit > size ? size : limit, iterate);
  3912. function arrayIterator() {
  3913. index = started++;
  3914. if (index < size) {
  3915. iterator(collection[index], createCallback(index));
  3916. }
  3917. }
  3918. function arrayIteratorWithIndex() {
  3919. index = started++;
  3920. if (index < size) {
  3921. iterator(collection[index], index, createCallback(index));
  3922. }
  3923. }
  3924. function symbolIterator() {
  3925. item = iter.next();
  3926. if (item.done === false) {
  3927. iterator(item.value, createCallback(started++));
  3928. } else if (completed >= collection.size && iterator !== noop) {
  3929. iterator = noop;
  3930. callback(null, result);
  3931. }
  3932. }
  3933. function symbolIteratorWithKey() {
  3934. item = iter.next();
  3935. if (item.done === false) {
  3936. iterator(item.value, started, createCallback(started++));
  3937. } else if (completed >= collection.size && iterator !== noop) {
  3938. iterator = noop;
  3939. callback(null, result);
  3940. }
  3941. }
  3942. function objectIterator() {
  3943. index = started++;
  3944. if (index < size) {
  3945. key = keys[index];
  3946. iterator(collection[key], createCallback(key));
  3947. }
  3948. }
  3949. function objectIteratorWithKey() {
  3950. index = started++;
  3951. if (index < size) {
  3952. key = keys[index];
  3953. iterator(collection[key], key, createCallback(key));
  3954. }
  3955. }
  3956. function createCallback(key) {
  3957. return function(err, res) {
  3958. if (key === null) {
  3959. throwError();
  3960. }
  3961. if (err) {
  3962. key = null;
  3963. iterate = noop;
  3964. callback = once(callback);
  3965. callback(err, objectClone(result));
  3966. return;
  3967. }
  3968. result[key] = res;
  3969. key = null;
  3970. if (++completed === size) {
  3971. callback(null, result);
  3972. } else if (sync) {
  3973. nextTick(iterate);
  3974. } else {
  3975. sync = true;
  3976. iterate();
  3977. }
  3978. sync = false;
  3979. };
  3980. }
  3981. }
  3982. /**
  3983. * @private
  3984. * @param {Function} arrayEach
  3985. * @param {Function} baseEach
  3986. * @param {Function} symbolEach
  3987. * @param {boolean} bool
  3988. */
  3989. function createDetect(arrayEach, baseEach, symbolEach, bool) {
  3990. return function(collection, iterator, callback) {
  3991. callback = callback || noop;
  3992. var size, keys;
  3993. var completed = 0;
  3994. if (isArray(collection)) {
  3995. size = collection.length;
  3996. arrayEach(collection, iterator, createCallback);
  3997. } else if (!collection) {
  3998. } else if (iteratorSymbol && collection[iteratorSymbol]) {
  3999. size = symbolEach(collection, iterator, createCallback);
  4000. size && size === completed && callback(null);
  4001. } else if (typeof collection === obj) {
  4002. keys = nativeKeys(collection);
  4003. size = keys.length;
  4004. baseEach(collection, iterator, createCallback, keys);
  4005. }
  4006. if (!size) {
  4007. callback(null);
  4008. }
  4009. function createCallback(value) {
  4010. var called = false;
  4011. return function done(err, res) {
  4012. if (called) {
  4013. throwError();
  4014. }
  4015. called = true;
  4016. if (err) {
  4017. callback = once(callback);
  4018. callback(err);
  4019. } else if (!!res === bool) {
  4020. callback = once(callback);
  4021. callback(null, value);
  4022. } else if (++completed === size) {
  4023. callback(null);
  4024. }
  4025. };
  4026. }
  4027. };
  4028. }
  4029. /**
  4030. * @private
  4031. * @param {boolean} bool
  4032. */
  4033. function createDetectSeries(bool) {
  4034. return function(collection, iterator, callback) {
  4035. callback = onlyOnce(callback || noop);
  4036. var size, key, value, keys, iter, item, iterate;
  4037. var sync = false;
  4038. var completed = 0;
  4039. if (isArray(collection)) {
  4040. size = collection.length;
  4041. iterate = iterator.length === 3 ? arrayIteratorWithIndex : arrayIterator;
  4042. } else if (!collection) {
  4043. } else if (iteratorSymbol && collection[iteratorSymbol]) {
  4044. size = Infinity;
  4045. iter = collection[iteratorSymbol]();
  4046. iterate = iterator.length === 3 ? symbolIteratorWithKey : symbolIterator;
  4047. } else if (typeof collection === obj) {
  4048. keys = nativeKeys(collection);
  4049. size = keys.length;
  4050. iterate = iterator.length === 3 ? objectIteratorWithKey : objectIterator;
  4051. }
  4052. if (!size) {
  4053. return callback(null);
  4054. }
  4055. iterate();
  4056. function arrayIterator() {
  4057. value = collection[completed];
  4058. iterator(value, done);
  4059. }
  4060. function arrayIteratorWithIndex() {
  4061. value = collection[completed];
  4062. iterator(value, completed, done);
  4063. }
  4064. function symbolIterator() {
  4065. item = iter.next();
  4066. value = item.value;
  4067. item.done ? callback(null) : iterator(value, done);
  4068. }
  4069. function symbolIteratorWithKey() {
  4070. item = iter.next();
  4071. value = item.value;
  4072. item.done ? callback(null) : iterator(value, completed, done);
  4073. }
  4074. function objectIterator() {
  4075. value = collection[keys[completed]];
  4076. iterator(value, done);
  4077. }
  4078. function objectIteratorWithKey() {
  4079. key = keys[completed];
  4080. value = collection[key];
  4081. iterator(value, key, done);
  4082. }
  4083. function done(err, res) {
  4084. if (err) {
  4085. callback(err);
  4086. } else if (!!res === bool) {
  4087. iterate = throwError;
  4088. callback(null, value);
  4089. } else if (++completed === size) {
  4090. iterate = throwError;
  4091. callback(null);
  4092. } else if (sync) {
  4093. nextTick(iterate);
  4094. } else {
  4095. sync = true;
  4096. iterate();
  4097. }
  4098. sync = false;
  4099. }
  4100. };
  4101. }
  4102. /**
  4103. * @private
  4104. * @param {boolean} bool
  4105. */
  4106. function createDetectLimit(bool) {
  4107. return function(collection, limit, iterator, callback) {
  4108. callback = callback || noop;
  4109. var size, index, key, value, keys, iter, item, iterate;
  4110. var sync = false;
  4111. var started = 0;
  4112. var completed = 0;
  4113. if (isArray(collection)) {
  4114. size = collection.length;
  4115. iterate = iterator.length === 3 ? arrayIteratorWithIndex : arrayIterator;
  4116. } else if (!collection) {
  4117. } else if (iteratorSymbol && collection[iteratorSymbol]) {
  4118. size = Infinity;
  4119. iter = collection[iteratorSymbol]();
  4120. iterate = iterator.length === 3 ? symbolIteratorWithKey : symbolIterator;
  4121. } else if (typeof collection === obj) {
  4122. keys = nativeKeys(collection);
  4123. size = keys.length;
  4124. iterate = iterator.length === 3 ? objectIteratorWithKey : objectIterator;
  4125. }
  4126. if (!size || isNaN(limit) || limit < 1) {
  4127. return callback(null);
  4128. }
  4129. timesSync(limit > size ? size : limit, iterate);
  4130. function arrayIterator() {
  4131. index = started++;
  4132. if (index < size) {
  4133. value = collection[index];
  4134. iterator(value, createCallback(value));
  4135. }
  4136. }
  4137. function arrayIteratorWithIndex() {
  4138. index = started++;
  4139. if (index < size) {
  4140. value = collection[index];
  4141. iterator(value, index, createCallback(value));
  4142. }
  4143. }
  4144. function symbolIterator() {
  4145. item = iter.next();
  4146. if (item.done === false) {
  4147. value = item.value;
  4148. iterator(value, createCallback(value));
  4149. } else if (completed >= collection.size && iterator !== noop) {
  4150. iterator = noop;
  4151. callback(null);
  4152. }
  4153. }
  4154. function symbolIteratorWithKey() {
  4155. item = iter.next();
  4156. if (item.done === false) {
  4157. value = item.value;
  4158. iterator(value, started++, createCallback(value));
  4159. } else if (completed >= collection.size && iterator !== noop) {
  4160. iterator = noop;
  4161. callback(null);
  4162. }
  4163. }
  4164. function objectIterator() {
  4165. index = started++;
  4166. if (index < size) {
  4167. value = collection[keys[index]];
  4168. iterator(value, createCallback(value));
  4169. }
  4170. }
  4171. function objectIteratorWithKey() {
  4172. if (started < size) {
  4173. key = keys[started++];
  4174. value = collection[key];
  4175. iterator(value, key, createCallback(value));
  4176. }
  4177. }
  4178. function createCallback(value) {
  4179. var called = false;
  4180. return function(err, res) {
  4181. if (called) {
  4182. throwError();
  4183. }
  4184. called = true;
  4185. if (err) {
  4186. iterate = noop;
  4187. callback = once(callback);
  4188. callback(err);
  4189. } else if (!!res === bool) {
  4190. iterate = noop;
  4191. callback = once(callback);
  4192. callback(null, value);
  4193. } else if (++completed === size) {
  4194. callback(null);
  4195. } else if (sync) {
  4196. nextTick(iterate);
  4197. } else {
  4198. sync = true;
  4199. iterate();
  4200. }
  4201. sync = false;
  4202. };
  4203. }
  4204. };
  4205. }
  4206. /**
  4207. * @private
  4208. * @param {Function} arrayEach
  4209. * @param {Function} baseEach
  4210. * @param {Function} symbolEach
  4211. * @param {boolean} bool
  4212. */
  4213. function createPick(arrayEach, baseEach, symbolEach, bool) {
  4214. return function(collection, iterator, callback) {
  4215. callback = callback || noop;
  4216. var size, keys;
  4217. var completed = 0;
  4218. var result = {};
  4219. if (isArray(collection)) {
  4220. size = collection.length;
  4221. arrayEach(collection, iterator, createCallback);
  4222. } else if (!collection) {
  4223. } else if (iteratorSymbol && collection[iteratorSymbol]) {
  4224. size = symbolEach(collection, iterator, createCallback);
  4225. size && size === completed && callback(null, result);
  4226. } else if (typeof collection === obj) {
  4227. keys = nativeKeys(collection);
  4228. size = keys.length;
  4229. baseEach(collection, iterator, createCallback, keys);
  4230. }
  4231. if (!size) {
  4232. return callback(null, {});
  4233. }
  4234. function createCallback(key, value) {
  4235. return function done(err, res) {
  4236. if (key === null) {
  4237. throwError();
  4238. }
  4239. if (err) {
  4240. key = null;
  4241. callback = once(callback);
  4242. callback(err, objectClone(result));
  4243. return;
  4244. }
  4245. if (!!res === bool) {
  4246. result[key] = value;
  4247. }
  4248. key = null;
  4249. if (++completed === size) {
  4250. callback(null, result);
  4251. }
  4252. };
  4253. }
  4254. };
  4255. }
  4256. /**
  4257. * @private
  4258. * @param {boolean} bool
  4259. */
  4260. function createPickSeries(bool) {
  4261. return function(collection, iterator, callback) {
  4262. callback = onlyOnce(callback || noop);
  4263. var size, key, value, keys, iter, item, iterate;
  4264. var sync = false;
  4265. var result = {};
  4266. var completed = 0;
  4267. if (isArray(collection)) {
  4268. size = collection.length;
  4269. iterate = iterator.length === 3 ? arrayIteratorWithIndex : arrayIterator;
  4270. } else if (!collection) {
  4271. } else if (iteratorSymbol && collection[iteratorSymbol]) {
  4272. size = Infinity;
  4273. iter = collection[iteratorSymbol]();
  4274. iterate = iterator.length === 3 ? symbolIteratorWithKey : symbolIterator;
  4275. } else if (typeof collection === obj) {
  4276. keys = nativeKeys(collection);
  4277. size = keys.length;
  4278. iterate = iterator.length === 3 ? objectIteratorWithKey : objectIterator;
  4279. }
  4280. if (!size) {
  4281. return callback(null, {});
  4282. }
  4283. iterate();
  4284. function arrayIterator() {
  4285. key = completed;
  4286. value = collection[completed];
  4287. iterator(value, done);
  4288. }
  4289. function arrayIteratorWithIndex() {
  4290. key = completed;
  4291. value = collection[completed];
  4292. iterator(value, completed, done);
  4293. }
  4294. function symbolIterator() {
  4295. key = completed;
  4296. item = iter.next();
  4297. value = item.value;
  4298. item.done ? callback(null, result) : iterator(value, done);
  4299. }
  4300. function symbolIteratorWithKey() {
  4301. key = completed;
  4302. item = iter.next();
  4303. value = item.value;
  4304. item.done ? callback(null, result) : iterator(value, key, done);
  4305. }
  4306. function objectIterator() {
  4307. key = keys[completed];
  4308. value = collection[key];
  4309. iterator(value, done);
  4310. }
  4311. function objectIteratorWithKey() {
  4312. key = keys[completed];
  4313. value = collection[key];
  4314. iterator(value, key, done);
  4315. }
  4316. function done(err, res) {
  4317. if (err) {
  4318. callback(err, result);
  4319. return;
  4320. }
  4321. if (!!res === bool) {
  4322. result[key] = value;
  4323. }
  4324. if (++completed === size) {
  4325. iterate = throwError;
  4326. callback(null, result);
  4327. } else if (sync) {
  4328. nextTick(iterate);
  4329. } else {
  4330. sync = true;
  4331. iterate();
  4332. }
  4333. sync = false;
  4334. }
  4335. };
  4336. }
  4337. /**
  4338. * @private
  4339. * @param {boolean} bool
  4340. */
  4341. function createPickLimit(bool) {
  4342. return function(collection, limit, iterator, callback) {
  4343. callback = callback || noop;
  4344. var size, index, key, value, keys, iter, item, iterate;
  4345. var sync = false;
  4346. var result = {};
  4347. var started = 0;
  4348. var completed = 0;
  4349. if (isArray(collection)) {
  4350. size = collection.length;
  4351. iterate = iterator.length === 3 ? arrayIteratorWithIndex : arrayIterator;
  4352. } else if (!collection) {
  4353. } else if (iteratorSymbol && collection[iteratorSymbol]) {
  4354. size = Infinity;
  4355. iter = collection[iteratorSymbol]();
  4356. iterate = iterator.length === 3 ? symbolIteratorWithKey : symbolIterator;
  4357. } else if (typeof collection === obj) {
  4358. keys = nativeKeys(collection);
  4359. size = keys.length;
  4360. iterate = iterator.length === 3 ? objectIteratorWithKey : objectIterator;
  4361. }
  4362. if (!size || isNaN(limit) || limit < 1) {
  4363. return callback(null, {});
  4364. }
  4365. timesSync(limit > size ? size : limit, iterate);
  4366. function arrayIterator() {
  4367. index = started++;
  4368. if (index < size) {
  4369. value = collection[index];
  4370. iterator(value, createCallback(value, index));
  4371. }
  4372. }
  4373. function arrayIteratorWithIndex() {
  4374. index = started++;
  4375. if (index < size) {
  4376. value = collection[index];
  4377. iterator(value, index, createCallback(value, index));
  4378. }
  4379. }
  4380. function symbolIterator() {
  4381. item = iter.next();
  4382. if (item.done === false) {
  4383. value = item.value;
  4384. iterator(value, createCallback(value, started++));
  4385. } else if (completed >= collection.size && iterator !== noop) {
  4386. iterator = noop;
  4387. callback(null, result);
  4388. }
  4389. }
  4390. function symbolIteratorWithKey() {
  4391. item = iter.next();
  4392. if (item.done === false) {
  4393. value = item.value;
  4394. iterator(value, started, createCallback(value, started++));
  4395. } else if (completed >= collection.size && iterator !== noop) {
  4396. iterator = noop;
  4397. callback(null, result);
  4398. }
  4399. }
  4400. function objectIterator() {
  4401. if (started < size) {
  4402. key = keys[started++];
  4403. value = collection[key];
  4404. iterator(value, createCallback(value, key));
  4405. }
  4406. }
  4407. function objectIteratorWithKey() {
  4408. if (started < size) {
  4409. key = keys[started++];
  4410. value = collection[key];
  4411. iterator(value, key, createCallback(value, key));
  4412. }
  4413. }
  4414. function createCallback(value, key) {
  4415. return function(err, res) {
  4416. if (key === null) {
  4417. throwError();
  4418. }
  4419. if (err) {
  4420. key = null;
  4421. iterate = noop;
  4422. callback = once(callback);
  4423. callback(err, objectClone(result));
  4424. return;
  4425. }
  4426. if (!!res === bool) {
  4427. result[key] = value;
  4428. }
  4429. key = null;
  4430. if (++completed === size) {
  4431. iterate = throwError;
  4432. callback = onlyOnce(callback);
  4433. callback(null, result);
  4434. } else if (sync) {
  4435. nextTick(iterate);
  4436. } else {
  4437. sync = true;
  4438. iterate();
  4439. }
  4440. sync = false;
  4441. };
  4442. }
  4443. };
  4444. }
  4445. /**
  4446. * @memberof async
  4447. * @namespace reduce
  4448. * @param {Array|Object} collection
  4449. * @param {*} result
  4450. * @param {Function} iterator
  4451. * @param {Function} callback
  4452. * @example
  4453. *
  4454. * // array
  4455. * var order = [];
  4456. * var collection = [1, 3, 2, 4];
  4457. * var iterator = function(result, num, done) {
  4458. * setTimeout(function() {
  4459. * order.push(num);
  4460. * done(null, result + num);
  4461. * }, num * 10);
  4462. * };
  4463. * async.reduce(collection, 0, iterator, function(err, res) {
  4464. * console.log(res); // 10
  4465. * console.log(order); // [1, 3, 2, 4]
  4466. * });
  4467. *
  4468. * @example
  4469. *
  4470. * // array with index
  4471. * var order = [];
  4472. * var collection = [1, 3, 2, 4];
  4473. * var iterator = function(result, num, index, done) {
  4474. * setTimeout(function() {
  4475. * order.push([num, index]);
  4476. * done(null, result + num);
  4477. * }, num * 10);
  4478. * };
  4479. * async.reduce(collection, '', iterator, function(err, res) {
  4480. * console.log(res); // '1324'
  4481. * console.log(order); // [[1, 0], [3, 1], [2, 2], [4, 3]]
  4482. * });
  4483. *
  4484. * @example
  4485. *
  4486. * // object
  4487. * var order = [];
  4488. * var object = { a: 1, b: 3, c: 2, d: 4 };
  4489. * var iterator = function(result, num, done) {
  4490. * setTimeout(function() {
  4491. * order.push(num);
  4492. * done(null, result + num);
  4493. * }, num * 10);
  4494. * };
  4495. * async.reduce(collection, '', iterator, function(err, res) {
  4496. * console.log(res); // '1324'
  4497. * console.log(order); // [1, 3, 2, 4]
  4498. * });
  4499. *
  4500. * @example
  4501. *
  4502. * // object with key
  4503. * var order = [];
  4504. * var object = { a: 1, b: 3, c: 2, d: 4 };
  4505. * var iterator = function(result, num, key, done) {
  4506. * setTimeout(function() {
  4507. * order.push([num, key]);
  4508. * done(null, result + num);
  4509. * }, num * 10);
  4510. * };
  4511. * async.reduce(collection, 0, iterator, function(err, res) {
  4512. * console.log(res); // 10
  4513. * console.log(order); // [[1, 'a'], [3, 'b'], [2, 'b'], [4, 'd']]
  4514. * });
  4515. *
  4516. */
  4517. function reduce(collection, result, iterator, callback) {
  4518. callback = onlyOnce(callback || noop);
  4519. var size, key, keys, iter, iterate;
  4520. var sync = false;
  4521. var completed = 0;
  4522. if (isArray(collection)) {
  4523. size = collection.length;
  4524. iterate = iterator.length === 4 ? arrayIteratorWithIndex : arrayIterator;
  4525. } else if (!collection) {
  4526. } else if (iteratorSymbol && collection[iteratorSymbol]) {
  4527. size = collection.size;
  4528. iter = collection[iteratorSymbol]();
  4529. iterate = iterator.length === 4 ? symbolIteratorWithKey : symbolIterator;
  4530. } else if (typeof collection === obj) {
  4531. keys = nativeKeys(collection);
  4532. size = keys.length;
  4533. iterate = iterator.length === 4 ? objectIteratorWithKey : objectIterator;
  4534. }
  4535. if (!size) {
  4536. return callback(null, result);
  4537. }
  4538. iterate(result);
  4539. function arrayIterator(result) {
  4540. iterator(result, collection[completed], done);
  4541. }
  4542. function arrayIteratorWithIndex(result) {
  4543. iterator(result, collection[completed], completed, done);
  4544. }
  4545. function symbolIterator() {
  4546. iterator(result, iter.next().value, done);
  4547. }
  4548. function symbolIteratorWithKey() {
  4549. iterator(result, iter.next().value, completed, done);
  4550. }
  4551. function objectIterator(result) {
  4552. iterator(result, collection[keys[completed]], done);
  4553. }
  4554. function objectIteratorWithKey(result) {
  4555. key = keys[completed];
  4556. iterator(result, collection[key], key, done);
  4557. }
  4558. function done(err, result) {
  4559. if (err) {
  4560. callback(err, result);
  4561. } else if (++completed === size) {
  4562. iterator = throwError;
  4563. callback(null, result);
  4564. } else if (sync) {
  4565. nextTick(function() {
  4566. iterate(result);
  4567. });
  4568. } else {
  4569. sync = true;
  4570. iterate(result);
  4571. }
  4572. sync = false;
  4573. }
  4574. }
  4575. /**
  4576. * @memberof async
  4577. * @namespace reduceRight
  4578. * @param {Array|Object} collection
  4579. * @param {*} result
  4580. * @param {Function} iterator
  4581. * @param {Function} callback
  4582. * @example
  4583. *
  4584. * // array
  4585. * var order = [];
  4586. * var collection = [1, 3, 2, 4];
  4587. * var iterator = function(result, num, done) {
  4588. * setTimeout(function() {
  4589. * order.push(num);
  4590. * done(null, result + num);
  4591. * }, num * 10);
  4592. * };
  4593. * async.reduceRight(collection, 0, iterator, function(err, res) {
  4594. * console.log(res); // 10
  4595. * console.log(order); // [4, 2, 3, 1]
  4596. * });
  4597. *
  4598. * @example
  4599. *
  4600. * // array with index
  4601. * var order = [];
  4602. * var collection = [1, 3, 2, 4];
  4603. * var iterator = function(result, num, index, done) {
  4604. * setTimeout(function() {
  4605. * order.push([num, index]);
  4606. * done(null, result + num);
  4607. * }, num * 10);
  4608. * };
  4609. * async.reduceRight(collection, '', iterator, function(err, res) {
  4610. * console.log(res); // '4231'
  4611. * console.log(order); // [[4, 3], [2, 2], [3, 1], [1, 0]]
  4612. * });
  4613. *
  4614. * @example
  4615. *
  4616. * // object
  4617. * var order = [];
  4618. * var object = { a: 1, b: 3, c: 2, d: 4 };
  4619. * var iterator = function(result, num, done) {
  4620. * setTimeout(function() {
  4621. * order.push(num);
  4622. * done(null, result + num);
  4623. * }, num * 10);
  4624. * };
  4625. * async.reduceRight(collection, '', iterator, function(err, res) {
  4626. * console.log(res); // '4231'
  4627. * console.log(order); // [4, 2, 3, 1]
  4628. * });
  4629. *
  4630. * @example
  4631. *
  4632. * // object with key
  4633. * var order = [];
  4634. * var object = { a: 1, b: 3, c: 2, d: 4 };
  4635. * var iterator = function(result, num, key, done) {
  4636. * setTimeout(function() {
  4637. * order.push([num, key]);
  4638. * done(null, result + num);
  4639. * }, num * 10);
  4640. * };
  4641. * async.reduceRight(collection, 0, iterator, function(err, res) {
  4642. * console.log(res); // 10
  4643. * console.log(order); // [[4, 3], [2, 2], [3, 1], [1, 0]]
  4644. * });
  4645. *
  4646. */
  4647. function reduceRight(collection, result, iterator, callback) {
  4648. callback = onlyOnce(callback || noop);
  4649. var resIndex, index, key, keys, iter, item, col, iterate;
  4650. var sync = false;
  4651. if (isArray(collection)) {
  4652. resIndex = collection.length;
  4653. iterate = iterator.length === 4 ? arrayIteratorWithIndex : arrayIterator;
  4654. } else if (!collection) {
  4655. } else if (iteratorSymbol && collection[iteratorSymbol]) {
  4656. resIndex = collection.size;
  4657. col = Array(resIndex);
  4658. iter = collection[iteratorSymbol]();
  4659. index = -1;
  4660. while ((item = iter.next()).done === false) {
  4661. col[++index] = item.value;
  4662. }
  4663. collection = col;
  4664. iterate = iterator.length === 4 ? arrayIteratorWithIndex : arrayIterator;
  4665. } else if (typeof collection === obj) {
  4666. keys = nativeKeys(collection);
  4667. resIndex = keys.length;
  4668. iterate = iterator.length === 4 ? objectIteratorWithKey : objectIterator;
  4669. }
  4670. if (!resIndex) {
  4671. return callback(null, result);
  4672. }
  4673. iterate(result);
  4674. function arrayIterator(result) {
  4675. iterator(result, collection[--resIndex], done);
  4676. }
  4677. function arrayIteratorWithIndex(result) {
  4678. iterator(result, collection[--resIndex], resIndex, done);
  4679. }
  4680. function objectIterator(result) {
  4681. iterator(result, collection[keys[--resIndex]], done);
  4682. }
  4683. function objectIteratorWithKey(result) {
  4684. key = keys[--resIndex];
  4685. iterator(result, collection[key], key, done);
  4686. }
  4687. function done(err, result) {
  4688. if (err) {
  4689. callback(err, result);
  4690. } else if (resIndex === 0) {
  4691. iterate = throwError;
  4692. callback(null, result);
  4693. } else if (sync) {
  4694. nextTick(function() {
  4695. iterate(result);
  4696. });
  4697. } else {
  4698. sync = true;
  4699. iterate(result);
  4700. }
  4701. sync = false;
  4702. }
  4703. }
  4704. /**
  4705. * @private
  4706. * @param {Function} arrayEach
  4707. * @param {Function} baseEach
  4708. * @param {Function} symbolEach
  4709. */
  4710. function createTransform(arrayEach, baseEach, symbolEach) {
  4711. return function transform(collection, accumulator, iterator, callback) {
  4712. if (arguments.length === 3) {
  4713. callback = iterator;
  4714. iterator = accumulator;
  4715. accumulator = undefined;
  4716. }
  4717. callback = callback || noop;
  4718. var size, keys, result;
  4719. var completed = 0;
  4720. if (isArray(collection)) {
  4721. size = collection.length;
  4722. result = accumulator !== undefined ? accumulator : [];
  4723. arrayEach(collection, result, iterator, done);
  4724. } else if (!collection) {
  4725. } else if (iteratorSymbol && collection[iteratorSymbol]) {
  4726. result = accumulator !== undefined ? accumulator : {};
  4727. size = symbolEach(collection, result, iterator, done);
  4728. size && size === completed && callback(null, result);
  4729. } else if (typeof collection === obj) {
  4730. keys = nativeKeys(collection);
  4731. size = keys.length;
  4732. result = accumulator !== undefined ? accumulator : {};
  4733. baseEach(collection, result, iterator, done, keys);
  4734. }
  4735. if (!size) {
  4736. callback(null, accumulator !== undefined ? accumulator : result || {});
  4737. }
  4738. function done(err, bool) {
  4739. if (err) {
  4740. callback = once(callback);
  4741. callback(err, isArray(result) ? createArray(result) : objectClone(result));
  4742. } else if (++completed === size) {
  4743. callback(null, result);
  4744. } else if (bool === false) {
  4745. callback = once(callback);
  4746. callback(null, isArray(result) ? createArray(result) : objectClone(result));
  4747. }
  4748. }
  4749. };
  4750. }
  4751. /**
  4752. * @memberof async
  4753. * @namespace transformSeries
  4754. * @param {Array|Object} collection
  4755. * @param {Array|Object|Function} [accumulator]
  4756. * @param {Function} [iterator]
  4757. * @param {Function} [callback]
  4758. * @example
  4759. *
  4760. * // array
  4761. * var order = [];
  4762. * var collection = [1, 3, 2, 4];
  4763. * var iterator = function(result, num, done) {
  4764. * setTimeout(function() {
  4765. * order.push(num);
  4766. * result.push(num)
  4767. * done();
  4768. * }, num * 10);
  4769. * };
  4770. * async.transformSeries(collection, iterator, function(err, res) {
  4771. * console.log(res); // [1, 3, 2, 4]
  4772. * console.log(order); // [1, 3, 2, 4]
  4773. * });
  4774. *
  4775. * @example
  4776. *
  4777. * // array with index and accumulator
  4778. * var order = [];
  4779. * var collection = [1, 3, 2, 4];
  4780. * var iterator = function(result, num, index, done) {
  4781. * setTimeout(function() {
  4782. * order.push([num, index]);
  4783. * result[index] = num;
  4784. * done();
  4785. * }, num * 10);
  4786. * };
  4787. * async.transformSeries(collection, {}, iterator, function(err, res) {
  4788. * console.log(res); // { '0': 1, '1': 3, '2': 2, '3': 4 }
  4789. * console.log(order); // [[1, 0], [3, 1], [2, 2], [4, 3]]
  4790. * });
  4791. *
  4792. * @example
  4793. *
  4794. * // object with accumulator
  4795. * var order = [];
  4796. * var object = { a: 1, b: 3, c: 2, d: 4 };
  4797. * var iterator = function(result, num, done) {
  4798. * setTimeout(function() {
  4799. * order.push(num);
  4800. * result.push(num);
  4801. * done();
  4802. * }, num * 10);
  4803. * };
  4804. * async.transformSeries(collection, [], iterator, function(err, res) {
  4805. * console.log(res); // [1, 3, 2, 4]
  4806. * console.log(order); // [1, 3, 2, 4]
  4807. * });
  4808. *
  4809. * @example
  4810. *
  4811. * // object with key
  4812. * var order = [];
  4813. * var object = { a: 1, b: 3, c: 2, d: 4 };
  4814. * var iterator = function(result, num, key, done) {
  4815. * setTimeout(function() {
  4816. * order.push([num, key]);
  4817. * result[key] = num;
  4818. * done();
  4819. * }, num * 10);
  4820. * };
  4821. * async.transformSeries(collection, iterator, function(err, res) {
  4822. * console.log(res); // { a: 1, b: 3, c: 2, d: 4 }
  4823. * console.log(order); // [[1, 'a'], [3, 'b'], [2, 'b'], [4, 'd']]
  4824. * });
  4825. *
  4826. */
  4827. function transformSeries(collection, accumulator, iterator, callback) {
  4828. if (arguments.length === 3) {
  4829. callback = iterator;
  4830. iterator = accumulator;
  4831. accumulator = undefined;
  4832. }
  4833. callback = onlyOnce(callback || noop);
  4834. var size, key, keys, iter, item, iterate, result;
  4835. var sync = false;
  4836. var completed = 0;
  4837. if (isArray(collection)) {
  4838. size = collection.length;
  4839. result = accumulator !== undefined ? accumulator : [];
  4840. iterate = iterator.length === 4 ? arrayIteratorWithIndex : arrayIterator;
  4841. } else if (!collection) {
  4842. } else if (iteratorSymbol && collection[iteratorSymbol]) {
  4843. size = collection.size;
  4844. iter = collection[iteratorSymbol]();
  4845. result = accumulator !== undefined ? accumulator : {};
  4846. iterate = iterator.length === 4 ? symbolIteratorWithKey : symbolIterator;
  4847. } else if (typeof collection === obj) {
  4848. keys = nativeKeys(collection);
  4849. size = keys.length;
  4850. result = accumulator !== undefined ? accumulator : {};
  4851. iterate = iterator.length === 4 ? objectIteratorWithKey : objectIterator;
  4852. }
  4853. if (!size) {
  4854. return callback(null, accumulator !== undefined ? accumulator : result || {});
  4855. }
  4856. iterate();
  4857. function arrayIterator() {
  4858. iterator(result, collection[completed], done);
  4859. }
  4860. function arrayIteratorWithIndex() {
  4861. iterator(result, collection[completed], completed, done);
  4862. }
  4863. function symbolIterator() {
  4864. item = iter.next();
  4865. item.done ? callback(null, result) : iterator(result, item.value, done);
  4866. }
  4867. function symbolIteratorWithKey() {
  4868. item = iter.next();
  4869. item.done ? callback(null, result) : iterator(result, item.value, completed, done);
  4870. }
  4871. function objectIterator() {
  4872. iterator(result, collection[keys[completed]], done);
  4873. }
  4874. function objectIteratorWithKey() {
  4875. key = keys[completed];
  4876. iterator(result, collection[key], key, done);
  4877. }
  4878. function done(err, bool) {
  4879. if (err) {
  4880. callback(err, result);
  4881. } else if (++completed === size || bool === false) {
  4882. iterate = throwError;
  4883. callback(null, result);
  4884. } else if (sync) {
  4885. nextTick(iterate);
  4886. } else {
  4887. sync = true;
  4888. iterate();
  4889. }
  4890. sync = false;
  4891. }
  4892. }
  4893. /**
  4894. * @memberof async
  4895. * @namespace transformLimit
  4896. * @param {Array|Object} collection
  4897. * @param {number} limit - limit >= 1
  4898. * @param {Array|Object|Function} [accumulator]
  4899. * @param {Function} [iterator]
  4900. * @param {Function} [callback]
  4901. * @example
  4902. *
  4903. * // array
  4904. * var order = [];
  4905. * var array = [1, 5, 3, 4, 2];
  4906. * var iterator = function(result, num, done) {
  4907. * setTimeout(function() {
  4908. * order.push(num);
  4909. * result.push(num);
  4910. * done();
  4911. * }, num * 10);
  4912. * };
  4913. * async.transformLimit(array, 2, iterator, function(err, res) {
  4914. * console.log(res); // [1, 3, 5, 2, 4]
  4915. * console.log(order); // [1, 3, 5, 2, 4]
  4916. * });
  4917. *
  4918. * @example
  4919. *
  4920. * // array with index and accumulator
  4921. * var order = [];
  4922. * var array = [1, 5, 3, 4, 2];
  4923. * var iterator = function(result, num, index, done) {
  4924. * setTimeout(function() {
  4925. * order.push([num, index]);
  4926. * result[index] = key;
  4927. * done();
  4928. * }, num * 10);
  4929. * };
  4930. * async.transformLimit(array, 2, {}, iterator, function(err, res) {
  4931. * console.log(res); // { '0': 1, '1': 5, '2': 3, '3': 4, '4': 2 }
  4932. * console.log(order); // [[1, 0], [3, 2], [5, 1], [2, 4], [4, 3]]
  4933. * });
  4934. *
  4935. * @example
  4936. *
  4937. * // object with accumulator
  4938. * var order = [];
  4939. * var object = { a: 1, b: 5, c: 3, d: 4, e: 2 };
  4940. * var iterator = function(result, num, done) {
  4941. * setTimeout(function() {
  4942. * order.push(num);
  4943. * result.push(num);
  4944. * done();
  4945. * }, num * 10);
  4946. * };
  4947. * async.transformLimit(object, 2, [], iterator, function(err, res) {
  4948. * console.log(res); // [1, 3, 5, 2, 4]
  4949. * console.log(order); // [1, 3, 5, 2, 4]
  4950. * });
  4951. *
  4952. * @example
  4953. *
  4954. * // object with key
  4955. * var order = [];
  4956. * var object = { a: 1, b: 5, c: 3, d: 4, e: 2 };
  4957. * var iterator = function(result, num, key, done) {
  4958. * setTimeout(function() {
  4959. * order.push([num, key]);
  4960. * result[key] = num;
  4961. * done();
  4962. * }, num * 10);
  4963. * };
  4964. * async.transformLimit(object, 2, iterator, function(err, res) {
  4965. * console.log(res); // { a: 1, b: 5, c: 3, d: 4, e: 2 };
  4966. * console.log(order); // [[1, 'a'], [3, 'c'], [5, 'b'], [2, 'e'], [4, 'd']]
  4967. * });
  4968. *
  4969. */
  4970. function transformLimit(collection, limit, accumulator, iterator, callback) {
  4971. if (arguments.length === 4) {
  4972. callback = iterator;
  4973. iterator = accumulator;
  4974. accumulator = undefined;
  4975. }
  4976. callback = callback || noop;
  4977. var size, index, key, keys, iter, item, iterate, result;
  4978. var sync = false;
  4979. var started = 0;
  4980. var completed = 0;
  4981. if (isArray(collection)) {
  4982. size = collection.length;
  4983. result = accumulator !== undefined ? accumulator : [];
  4984. iterate = iterator.length === 4 ? arrayIteratorWithIndex : arrayIterator;
  4985. } else if (!collection) {
  4986. } else if (iteratorSymbol && collection[iteratorSymbol]) {
  4987. size = Infinity;
  4988. iter = collection[iteratorSymbol]();
  4989. result = accumulator !== undefined ? accumulator : {};
  4990. iterate = iterator.length === 4 ? symbolIteratorWithKey : symbolIterator;
  4991. } else if (typeof collection === obj) {
  4992. keys = nativeKeys(collection);
  4993. size = keys.length;
  4994. result = accumulator !== undefined ? accumulator : {};
  4995. iterate = iterator.length === 4 ? objectIteratorWithKey : objectIterator;
  4996. }
  4997. if (!size || isNaN(limit) || limit < 1) {
  4998. return callback(null, accumulator !== undefined ? accumulator : result || {});
  4999. }
  5000. timesSync(limit > size ? size : limit, iterate);
  5001. function arrayIterator() {
  5002. index = started++;
  5003. if (index < size) {
  5004. iterator(result, collection[index], onlyOnce(done));
  5005. }
  5006. }
  5007. function arrayIteratorWithIndex() {
  5008. index = started++;
  5009. if (index < size) {
  5010. iterator(result, collection[index], index, onlyOnce(done));
  5011. }
  5012. }
  5013. function symbolIterator() {
  5014. item = iter.next();
  5015. if (item.done === false) {
  5016. iterator(result, item.value, onlyOnce(done));
  5017. } else if (completed >= collection.size && iterator !== noop) {
  5018. iterator = noop;
  5019. callback(null, result);
  5020. }
  5021. }
  5022. function symbolIteratorWithKey() {
  5023. item = iter.next();
  5024. if (item.done === false) {
  5025. iterator(result, item.value, started++, onlyOnce(done));
  5026. } else if (completed >= collection.size && iterator !== noop) {
  5027. iterator = noop;
  5028. callback(null, result);
  5029. }
  5030. }
  5031. function objectIterator() {
  5032. index = started++;
  5033. if (index < size) {
  5034. iterator(result, collection[keys[index]], onlyOnce(done));
  5035. }
  5036. }
  5037. function objectIteratorWithKey() {
  5038. index = started++;
  5039. if (index < size) {
  5040. key = keys[index];
  5041. iterator(result, collection[key], key, onlyOnce(done));
  5042. }
  5043. }
  5044. function done(err, bool) {
  5045. if (err || bool === false) {
  5046. iterate = noop;
  5047. callback(err || null, isArray(result) ? createArray(result) : objectClone(result));
  5048. callback = noop;
  5049. } else if (++completed === size) {
  5050. iterator = noop;
  5051. callback(null, result);
  5052. } else if (sync) {
  5053. nextTick(iterate);
  5054. } else {
  5055. sync = true;
  5056. iterate();
  5057. }
  5058. sync = false;
  5059. }
  5060. }
  5061. /**
  5062. * @private
  5063. * @param {function} arrayEach
  5064. * @param {function} baseEach
  5065. * @param {function} symbolEach
  5066. */
  5067. function createSortBy(arrayEach, baseEach, symbolEach) {
  5068. return function sortBy(collection, iterator, callback) {
  5069. callback = callback || noop;
  5070. var size, array, criteria;
  5071. var completed = 0;
  5072. if (isArray(collection)) {
  5073. size = collection.length;
  5074. array = Array(size);
  5075. criteria = Array(size);
  5076. arrayEach(collection, iterator, createCallback);
  5077. } else if (!collection) {
  5078. } else if (iteratorSymbol && collection[iteratorSymbol]) {
  5079. array = [];
  5080. criteria = [];
  5081. size = symbolEach(collection, iterator, createCallback);
  5082. size && size === completed && callback(null, sortByCriteria(array, criteria));
  5083. } else if (typeof collection === obj) {
  5084. var keys = nativeKeys(collection);
  5085. size = keys.length;
  5086. array = Array(size);
  5087. criteria = Array(size);
  5088. baseEach(collection, iterator, createCallback, keys);
  5089. }
  5090. if (!size) {
  5091. callback(null, []);
  5092. }
  5093. function createCallback(index, value) {
  5094. var called = false;
  5095. array[index] = value;
  5096. return function done(err, criterion) {
  5097. if (called) {
  5098. throwError();
  5099. }
  5100. called = true;
  5101. criteria[index] = criterion;
  5102. if (err) {
  5103. callback = once(callback);
  5104. callback(err);
  5105. } else if (++completed === size) {
  5106. callback(null, sortByCriteria(array, criteria));
  5107. }
  5108. };
  5109. }
  5110. };
  5111. }
  5112. /**
  5113. * @memberof async
  5114. * @namespace sortBySeries
  5115. * @param {Array|Object} collection
  5116. * @param {Function} iterator
  5117. * @param {Function} callback
  5118. * @example
  5119. *
  5120. * // array
  5121. * var order = [];
  5122. * var array = [1, 3, 2];
  5123. * var iterator = function(num, done) {
  5124. * setTimeout(function() {
  5125. * order.push(num);
  5126. * done(null, num);
  5127. * }, num * 10);
  5128. * };
  5129. * async.sortBySeries(array, iterator, function(err, res) {
  5130. * console.log(res); // [1, 2, 3];
  5131. * console.log(order); // [1, 3, 2]
  5132. * });
  5133. *
  5134. * @example
  5135. *
  5136. * // array with index
  5137. * var order = [];
  5138. * var array = [1, 3, 2];
  5139. * var iterator = function(num, index, done) {
  5140. * setTimeout(function() {
  5141. * order.push([num, index]);
  5142. * done(null, num);
  5143. * }, num * 10);
  5144. * };
  5145. * async.sortBySeries(array, iterator, function(err, res) {
  5146. * console.log(res); // [1, 2, 3]
  5147. * console.log(order); // [[1, 0], [3, 1], [2, 2]]
  5148. * });
  5149. *
  5150. * @example
  5151. *
  5152. * // object
  5153. * var order = [];
  5154. * var object = { a: 1, b: 3, c: 2 };
  5155. * var iterator = function(num, done) {
  5156. * setTimeout(function() {
  5157. * order.push(num);
  5158. * done(null, num);
  5159. * }, num * 10);
  5160. * };
  5161. * async.sortBySeries(object, iterator, function(err, res) {
  5162. * console.log(res); // [1, 2, 3]
  5163. * console.log(order); // [1, 3, 2]
  5164. * });
  5165. *
  5166. * @example
  5167. *
  5168. * // object with key
  5169. * var order = [];
  5170. * var object = { a: 1, b: 3, c: 2 };
  5171. * var iterator = function(num, key, done) {
  5172. * setTimeout(function() {
  5173. * order.push([num, key]);
  5174. * done(null, num);
  5175. * }, num * 10);
  5176. * };
  5177. * async.sortBySeries(object, iterator, function(err, res) {
  5178. * console.log(res); // [1, 2, 3]
  5179. * console.log(order); // [[1, 'a'], [3, 'b'], [2, 'c']]
  5180. * });
  5181. *
  5182. */
  5183. function sortBySeries(collection, iterator, callback) {
  5184. callback = onlyOnce(callback || noop);
  5185. var size, key, value, keys, iter, item, array, criteria, iterate;
  5186. var sync = false;
  5187. var completed = 0;
  5188. if (isArray(collection)) {
  5189. size = collection.length;
  5190. array = collection;
  5191. criteria = Array(size);
  5192. iterate = iterator.length === 3 ? arrayIteratorWithIndex : arrayIterator;
  5193. } else if (!collection) {
  5194. } else if (iteratorSymbol && collection[iteratorSymbol]) {
  5195. size = Infinity;
  5196. array = [];
  5197. criteria = [];
  5198. iter = collection[iteratorSymbol]();
  5199. iterate = iterator.length === 3 ? symbolIteratorWithKey : symbolIterator;
  5200. } else if (typeof collection === obj) {
  5201. keys = nativeKeys(collection);
  5202. size = keys.length;
  5203. array = Array(size);
  5204. criteria = Array(size);
  5205. iterate = iterator.length === 3 ? objectIteratorWithKey : objectIterator;
  5206. }
  5207. if (!size) {
  5208. return callback(null, []);
  5209. }
  5210. iterate();
  5211. function arrayIterator() {
  5212. value = collection[completed];
  5213. iterator(value, done);
  5214. }
  5215. function arrayIteratorWithIndex() {
  5216. value = collection[completed];
  5217. iterator(value, completed, done);
  5218. }
  5219. function symbolIterator() {
  5220. item = iter.next();
  5221. if (item.done) {
  5222. return callback(null, sortByCriteria(array, criteria));
  5223. }
  5224. value = item.value;
  5225. array[completed] = value;
  5226. iterator(value, done);
  5227. }
  5228. function symbolIteratorWithKey() {
  5229. item = iter.next();
  5230. if (item.done) {
  5231. return callback(null, sortByCriteria(array, criteria));
  5232. }
  5233. value = item.value;
  5234. array[completed] = value;
  5235. iterator(value, completed, done);
  5236. }
  5237. function objectIterator() {
  5238. value = collection[keys[completed]];
  5239. array[completed] = value;
  5240. iterator(value, done);
  5241. }
  5242. function objectIteratorWithKey() {
  5243. key = keys[completed];
  5244. value = collection[key];
  5245. array[completed] = value;
  5246. iterator(value, key, done);
  5247. }
  5248. function done(err, criterion) {
  5249. criteria[completed] = criterion;
  5250. if (err) {
  5251. callback(err);
  5252. } else if (++completed === size) {
  5253. iterate = throwError;
  5254. callback(null, sortByCriteria(array, criteria));
  5255. } else if (sync) {
  5256. nextTick(iterate);
  5257. } else {
  5258. sync = true;
  5259. iterate();
  5260. }
  5261. sync = false;
  5262. }
  5263. }
  5264. /**
  5265. * @memberof async
  5266. * @namespace sortByLimit
  5267. * @param {Array|Object} collection
  5268. * @param {number} limit - limit >= 1
  5269. * @param {Function} iterator
  5270. * @param {Function} callback
  5271. * @example
  5272. *
  5273. * // array
  5274. * var order = [];
  5275. * var array = [1, 5, 3, 4, 2];
  5276. * var iterator = function(num, done) {
  5277. * setTimeout(function() {
  5278. * order.push(num);
  5279. * done(null, num);
  5280. * }, num * 10);
  5281. * };
  5282. * async.sortByLimit(array, 2, iterator, function(err, res) {
  5283. * console.log(res); // [1, 2, 3, 4, 5]
  5284. * console.log(order); // [1, 3, 5, 2, 4]
  5285. * });
  5286. *
  5287. * @example
  5288. *
  5289. * // array with index
  5290. * var order = [];
  5291. * var array = [1, 5, 3, 4, 2];
  5292. * var iterator = function(num, index, done) {
  5293. * setTimeout(function() {
  5294. * order.push([num, index]);
  5295. * done(null, num);
  5296. * }, num * 10);
  5297. * };
  5298. * async.sortByLimit(array, 2, iterator, function(err, res) {
  5299. * console.log(res); // [1, 2, 3, 4, 5]
  5300. * console.log(order); // [[1, 0], [3, 2], [5, 1], [2, 4], [4, 3]]
  5301. * });
  5302. *
  5303. * @example
  5304. *
  5305. * // object
  5306. * var order = [];
  5307. * var object = { a: 1, b: 5, c: 3, d: 4, e: 2 };
  5308. * var iterator = function(num, done) {
  5309. * setTimeout(function() {
  5310. * order.push(num);
  5311. * done(null, num);
  5312. * }, num * 10);
  5313. * };
  5314. * async.sortByLimit(object, 2, iterator, function(err, res) {
  5315. * console.log(res); // [1, 2, 3, 4, 5]
  5316. * console.log(order); // [1, 3, 5, 2, 4]
  5317. * });
  5318. *
  5319. * @example
  5320. *
  5321. * // object with key
  5322. * var order = [];
  5323. * var object = { a: 1, b: 5, c: 3, d: 4, e: 2 };
  5324. * var iterator = function(num, key, done) {
  5325. * setTimeout(function() {
  5326. * order.push([num, key]);
  5327. * done(null, num);
  5328. * }, num * 10);
  5329. * };
  5330. * async.sortByLimit(object, 2, iterator, function(err, res) {
  5331. * console.log(res); // [1, 2, 3, 4, 5]
  5332. * console.log(order); // [[1, 'a'], [3, 'c'], [5, 'b'], [2, 'e'], [4, 'd']]
  5333. * });
  5334. *
  5335. */
  5336. function sortByLimit(collection, limit, iterator, callback) {
  5337. callback = callback || noop;
  5338. var size, index, key, value, array, keys, iter, item, criteria, iterate;
  5339. var sync = false;
  5340. var started = 0;
  5341. var completed = 0;
  5342. if (isArray(collection)) {
  5343. size = collection.length;
  5344. array = collection;
  5345. iterate = iterator.length === 3 ? arrayIteratorWithIndex : arrayIterator;
  5346. } else if (!collection) {
  5347. } else if (iteratorSymbol && collection[iteratorSymbol]) {
  5348. size = Infinity;
  5349. iter = collection[iteratorSymbol]();
  5350. array = [];
  5351. criteria = [];
  5352. iterate = iterator.length === 3 ? symbolIteratorWithKey : symbolIterator;
  5353. } else if (typeof collection === obj) {
  5354. keys = nativeKeys(collection);
  5355. size = keys.length;
  5356. array = Array(size);
  5357. iterate = iterator.length === 3 ? objectIteratorWithKey : objectIterator;
  5358. }
  5359. if (!size || isNaN(limit) || limit < 1) {
  5360. return callback(null, []);
  5361. }
  5362. criteria = criteria || Array(size);
  5363. timesSync(limit > size ? size : limit, iterate);
  5364. function arrayIterator() {
  5365. if (started < size) {
  5366. value = collection[started];
  5367. iterator(value, createCallback(value, started++));
  5368. }
  5369. }
  5370. function arrayIteratorWithIndex() {
  5371. index = started++;
  5372. if (index < size) {
  5373. value = collection[index];
  5374. iterator(value, index, createCallback(value, index));
  5375. }
  5376. }
  5377. function symbolIterator() {
  5378. item = iter.next();
  5379. if (item.done === false) {
  5380. value = item.value;
  5381. array[started] = value;
  5382. iterator(value, createCallback(value, started++));
  5383. } else if (completed >= collection.size && iterator !== noop) {
  5384. iterator = noop;
  5385. callback(null, sortByCriteria(array, criteria));
  5386. }
  5387. }
  5388. function symbolIteratorWithKey() {
  5389. item = iter.next();
  5390. if (item.done === false) {
  5391. value = item.value;
  5392. array[started] = value;
  5393. iterator(value, started, createCallback(value, started++));
  5394. } else if (completed >= collection.size && iterator !== noop) {
  5395. iterator = noop;
  5396. callback(null, sortByCriteria(array, criteria));
  5397. }
  5398. }
  5399. function objectIterator() {
  5400. if (started < size) {
  5401. value = collection[keys[started]];
  5402. array[started] = value;
  5403. iterator(value, createCallback(value, started++));
  5404. }
  5405. }
  5406. function objectIteratorWithKey() {
  5407. if (started < size) {
  5408. key = keys[started];
  5409. value = collection[key];
  5410. array[started] = value;
  5411. iterator(value, key, createCallback(value, started++));
  5412. }
  5413. }
  5414. function createCallback(value, index) {
  5415. var called = false;
  5416. return function(err, criterion) {
  5417. if (called) {
  5418. throwError();
  5419. }
  5420. called = true;
  5421. criteria[index] = criterion;
  5422. if (err) {
  5423. iterate = noop;
  5424. callback(err);
  5425. callback = noop;
  5426. } else if (++completed === size) {
  5427. callback(null, sortByCriteria(array, criteria));
  5428. } else if (sync) {
  5429. nextTick(iterate);
  5430. } else {
  5431. sync = true;
  5432. iterate();
  5433. }
  5434. sync = false;
  5435. };
  5436. }
  5437. }
  5438. /**
  5439. * @memberof async
  5440. * @namespace some
  5441. * @param {Array|Object} collection
  5442. * @param {Function} iterator
  5443. * @param {Function} callback
  5444. * @example
  5445. *
  5446. * // array
  5447. * var order = [];
  5448. * var array = [1, 3, 2];
  5449. * var iterator = function(num, done) {
  5450. * setTimeout(function() {
  5451. * order.push(num);
  5452. * done(null, num % 2);
  5453. * }, num * 10);
  5454. * };
  5455. * async.some(array, iterator, function(err, res) {
  5456. * console.log(res); // true
  5457. * console.log(order); // [1]
  5458. * });
  5459. *
  5460. * @example
  5461. *
  5462. * // array with index
  5463. * var order = [];
  5464. * var array = [1, 3, 2];
  5465. * var iterator = function(num, index, done) {
  5466. * setTimeout(function() {
  5467. * order.push([num, index]);
  5468. * done(null, num % 2);
  5469. * }, num * 10);
  5470. * };
  5471. * async.some(array, iterator, function(err, res) {
  5472. * console.log(res); // true
  5473. * console.log(order); // [[1, 0]]
  5474. * });
  5475. *
  5476. * @example
  5477. *
  5478. * // object
  5479. * var order = [];
  5480. * var object = { a: 1, b: 3, c: 2 };
  5481. * var iterator = function(num, done) {
  5482. * setTimeout(function() {
  5483. * order.push(num);
  5484. * done(null, num % 2);
  5485. * }, num * 10);
  5486. * };
  5487. * async.some(object, iterator, function(err, res) {
  5488. * console.log(res); // true
  5489. * console.log(order); // [1]
  5490. * });
  5491. *
  5492. * @example
  5493. *
  5494. * // object with key
  5495. * var order = [];
  5496. * var object = { a: 1, b: 3, c: 2 };
  5497. * var iterator = function(num, key, done) {
  5498. * setTimeout(function() {
  5499. * order.push([num, key]);
  5500. * done(null, num % 2);
  5501. * }, num * 10);
  5502. * };
  5503. * async.some(object, iterator, function(err, res) {
  5504. * console.log(res); // true
  5505. * console.log(order); // [[1, 'a']]
  5506. * });
  5507. *
  5508. */
  5509. function some(collection, iterator, callback) {
  5510. callback = callback || noop;
  5511. detect(collection, iterator, done);
  5512. function done(err, res) {
  5513. if (err) {
  5514. return callback(err);
  5515. }
  5516. callback(null, !!res);
  5517. }
  5518. }
  5519. /**
  5520. * @memberof async
  5521. * @namespace someSeries
  5522. * @param {Array|Object} collection
  5523. * @param {Function} iterator
  5524. * @param {Function} callback
  5525. * @example
  5526. *
  5527. * // array
  5528. * var order = [];
  5529. * var array = [1, 3, 2];
  5530. * var iterator = function(num, done) {
  5531. * setTimeout(function() {
  5532. * order.push(num);
  5533. * done(null, num % 2);
  5534. * }, num * 10);
  5535. * };
  5536. * async.someSeries(array, iterator, function(err, res) {
  5537. * console.log(res); // true
  5538. * console.log(order); // [1]
  5539. * });
  5540. *
  5541. * @example
  5542. *
  5543. * // array with index
  5544. * var order = [];
  5545. * var array = [1, 3, 2];
  5546. * var iterator = function(num, index, done) {
  5547. * setTimeout(function() {
  5548. * order.push([num, index]);
  5549. * done(null, num % 2);
  5550. * }, num * 10);
  5551. * };
  5552. * async.someSeries(array, iterator, function(err, res) {
  5553. * console.log(res); // true
  5554. * console.log(order); // [[1, 0]]
  5555. * });
  5556. *
  5557. * @example
  5558. *
  5559. * // object
  5560. * var order = [];
  5561. * var object = { a: 1, b: 3, c: 2 };
  5562. * var iterator = function(num, done) {
  5563. * setTimeout(function() {
  5564. * order.push(num);
  5565. * done(null, num % 2);
  5566. * }, num * 10);
  5567. * };
  5568. * async.someSeries(object, iterator, function(err, res) {
  5569. * console.log(res); // true
  5570. * console.log(order); // [1]
  5571. * });
  5572. *
  5573. * @example
  5574. *
  5575. * // object with key
  5576. * var order = [];
  5577. * var object = { a: 1, b: 3, c: 2 };
  5578. * var iterator = function(num, key, done) {
  5579. * setTimeout(function() {
  5580. * order.push([num, key]);
  5581. * done(null, num % 2);
  5582. * }, num * 10);
  5583. * };
  5584. * async.someSeries(object, iterator, function(err, res) {
  5585. * console.log(res); // true
  5586. * console.log(order); // [[1, 'a']]
  5587. * });
  5588. *
  5589. */
  5590. function someSeries(collection, iterator, callback) {
  5591. callback = callback || noop;
  5592. detectSeries(collection, iterator, done);
  5593. function done(err, res) {
  5594. if (err) {
  5595. return callback(err);
  5596. }
  5597. callback(null, !!res);
  5598. }
  5599. }
  5600. /**
  5601. * @memberof async
  5602. * @namespace someLimit
  5603. * @param {Array|Object} collection
  5604. * @param {number} limit - limit >= 1
  5605. * @param {Function} iterator
  5606. * @param {Function} callback
  5607. * @example
  5608. *
  5609. * // array
  5610. * var order = [];
  5611. * var array = [1, 5, 3, 4, 2];
  5612. * var iterator = function(num, done) {
  5613. * setTimeout(function() {
  5614. * order.push(num);
  5615. * done(null, num % 2);
  5616. * }, num * 10);
  5617. * };
  5618. * async.someLimit(array, 2, iterator, function(err, res) {
  5619. * console.log(res); // true
  5620. * console.log(order); // [1]
  5621. * });
  5622. *
  5623. * @example
  5624. *
  5625. * // array with index
  5626. * var order = [];
  5627. * var array = [1, 5, 3, 4, 2];
  5628. * var iterator = function(num, index, done) {
  5629. * setTimeout(function() {
  5630. * order.push([num, index]);
  5631. * done(null, num % 2);
  5632. * }, num * 10);
  5633. * };
  5634. * async.someLimit(array, 2, iterator, function(err, res) {
  5635. * console.log(res); // true
  5636. * console.log(order); // [[1, 0]]
  5637. * });
  5638. *
  5639. * @example
  5640. *
  5641. * // object
  5642. * var order = [];
  5643. * var object = { a: 1, b: 5, c: 3, d: 4, e: 2 };
  5644. * var iterator = function(num, done) {
  5645. * setTimeout(function() {
  5646. * order.push(num);
  5647. * done(null, num % 2);
  5648. * }, num * 10);
  5649. * };
  5650. * async.someLimit(object, 2, iterator, function(err, res) {
  5651. * console.log(res); // true
  5652. * console.log(order); // [1]
  5653. * });
  5654. *
  5655. * @example
  5656. *
  5657. * // object with key
  5658. * var order = [];
  5659. * var object = { a: 1, b: 5, c: 3, d: 4, e: 2 };
  5660. * var iterator = function(num, key, done) {
  5661. * setTimeout(function() {
  5662. * order.push([num, key]);
  5663. * done(null, num % 2);
  5664. * }, num * 10);
  5665. * };
  5666. * async.someLimit(object, 2, iterator, function(err, res) {
  5667. * console.log(res); // true
  5668. * console.log(order); // [[1, 'a']]
  5669. * });
  5670. *
  5671. */
  5672. function someLimit(collection, limit, iterator, callback) {
  5673. callback = callback || noop;
  5674. detectLimit(collection, limit, iterator, done);
  5675. function done(err, res) {
  5676. if (err) {
  5677. return callback(err);
  5678. }
  5679. callback(null, !!res);
  5680. }
  5681. }
  5682. /**
  5683. * @private
  5684. * @param {Function} arrayEach
  5685. * @param {Function} baseEach
  5686. * @param {Function} symbolEach
  5687. */
  5688. function createEvery(arrayEach, baseEach, symbolEach) {
  5689. var deny = createDetect(arrayEach, baseEach, symbolEach, false);
  5690. return function every(collection, iterator, callback) {
  5691. callback = callback || noop;
  5692. deny(collection, iterator, done);
  5693. function done(err, res) {
  5694. if (err) {
  5695. return callback(err);
  5696. }
  5697. callback(null, !res);
  5698. }
  5699. };
  5700. }
  5701. /**
  5702. * @private
  5703. */
  5704. function createEverySeries() {
  5705. var denySeries = createDetectSeries(false);
  5706. return function everySeries(collection, iterator, callback) {
  5707. callback = callback || noop;
  5708. denySeries(collection, iterator, done);
  5709. function done(err, res) {
  5710. if (err) {
  5711. return callback(err);
  5712. }
  5713. callback(null, !res);
  5714. }
  5715. };
  5716. }
  5717. /**
  5718. * @private
  5719. */
  5720. function createEveryLimit() {
  5721. var denyLimit = createDetectLimit(false);
  5722. return function everyLimit(collection, limit, iterator, callback) {
  5723. callback = callback || noop;
  5724. denyLimit(collection, limit, iterator, done);
  5725. function done(err, res) {
  5726. if (err) {
  5727. return callback(err);
  5728. }
  5729. callback(null, !res);
  5730. }
  5731. };
  5732. }
  5733. /**
  5734. * @private
  5735. * @param {Function} arrayEach
  5736. * @param {Function} baseEach
  5737. * @param {Function} symbolEach
  5738. */
  5739. function createConcat(arrayEach, baseEach, symbolEach) {
  5740. return function concat(collection, iterator, callback) {
  5741. callback = callback || noop;
  5742. var size, result;
  5743. var completed = 0;
  5744. if (isArray(collection)) {
  5745. size = collection.length;
  5746. result = Array(size);
  5747. arrayEach(collection, iterator, createCallback);
  5748. } else if (!collection) {
  5749. } else if (iteratorSymbol && collection[iteratorSymbol]) {
  5750. result = [];
  5751. size = symbolEach(collection, iterator, createCallback);
  5752. size && size === completed && callback(null, result);
  5753. } else if (typeof collection === obj) {
  5754. var keys = nativeKeys(collection);
  5755. size = keys.length;
  5756. result = Array(size);
  5757. baseEach(collection, iterator, createCallback, keys);
  5758. }
  5759. if (!size) {
  5760. callback(null, []);
  5761. }
  5762. function createCallback(index) {
  5763. return function done(err, res) {
  5764. if (index === null) {
  5765. throwError();
  5766. }
  5767. if (err) {
  5768. index = null;
  5769. callback = once(callback);
  5770. arrayEachSync(result, function(array, index) {
  5771. if (array === undefined) {
  5772. result[index] = noop;
  5773. }
  5774. });
  5775. callback(err, makeConcatResult(result));
  5776. return;
  5777. }
  5778. switch (arguments.length) {
  5779. case 0:
  5780. case 1:
  5781. result[index] = noop;
  5782. break;
  5783. case 2:
  5784. result[index] = res;
  5785. break;
  5786. default:
  5787. result[index] = slice(arguments, 1);
  5788. break;
  5789. }
  5790. index = null;
  5791. if (++completed === size) {
  5792. callback(null, makeConcatResult(result));
  5793. }
  5794. };
  5795. }
  5796. };
  5797. }
  5798. /**
  5799. * @memberof async
  5800. * @namespace concatSeries
  5801. * @param {Array|Object} collection
  5802. * @param {Function} iterator
  5803. * @param {Function} callback
  5804. * @example
  5805. *
  5806. * // array
  5807. * var order = [];
  5808. * var array = [1, 3, 2];
  5809. * var iterator = function(num, done) {
  5810. * setTimeout(function() {
  5811. * order.push(num);
  5812. * done(null, [num]);
  5813. * }, num * 10);
  5814. * };
  5815. * async.concatSeries(array, iterator, function(err, res) {
  5816. * console.log(res); // [1, 3, 2];
  5817. * console.log(order); // [1, 3, 2]
  5818. * });
  5819. *
  5820. * @example
  5821. *
  5822. * // array with index
  5823. * var order = [];
  5824. * var array = [1, 3, 2];
  5825. * var iterator = function(num, index, done) {
  5826. * setTimeout(function() {
  5827. * order.push([num, index]);
  5828. * done(null, [num]);
  5829. * }, num * 10);
  5830. * };
  5831. * async.concatSeries(array, iterator, function(err, res) {
  5832. * console.log(res); // [1, 3, 2]
  5833. * console.log(order); // [[1, 0], [3, 1], [2, 2]]
  5834. * });
  5835. *
  5836. * @example
  5837. *
  5838. * // object
  5839. * var order = [];
  5840. * var object = { a: 1, b: 3, c: 2 };
  5841. * var iterator = function(num, done) {
  5842. * setTimeout(function() {
  5843. * order.push(num);
  5844. * done(null, [num]);
  5845. * }, num * 10);
  5846. * };
  5847. * async.concatSeries(object, iterator, function(err, res) {
  5848. * console.log(res); // [1, 3, 2]
  5849. * console.log(order); // [1, 3, 2]
  5850. * });
  5851. *
  5852. * @example
  5853. *
  5854. * // object with key
  5855. * var order = [];
  5856. * var object = { a: 1, b: 3, c: 2 };
  5857. * var iterator = function(num, key, done) {
  5858. * setTimeout(function() {
  5859. * order.push([num, key]);
  5860. * done(null, [num]);
  5861. * }, num * 10);
  5862. * };
  5863. * async.concatSeries(object, iterator, function(err, res) {
  5864. * console.log(res); // [1, 3, 2]
  5865. * console.log(order); // [[1, 'a'], [3, 'b'], [2, 'c']]
  5866. * });
  5867. *
  5868. */
  5869. function concatSeries(collection, iterator, callback) {
  5870. callback = onlyOnce(callback || noop);
  5871. var size, key, keys, iter, item, iterate;
  5872. var sync = false;
  5873. var result = [];
  5874. var completed = 0;
  5875. if (isArray(collection)) {
  5876. size = collection.length;
  5877. iterate = iterator.length === 3 ? arrayIteratorWithIndex : arrayIterator;
  5878. } else if (!collection) {
  5879. } else if (iteratorSymbol && collection[iteratorSymbol]) {
  5880. size = Infinity;
  5881. iter = collection[iteratorSymbol]();
  5882. iterate = iterator.length === 3 ? symbolIteratorWithKey : symbolIterator;
  5883. } else if (typeof collection === obj) {
  5884. keys = nativeKeys(collection);
  5885. size = keys.length;
  5886. iterate = iterator.length === 3 ? objectIteratorWithKey : objectIterator;
  5887. }
  5888. if (!size) {
  5889. return callback(null, result);
  5890. }
  5891. iterate();
  5892. function arrayIterator() {
  5893. iterator(collection[completed], done);
  5894. }
  5895. function arrayIteratorWithIndex() {
  5896. iterator(collection[completed], completed, done);
  5897. }
  5898. function symbolIterator() {
  5899. item = iter.next();
  5900. item.done ? callback(null, result) : iterator(item.value, done);
  5901. }
  5902. function symbolIteratorWithKey() {
  5903. item = iter.next();
  5904. item.done ? callback(null, result) : iterator(item.value, completed, done);
  5905. }
  5906. function objectIterator() {
  5907. iterator(collection[keys[completed]], done);
  5908. }
  5909. function objectIteratorWithKey() {
  5910. key = keys[completed];
  5911. iterator(collection[key], key, done);
  5912. }
  5913. function done(err, array) {
  5914. if (isArray(array)) {
  5915. nativePush.apply(result, array);
  5916. } else if (arguments.length >= 2) {
  5917. nativePush.apply(result, slice(arguments, 1));
  5918. }
  5919. if (err) {
  5920. callback(err, result);
  5921. } else if (++completed === size) {
  5922. iterate = throwError;
  5923. callback(null, result);
  5924. } else if (sync) {
  5925. nextTick(iterate);
  5926. } else {
  5927. sync = true;
  5928. iterate();
  5929. }
  5930. sync = false;
  5931. }
  5932. }
  5933. /**
  5934. * @memberof async
  5935. * @namespace concatLimit
  5936. * @param {Array|Object} collection
  5937. * @param {number} limit - limit >= 1
  5938. * @param {Function} iterator
  5939. * @param {Function} callback
  5940. * @example
  5941. *
  5942. * // array
  5943. * var order = [];
  5944. * var array = [1, 5, 3, 4, 2];
  5945. * var iterator = function(num, done) {
  5946. * setTimeout(function() {
  5947. * order.push(num);
  5948. * done(null, [num]);
  5949. * }, num * 10);
  5950. * };
  5951. * async.concatLimit(array, 2, iterator, function(err, res) {
  5952. * console.log(res); // [1, 3, 5, 2, 4]
  5953. * console.log(order); // [1, 3, 5, 2, 4]
  5954. * });
  5955. *
  5956. * @example
  5957. *
  5958. * // array with index
  5959. * var order = [];
  5960. * var array = [1, 5, 3, 4, 2];
  5961. * var iterator = function(num, index, done) {
  5962. * setTimeout(function() {
  5963. * order.push([num, index]);
  5964. * done(null, [num]);
  5965. * }, num * 10);
  5966. * };
  5967. * async.cocnatLimit(array, 2, iterator, function(err, res) {
  5968. * console.log(res); // [1, 3, 5, 2, 4]
  5969. * console.log(order); // [[1, 0], [3, 2], [5, 1], [2, 4], [4, 3]]
  5970. * });
  5971. *
  5972. * @example
  5973. *
  5974. * // object
  5975. * var order = [];
  5976. * var object = { a: 1, b: 5, c: 3, d: 4, e: 2 };
  5977. * var iterator = function(num, done) {
  5978. * setTimeout(function() {
  5979. * order.push(num);
  5980. * done(null, [num]);
  5981. * }, num * 10);
  5982. * };
  5983. * async.concatLimit(object, 2, iterator, function(err, res) {
  5984. * console.log(res); // [1, 3, 5, 2, 4]
  5985. * console.log(order); // [1, 3, 5, 2, 4]
  5986. * });
  5987. *
  5988. * @example
  5989. *
  5990. * // object with key
  5991. * var order = [];
  5992. * var object = { a: 1, b: 5, c: 3, d: 4, e: 2 };
  5993. * var iterator = function(num, key, done) {
  5994. * setTimeout(function() {
  5995. * order.push([num, key]);
  5996. * done(null, num);
  5997. * }, num * 10);
  5998. * };
  5999. * async.cocnatLimit(object, 2, iterator, function(err, res) {
  6000. * console.log(res); // [1, 3, 5, 2, 4]
  6001. * console.log(order); // [[1, 'a'], [3, 'c'], [5, 'b'], [2, 'e'], [4, 'd']]
  6002. * });
  6003. *
  6004. */
  6005. function concatLimit(collection, limit, iterator, callback) {
  6006. callback = callback || noop;
  6007. var size, key, iter, item, iterate, result;
  6008. var sync = false;
  6009. var started = 0;
  6010. var completed = 0;
  6011. if (isArray(collection)) {
  6012. size = collection.length;
  6013. iterate = iterator.length === 3 ? arrayIteratorWithIndex : arrayIterator;
  6014. } else if (!collection) {
  6015. } else if (iteratorSymbol && collection[iteratorSymbol]) {
  6016. size = Infinity;
  6017. result = [];
  6018. iter = collection[iteratorSymbol]();
  6019. iterate = iterator.length === 3 ? symbolIteratorWithKey : symbolIterator;
  6020. } else if (typeof collection === obj) {
  6021. var keys = nativeKeys(collection);
  6022. size = keys.length;
  6023. iterate = iterator.length === 3 ? objectIteratorWithKey : objectIterator;
  6024. }
  6025. if (!size || isNaN(limit) || limit < 1) {
  6026. return callback(null, []);
  6027. }
  6028. result = result || Array(size);
  6029. timesSync(limit > size ? size : limit, iterate);
  6030. function arrayIterator() {
  6031. if (started < size) {
  6032. iterator(collection[started], createCallback(started++));
  6033. }
  6034. }
  6035. function arrayIteratorWithIndex() {
  6036. if (started < size) {
  6037. iterator(collection[started], started, createCallback(started++));
  6038. }
  6039. }
  6040. function symbolIterator() {
  6041. item = iter.next();
  6042. if (item.done === false) {
  6043. iterator(item.value, createCallback(started++));
  6044. } else if (completed >= collection.size && iterator !== noop) {
  6045. iterator = noop;
  6046. callback(null, makeConcatResult(result));
  6047. }
  6048. }
  6049. function symbolIteratorWithKey() {
  6050. item = iter.next();
  6051. if (item.done === false) {
  6052. iterator(item.value, started, createCallback(started++));
  6053. } else if (completed >= collection.size && iterator !== noop) {
  6054. iterator = noop;
  6055. callback(null, makeConcatResult(result));
  6056. }
  6057. }
  6058. function objectIterator() {
  6059. if (started < size) {
  6060. iterator(collection[keys[started]], createCallback(started++));
  6061. }
  6062. }
  6063. function objectIteratorWithKey() {
  6064. if (started < size) {
  6065. key = keys[started];
  6066. iterator(collection[key], key, createCallback(started++));
  6067. }
  6068. }
  6069. function createCallback(index) {
  6070. return function(err, res) {
  6071. if (index === null) {
  6072. throwError();
  6073. }
  6074. if (err) {
  6075. index = null;
  6076. iterate = noop;
  6077. callback = once(callback);
  6078. arrayEachSync(result, function(array, index) {
  6079. if (array === undefined) {
  6080. result[index] = noop;
  6081. }
  6082. });
  6083. callback(err, makeConcatResult(result));
  6084. return;
  6085. }
  6086. switch (arguments.length) {
  6087. case 0:
  6088. case 1:
  6089. result[index] = noop;
  6090. break;
  6091. case 2:
  6092. result[index] = res;
  6093. break;
  6094. default:
  6095. result[index] = slice(arguments, 1);
  6096. break;
  6097. }
  6098. index = null;
  6099. if (++completed === size) {
  6100. iterate = throwError;
  6101. callback(null, makeConcatResult(result));
  6102. callback = throwError;
  6103. } else if (sync) {
  6104. nextTick(iterate);
  6105. } else {
  6106. sync = true;
  6107. iterate();
  6108. }
  6109. sync = false;
  6110. };
  6111. }
  6112. }
  6113. /**
  6114. * @private
  6115. * @param {Function} arrayEach
  6116. * @param {Function} baseEach
  6117. * @param {Function} symbolEach
  6118. */
  6119. function createGroupBy(arrayEach, baseEach, symbolEach) {
  6120. return function groupBy(collection, iterator, callback) {
  6121. callback = callback || noop;
  6122. var size;
  6123. var completed = 0;
  6124. var result = {};
  6125. if (isArray(collection)) {
  6126. size = collection.length;
  6127. arrayEach(collection, iterator, createCallback);
  6128. } else if (!collection) {
  6129. } else if (iteratorSymbol && collection[iteratorSymbol]) {
  6130. size = symbolEach(collection, iterator, createCallback);
  6131. size && size === completed && callback(null, result);
  6132. } else if (typeof collection === obj) {
  6133. var keys = nativeKeys(collection);
  6134. size = keys.length;
  6135. baseEach(collection, iterator, createCallback, keys);
  6136. }
  6137. if (!size) {
  6138. callback(null, {});
  6139. }
  6140. function createCallback(value) {
  6141. var called = false;
  6142. return function done(err, key) {
  6143. if (called) {
  6144. throwError();
  6145. }
  6146. called = true;
  6147. if (err) {
  6148. callback = once(callback);
  6149. callback(err, objectClone(result));
  6150. return;
  6151. }
  6152. var array = result[key];
  6153. if (!array) {
  6154. result[key] = [value];
  6155. } else {
  6156. array.push(value);
  6157. }
  6158. if (++completed === size) {
  6159. callback(null, result);
  6160. }
  6161. };
  6162. }
  6163. };
  6164. }
  6165. /**
  6166. * @memberof async
  6167. * @namespace groupBySeries
  6168. * @param {Array|Object} collection
  6169. * @param {Function} iterator
  6170. * @param {Function} callback
  6171. * @example
  6172. *
  6173. * // array
  6174. * var order = [];
  6175. * var array = [4.2, 6.4, 6.1];
  6176. * var iterator = function(num, done) {
  6177. * setTimeout(function() {
  6178. * order.push(num);
  6179. * done(null, Math.floor(num));
  6180. * }, num * 10);
  6181. * };
  6182. * async.groupBySeries(array, iterator, function(err, res) {
  6183. * console.log(res); // { '4': [4.2], '6': [6.4, 6.1] }
  6184. * console.log(order); // [4.2, 6.4, 6.1]
  6185. * });
  6186. *
  6187. * @example
  6188. *
  6189. * // array with index
  6190. * var order = [];
  6191. * var array = [4.2, 6.4, 6.1];
  6192. * var iterator = function(num, index, done) {
  6193. * setTimeout(function() {
  6194. * order.push([num, index]);
  6195. * done(null, Math.floor(num));
  6196. * }, num * 10);
  6197. * };
  6198. * async.groupBySeries(array, iterator, function(err, res) {
  6199. * console.log(res); // { '4': [4.2], '6': [6.4, 6.1] }
  6200. * console.log(order); // [[4.2, 0], [6.4, 1], [6.1, 2]]
  6201. * });
  6202. *
  6203. * @example
  6204. *
  6205. * // object
  6206. * var order = [];
  6207. * var object = { a: 4.2, b: 6.4, c: 6.1 };
  6208. * var iterator = function(num, done) {
  6209. * setTimeout(function() {
  6210. * order.push(num);
  6211. * done(null, Math.floor(num));
  6212. * }, num * 10);
  6213. * };
  6214. * async.groupBySeries(object, iterator, function(err, res) {
  6215. * console.log(res); // { '4': [4.2], '6': [6.4, 6.1] }
  6216. * console.log(order); // [4.2, 6.4, 6.1]
  6217. * });
  6218. *
  6219. * @example
  6220. *
  6221. * // object with key
  6222. * var order = [];
  6223. * var object = { a: 4.2, b: 6.4, c: 6.1 };
  6224. * var iterator = function(num, key, done) {
  6225. * setTimeout(function() {
  6226. * order.push([num, key]);
  6227. * done(null, Math.floor(num));
  6228. * }, num * 10);
  6229. * };
  6230. * async.groupBySeries(object, iterator, function(err, res) {
  6231. * console.log(res); // { '4': [4.2], '6': [6.4, 6.1] }
  6232. * console.log(order); // [[4.2, 'a'], [6.4, 'b'], [6.1, 'c']]
  6233. * });
  6234. *
  6235. */
  6236. function groupBySeries(collection, iterator, callback) {
  6237. callback = onlyOnce(callback || noop);
  6238. var size, key, value, keys, iter, item, iterate;
  6239. var sync = false;
  6240. var completed = 0;
  6241. var result = {};
  6242. if (isArray(collection)) {
  6243. size = collection.length;
  6244. iterate = iterator.length === 3 ? arrayIteratorWithIndex : arrayIterator;
  6245. } else if (!collection) {
  6246. } else if (iteratorSymbol && collection[iteratorSymbol]) {
  6247. size = Infinity;
  6248. iter = collection[iteratorSymbol]();
  6249. iterate = iterator.length === 3 ? symbolIteratorWithKey : symbolIterator;
  6250. } else if (typeof collection === obj) {
  6251. keys = nativeKeys(collection);
  6252. size = keys.length;
  6253. iterate = iterator.length === 3 ? objectIteratorWithKey : objectIterator;
  6254. }
  6255. if (!size) {
  6256. return callback(null, result);
  6257. }
  6258. iterate();
  6259. function arrayIterator() {
  6260. value = collection[completed];
  6261. iterator(value, done);
  6262. }
  6263. function arrayIteratorWithIndex() {
  6264. value = collection[completed];
  6265. iterator(value, completed, done);
  6266. }
  6267. function symbolIterator() {
  6268. item = iter.next();
  6269. value = item.value;
  6270. item.done ? callback(null, result) : iterator(value, done);
  6271. }
  6272. function symbolIteratorWithKey() {
  6273. item = iter.next();
  6274. value = item.value;
  6275. item.done ? callback(null, result) : iterator(value, completed, done);
  6276. }
  6277. function objectIterator() {
  6278. value = collection[keys[completed]];
  6279. iterator(value, done);
  6280. }
  6281. function objectIteratorWithKey() {
  6282. key = keys[completed];
  6283. value = collection[key];
  6284. iterator(value, key, done);
  6285. }
  6286. function done(err, key) {
  6287. if (err) {
  6288. iterate = throwError;
  6289. callback = onlyOnce(callback);
  6290. callback(err, objectClone(result));
  6291. return;
  6292. }
  6293. var array = result[key];
  6294. if (!array) {
  6295. result[key] = [value];
  6296. } else {
  6297. array.push(value);
  6298. }
  6299. if (++completed === size) {
  6300. iterate = throwError;
  6301. callback(null, result);
  6302. } else if (sync) {
  6303. nextTick(iterate);
  6304. } else {
  6305. sync = true;
  6306. iterate();
  6307. }
  6308. sync = false;
  6309. }
  6310. }
  6311. /**
  6312. * @memberof async
  6313. * @namespace groupByLimit
  6314. * @param {Array|Object} collection
  6315. * @param {Function} iterator
  6316. * @param {Function} callback
  6317. * @example
  6318. *
  6319. * // array
  6320. * var order = [];
  6321. * var array = [1.1, 5.9, 3.2, 3.9, 2.1];
  6322. * var iterator = function(num, done) {
  6323. * setTimeout(function() {
  6324. * order.push(num);
  6325. * done(null, Math.floor(num));
  6326. * }, num * 10);
  6327. * };
  6328. * async.groupByLimit(array, 2, iterator, function(err, res) {
  6329. * console.log(res); // { '1': [1.1], '3': [3.2, 3.9], '5': [5.9], '2': [2.1] }
  6330. * console.log(order); // [1.1, 3.2, 5.9, 2.1, 3.9]
  6331. * });
  6332. *
  6333. * @example
  6334. *
  6335. * // array with index
  6336. * var order = [];
  6337. * var array = [1.1, 5.9, 3.2, 3.9, 2.1];
  6338. * var iterator = function(num, index, done) {
  6339. * setTimeout(function() {
  6340. * order.push([num, index]);
  6341. * done(null, Math.floor(num));
  6342. * }, num * 10);
  6343. * };
  6344. * async.groupByLimit(array, 2, iterator, function(err, res) {
  6345. * console.log(res); // { '1': [1.1], '3': [3.2, 3.9], '5': [5.9], '2': [2.1] }
  6346. * console.log(order); // [[1.1, 0], [3.2, 2], [5.9, 1], [2.1, 4], [3.9, 3]]
  6347. * });
  6348. *
  6349. * @example
  6350. *
  6351. * // object
  6352. * var order = [];
  6353. * var object = { a: 1.1, b: 5.9, c: 3.2, d: 3.9, e: 2.1 }
  6354. * var iterator = function(num, done) {
  6355. * setTimeout(function() {
  6356. * order.push(num);
  6357. * done(null, Math.floor(num));
  6358. * }, num * 10);
  6359. * };
  6360. * async.groupByLimit(object, 2, iterator, function(err, res) {
  6361. * console.log(res); // { '1': [1.1], '3': [3.2, 3.9], '5': [5.9], '2': [2.1] }
  6362. * console.log(order); // [1.1, 3.2, 5.9, 2.1, 3.9]
  6363. * });
  6364. *
  6365. * @example
  6366. *
  6367. * // object with key
  6368. * var order = [];
  6369. * var object = { a: 1.1, b: 5.9, c: 3.2, d: 3.9, e: 2.1 }
  6370. * var iterator = function(num, key, done) {
  6371. * setTimeout(function() {
  6372. * order.push([num, key]);
  6373. * done(null, Math.floor(num));
  6374. * }, num * 10);
  6375. * };
  6376. * async.groupByLimit(object, 2, iterator, function(err, res) {
  6377. * console.log(res); // { '1': [1.1], '3': [3.2, 3.9], '5': [5.9], '2': [2.1] }
  6378. * console.log(order); // [[1.1, 'a'], [3.2, 'c'], [5.9, 'b'], [2.1, 'e'], [3.9, 'd']]
  6379. * });
  6380. *
  6381. */
  6382. function groupByLimit(collection, limit, iterator, callback) {
  6383. callback = callback || noop;
  6384. var size, index, key, value, keys, iter, item, iterate;
  6385. var sync = false;
  6386. var started = 0;
  6387. var completed = 0;
  6388. var result = {};
  6389. if (isArray(collection)) {
  6390. size = collection.length;
  6391. iterate = iterator.length === 3 ? arrayIteratorWithIndex : arrayIterator;
  6392. } else if (!collection) {
  6393. } else if (iteratorSymbol && collection[iteratorSymbol]) {
  6394. size = Infinity;
  6395. iter = collection[iteratorSymbol]();
  6396. iterate = iterator.length === 3 ? symbolIteratorWithKey : symbolIterator;
  6397. } else if (typeof collection === obj) {
  6398. keys = nativeKeys(collection);
  6399. size = keys.length;
  6400. iterate = iterator.length === 3 ? objectIteratorWithKey : objectIterator;
  6401. }
  6402. if (!size || isNaN(limit) || limit < 1) {
  6403. return callback(null, result);
  6404. }
  6405. timesSync(limit > size ? size : limit, iterate);
  6406. function arrayIterator() {
  6407. if (started < size) {
  6408. value = collection[started++];
  6409. iterator(value, createCallback(value));
  6410. }
  6411. }
  6412. function arrayIteratorWithIndex() {
  6413. index = started++;
  6414. if (index < size) {
  6415. value = collection[index];
  6416. iterator(value, index, createCallback(value));
  6417. }
  6418. }
  6419. function symbolIterator() {
  6420. item = iter.next();
  6421. if (item.done === false) {
  6422. value = item.value;
  6423. iterator(value, createCallback(value));
  6424. } else if (completed >= collection.size && iterator !== noop) {
  6425. iterator = noop;
  6426. callback(null, result);
  6427. }
  6428. }
  6429. function symbolIteratorWithKey() {
  6430. item = iter.next();
  6431. if (item.done === false) {
  6432. value = item.value;
  6433. iterator(value, started++, createCallback(value));
  6434. } else if (completed >= collection.size && iterator !== noop) {
  6435. iterator = noop;
  6436. callback(null, result);
  6437. }
  6438. }
  6439. function objectIterator() {
  6440. if (started < size) {
  6441. value = collection[keys[started++]];
  6442. iterator(value, createCallback(value));
  6443. }
  6444. }
  6445. function objectIteratorWithKey() {
  6446. if (started < size) {
  6447. key = keys[started++];
  6448. value = collection[key];
  6449. iterator(value, key, createCallback(value));
  6450. }
  6451. }
  6452. function createCallback(value) {
  6453. var called = false;
  6454. return function(err, key) {
  6455. if (called) {
  6456. throwError();
  6457. }
  6458. called = true;
  6459. if (err) {
  6460. iterate = noop;
  6461. callback = once(callback);
  6462. callback(err, objectClone(result));
  6463. return;
  6464. }
  6465. var array = result[key];
  6466. if (!array) {
  6467. result[key] = [value];
  6468. } else {
  6469. array.push(value);
  6470. }
  6471. if (++completed === size) {
  6472. callback(null, result);
  6473. } else if (sync) {
  6474. nextTick(iterate);
  6475. } else {
  6476. sync = true;
  6477. iterate();
  6478. }
  6479. sync = false;
  6480. };
  6481. }
  6482. }
  6483. /**
  6484. * @private
  6485. * @param {Function} arrayEach
  6486. * @param {Function} baseEach
  6487. */
  6488. function createParallel(arrayEach, baseEach) {
  6489. return function parallel(tasks, callback) {
  6490. callback = callback || noop;
  6491. var size, keys, result;
  6492. var completed = 0;
  6493. if (isArray(tasks)) {
  6494. size = tasks.length;
  6495. result = Array(size);
  6496. arrayEach(tasks, createCallback);
  6497. } else if (tasks && typeof tasks === obj) {
  6498. keys = nativeKeys(tasks);
  6499. size = keys.length;
  6500. result = {};
  6501. baseEach(tasks, createCallback, keys);
  6502. }
  6503. if (!size) {
  6504. callback(null, result);
  6505. }
  6506. function createCallback(key) {
  6507. return function(err, res) {
  6508. if (key === null) {
  6509. throwError();
  6510. }
  6511. if (err) {
  6512. key = null;
  6513. callback = once(callback);
  6514. callback(err, result);
  6515. return;
  6516. }
  6517. result[key] = arguments.length <= 2 ? res : slice(arguments, 1);
  6518. key = null;
  6519. if (++completed === size) {
  6520. callback(null, result);
  6521. }
  6522. };
  6523. }
  6524. };
  6525. }
  6526. /**
  6527. * @memberof async
  6528. * @namespace series
  6529. * @param {Array|Object} tasks - functions
  6530. * @param {Function} callback
  6531. * @example
  6532. *
  6533. * var order = [];
  6534. * var tasks = [
  6535. * function(done) {
  6536. * setTimeout(function() {
  6537. * order.push(1);
  6538. * done(null, 1);
  6539. * }, 10);
  6540. * },
  6541. * function(done) {
  6542. * setTimeout(function() {
  6543. * order.push(2);
  6544. * done(null, 2);
  6545. * }, 30);
  6546. * },
  6547. * function(done) {
  6548. * setTimeout(function() {
  6549. * order.push(3);
  6550. * done(null, 3);
  6551. * }, 40);
  6552. * },
  6553. * function(done) {
  6554. * setTimeout(function() {
  6555. * order.push(4);
  6556. * done(null, 4);
  6557. * }, 20);
  6558. * }
  6559. * ];
  6560. * async.series(tasks, function(err, res) {
  6561. * console.log(res); // [1, 2, 3, 4];
  6562. * console.log(order); // [1, 2, 3, 4]
  6563. * });
  6564. *
  6565. * @example
  6566. *
  6567. * var order = [];
  6568. * var tasks = {
  6569. * 'a': function(done) {
  6570. * setTimeout(function() {
  6571. * order.push(1);
  6572. * done(null, 1);
  6573. * }, 10);
  6574. * },
  6575. * 'b': function(done) {
  6576. * setTimeout(function() {
  6577. * order.push(2);
  6578. * done(null, 2);
  6579. * }, 30);
  6580. * },
  6581. * 'c': function(done) {
  6582. * setTimeout(function() {
  6583. * order.push(3);
  6584. * done(null, 3);
  6585. * }, 40);
  6586. * },
  6587. * 'd': function(done) {
  6588. * setTimeout(function() {
  6589. * order.push(4);
  6590. * done(null, 4);
  6591. * }, 20);
  6592. * }
  6593. * };
  6594. * async.series(tasks, function(err, res) {
  6595. * console.log(res); // { a: 1, b: 2, c: 3, d:4 }
  6596. * console.log(order); // [1, 4, 2, 3]
  6597. * });
  6598. *
  6599. */
  6600. function series(tasks, callback) {
  6601. callback = callback || noop;
  6602. var size, key, keys, result, iterate;
  6603. var sync = false;
  6604. var completed = 0;
  6605. if (isArray(tasks)) {
  6606. size = tasks.length;
  6607. result = Array(size);
  6608. iterate = arrayIterator;
  6609. } else if (tasks && typeof tasks === obj) {
  6610. keys = nativeKeys(tasks);
  6611. size = keys.length;
  6612. result = {};
  6613. iterate = objectIterator;
  6614. } else {
  6615. return callback(null);
  6616. }
  6617. if (!size) {
  6618. return callback(null, result);
  6619. }
  6620. iterate();
  6621. function arrayIterator() {
  6622. key = completed;
  6623. tasks[completed](done);
  6624. }
  6625. function objectIterator() {
  6626. key = keys[completed];
  6627. tasks[key](done);
  6628. }
  6629. function done(err, res) {
  6630. if (err) {
  6631. iterate = throwError;
  6632. callback = onlyOnce(callback);
  6633. callback(err, result);
  6634. return;
  6635. }
  6636. result[key] = arguments.length <= 2 ? res : slice(arguments, 1);
  6637. if (++completed === size) {
  6638. iterate = throwError;
  6639. callback(null, result);
  6640. } else if (sync) {
  6641. nextTick(iterate);
  6642. } else {
  6643. sync = true;
  6644. iterate();
  6645. }
  6646. sync = false;
  6647. }
  6648. }
  6649. /**
  6650. * @memberof async
  6651. * @namespace parallelLimit
  6652. * @param {Array|Object} tasks - functions
  6653. * @param {number} limit - limit >= 1
  6654. * @param {Function} callback
  6655. * @example
  6656. *
  6657. * var order = [];
  6658. * var tasks = [
  6659. * function(done) {
  6660. * setTimeout(function() {
  6661. * order.push(1);
  6662. * done(null, 1);
  6663. * }, 10);
  6664. * },
  6665. * function(done) {
  6666. * setTimeout(function() {
  6667. * order.push(2);
  6668. * done(null, 2);
  6669. * }, 50);
  6670. * },
  6671. * function(done) {
  6672. * setTimeout(function() {
  6673. * order.push(3);
  6674. * done(null, 3);
  6675. * }, 30);
  6676. * },
  6677. * function(done) {
  6678. * setTimeout(function() {
  6679. * order.push(4);
  6680. * done(null, 4);
  6681. * }, 40);
  6682. * }
  6683. * ];
  6684. * async.parallelLimit(tasks, 2, function(err, res) {
  6685. * console.log(res); // [1, 2, 3, 4];
  6686. * console.log(order); // [1, 3, 2, 4]
  6687. * });
  6688. *
  6689. * @example
  6690. *
  6691. * var order = [];
  6692. * var tasks = {
  6693. * 'a': function(done) {
  6694. * setTimeout(function() {
  6695. * order.push(1);
  6696. * done(null, 1);
  6697. * }, 10);
  6698. * },
  6699. * 'b': function(done) {
  6700. * setTimeout(function() {
  6701. * order.push(2);
  6702. * done(null, 2);
  6703. * }, 50);
  6704. * },
  6705. * 'c': function(done) {
  6706. * setTimeout(function() {
  6707. * order.push(3);
  6708. * done(null, 3);
  6709. * }, 20);
  6710. * },
  6711. * 'd': function(done) {
  6712. * setTimeout(function() {
  6713. * order.push(4);
  6714. * done(null, 4);
  6715. * }, 40);
  6716. * }
  6717. * };
  6718. * async.parallelLimit(tasks, 2, function(err, res) {
  6719. * console.log(res); // { a: 1, b: 2, c: 3, d:4 }
  6720. * console.log(order); // [1, 3, 2, 4]
  6721. * });
  6722. *
  6723. */
  6724. function parallelLimit(tasks, limit, callback) {
  6725. callback = callback || noop;
  6726. var size, index, key, keys, result, iterate;
  6727. var sync = false;
  6728. var started = 0;
  6729. var completed = 0;
  6730. if (isArray(tasks)) {
  6731. size = tasks.length;
  6732. result = Array(size);
  6733. iterate = arrayIterator;
  6734. } else if (tasks && typeof tasks === obj) {
  6735. keys = nativeKeys(tasks);
  6736. size = keys.length;
  6737. result = {};
  6738. iterate = objectIterator;
  6739. }
  6740. if (!size || isNaN(limit) || limit < 1) {
  6741. return callback(null, result);
  6742. }
  6743. timesSync(limit > size ? size : limit, iterate);
  6744. function arrayIterator() {
  6745. index = started++;
  6746. if (index < size) {
  6747. tasks[index](createCallback(index));
  6748. }
  6749. }
  6750. function objectIterator() {
  6751. if (started < size) {
  6752. key = keys[started++];
  6753. tasks[key](createCallback(key));
  6754. }
  6755. }
  6756. function createCallback(key) {
  6757. return function(err, res) {
  6758. if (key === null) {
  6759. throwError();
  6760. }
  6761. if (err) {
  6762. key = null;
  6763. iterate = noop;
  6764. callback = once(callback);
  6765. callback(err, result);
  6766. return;
  6767. }
  6768. result[key] = arguments.length <= 2 ? res : slice(arguments, 1);
  6769. key = null;
  6770. if (++completed === size) {
  6771. callback(null, result);
  6772. } else if (sync) {
  6773. nextTick(iterate);
  6774. } else {
  6775. sync = true;
  6776. iterate();
  6777. }
  6778. sync = false;
  6779. };
  6780. }
  6781. }
  6782. /**
  6783. * @memberof async
  6784. * @namespace tryEach
  6785. * @param {Array|Object} tasks - functions
  6786. * @param {Function} callback
  6787. * @example
  6788. *
  6789. * var tasks = [
  6790. * function(done) {
  6791. * setTimeout(function() {
  6792. * done(new Error('error'));
  6793. * }, 10);
  6794. * },
  6795. * function(done) {
  6796. * setTimeout(function() {
  6797. * done(null, 2);
  6798. * }, 10);
  6799. * }
  6800. * ];
  6801. * async.tryEach(tasks, function(err, res) {
  6802. * console.log(res); // 2
  6803. * });
  6804. *
  6805. * @example
  6806. *
  6807. * var tasks = [
  6808. * function(done) {
  6809. * setTimeout(function() {
  6810. * done(new Error('error1'));
  6811. * }, 10);
  6812. * },
  6813. * function(done) {
  6814. * setTimeout(function() {
  6815. * done(new Error('error2');
  6816. * }, 10);
  6817. * }
  6818. * ];
  6819. * async.tryEach(tasks, function(err, res) {
  6820. * console.log(err); // error2
  6821. * console.log(res); // undefined
  6822. * });
  6823. *
  6824. */
  6825. function tryEach(tasks, callback) {
  6826. callback = callback || noop;
  6827. var size, keys, iterate;
  6828. var sync = false;
  6829. var completed = 0;
  6830. if (isArray(tasks)) {
  6831. size = tasks.length;
  6832. iterate = arrayIterator;
  6833. } else if (tasks && typeof tasks === obj) {
  6834. keys = nativeKeys(tasks);
  6835. size = keys.length;
  6836. iterate = objectIterator;
  6837. }
  6838. if (!size) {
  6839. return callback(null);
  6840. }
  6841. iterate();
  6842. function arrayIterator() {
  6843. tasks[completed](done);
  6844. }
  6845. function objectIterator() {
  6846. tasks[keys[completed]](done);
  6847. }
  6848. function done(err, res) {
  6849. if (!err) {
  6850. if (arguments.length <= 2) {
  6851. callback(null, res);
  6852. } else {
  6853. callback(null, slice(arguments, 1));
  6854. }
  6855. } else if (++completed === size) {
  6856. callback(err);
  6857. } else {
  6858. sync = true;
  6859. iterate();
  6860. }
  6861. sync = false;
  6862. }
  6863. }
  6864. /**
  6865. * check for waterfall tasks
  6866. * @private
  6867. * @param {Array} tasks
  6868. * @param {Function} callback
  6869. * @return {boolean}
  6870. */
  6871. function checkWaterfallTasks(tasks, callback) {
  6872. if (!isArray(tasks)) {
  6873. callback(new Error('First argument to waterfall must be an array of functions'));
  6874. return false;
  6875. }
  6876. if (tasks.length === 0) {
  6877. callback(null);
  6878. return false;
  6879. }
  6880. return true;
  6881. }
  6882. /**
  6883. * check for waterfall tasks
  6884. * @private
  6885. * @param {function} func
  6886. * @param {Array|Object} args - arguments
  6887. * @return {function} next
  6888. */
  6889. function waterfallIterator(func, args, next) {
  6890. switch (args.length) {
  6891. case 0:
  6892. case 1:
  6893. return func(next);
  6894. case 2:
  6895. return func(args[1], next);
  6896. case 3:
  6897. return func(args[1], args[2], next);
  6898. case 4:
  6899. return func(args[1], args[2], args[3], next);
  6900. case 5:
  6901. return func(args[1], args[2], args[3], args[4], next);
  6902. case 6:
  6903. return func(args[1], args[2], args[3], args[4], args[5], next);
  6904. default:
  6905. args = slice(args, 1);
  6906. args.push(next);
  6907. return func.apply(null, args);
  6908. }
  6909. }
  6910. /**
  6911. * @memberof async
  6912. * @namespace waterfall
  6913. * @param {Array} tasks - functions
  6914. * @param {Function} callback
  6915. * @example
  6916. *
  6917. * var order = [];
  6918. * var tasks = [
  6919. * function(next) {
  6920. * setTimeout(function() {
  6921. * order.push(1);
  6922. * next(null, 1);
  6923. * }, 10);
  6924. * },
  6925. * function(arg1, next) {
  6926. * setTimeout(function() {
  6927. * order.push(2);
  6928. * next(null, 1, 2);
  6929. * }, 30);
  6930. * },
  6931. * function(arg1, arg2, next) {
  6932. * setTimeout(function() {
  6933. * order.push(3);
  6934. * next(null, 3);
  6935. * }, 20);
  6936. * },
  6937. * function(arg1, next) {
  6938. * setTimeout(function() {
  6939. * order.push(4);
  6940. * next(null, 1, 2, 3, 4);
  6941. * }, 40);
  6942. * }
  6943. * ];
  6944. * async.waterfall(tasks, function(err, arg1, arg2, arg3, arg4) {
  6945. * console.log(arg1, arg2, arg3, arg4); // 1 2 3 4
  6946. * });
  6947. *
  6948. */
  6949. function waterfall(tasks, callback) {
  6950. callback = callback || noop;
  6951. if (!checkWaterfallTasks(tasks, callback)) {
  6952. return;
  6953. }
  6954. var func, args, done, sync;
  6955. var completed = 0;
  6956. var size = tasks.length;
  6957. waterfallIterator(tasks[0], [], createCallback(0));
  6958. function iterate() {
  6959. waterfallIterator(func, args, createCallback(func));
  6960. }
  6961. function createCallback(index) {
  6962. return function next(err, res) {
  6963. if (index === undefined) {
  6964. callback = noop;
  6965. throwError();
  6966. }
  6967. index = undefined;
  6968. if (err) {
  6969. done = callback;
  6970. callback = throwError;
  6971. done(err);
  6972. return;
  6973. }
  6974. if (++completed === size) {
  6975. done = callback;
  6976. callback = throwError;
  6977. if (arguments.length <= 2) {
  6978. done(err, res);
  6979. } else {
  6980. done.apply(null, createArray(arguments));
  6981. }
  6982. return;
  6983. }
  6984. if (sync) {
  6985. args = arguments;
  6986. func = tasks[completed] || throwError;
  6987. nextTick(iterate);
  6988. } else {
  6989. sync = true;
  6990. waterfallIterator(tasks[completed] || throwError, arguments, createCallback(completed));
  6991. }
  6992. sync = false;
  6993. };
  6994. }
  6995. }
  6996. /**
  6997. * `angelFall` is like `waterfall` and inject callback to last argument of next task.
  6998. *
  6999. * @memberof async
  7000. * @namespace angelFall
  7001. * @param {Array} tasks - functions
  7002. * @param {Function} callback
  7003. * @example
  7004. *
  7005. * var order = [];
  7006. * var tasks = [
  7007. * function(next) {
  7008. * setTimeout(function() {
  7009. * order.push(1);
  7010. * next(null, 1);
  7011. * }, 10);
  7012. * },
  7013. * function(arg1, empty, next) {
  7014. * setTimeout(function() {
  7015. * order.push(2);
  7016. * next(null, 1, 2);
  7017. * }, 30);
  7018. * },
  7019. * function(next) {
  7020. * setTimeout(function() {
  7021. * order.push(3);
  7022. * next(null, 3);
  7023. * }, 20);
  7024. * },
  7025. * function(arg1, empty1, empty2, empty3, next) {
  7026. * setTimeout(function() {
  7027. * order.push(4);
  7028. * next(null, 1, 2, 3, 4);
  7029. * }, 40);
  7030. * }
  7031. * ];
  7032. * async.angelFall(tasks, function(err, arg1, arg2, arg3, arg4) {
  7033. * console.log(arg1, arg2, arg3, arg4); // 1 2 3 4
  7034. * });
  7035. *
  7036. */
  7037. function angelFall(tasks, callback) {
  7038. callback = callback || noop;
  7039. if (!checkWaterfallTasks(tasks, callback)) {
  7040. return;
  7041. }
  7042. var completed = 0;
  7043. var sync = false;
  7044. var size = tasks.length;
  7045. var func = tasks[completed];
  7046. var args = [];
  7047. var iterate = function() {
  7048. switch (func.length) {
  7049. case 0:
  7050. try {
  7051. next(null, func());
  7052. } catch (e) {
  7053. next(e);
  7054. }
  7055. return;
  7056. case 1:
  7057. return func(next);
  7058. case 2:
  7059. return func(args[1], next);
  7060. case 3:
  7061. return func(args[1], args[2], next);
  7062. case 4:
  7063. return func(args[1], args[2], args[3], next);
  7064. case 5:
  7065. return func(args[1], args[2], args[3], args[4], next);
  7066. default:
  7067. args = slice(args, 1);
  7068. args[func.length - 1] = next;
  7069. return func.apply(null, args);
  7070. }
  7071. };
  7072. iterate();
  7073. function next(err, res) {
  7074. if (err) {
  7075. iterate = throwError;
  7076. callback = onlyOnce(callback);
  7077. callback(err);
  7078. return;
  7079. }
  7080. if (++completed === size) {
  7081. iterate = throwError;
  7082. var done = callback;
  7083. callback = throwError;
  7084. if (arguments.length === 2) {
  7085. done(err, res);
  7086. } else {
  7087. done.apply(null, createArray(arguments));
  7088. }
  7089. return;
  7090. }
  7091. func = tasks[completed];
  7092. args = arguments;
  7093. if (sync) {
  7094. nextTick(iterate);
  7095. } else {
  7096. sync = true;
  7097. iterate();
  7098. }
  7099. sync = false;
  7100. }
  7101. }
  7102. /**
  7103. * @memberof async
  7104. * @namespace whilst
  7105. * @param {Function} test
  7106. * @param {Function} iterator
  7107. * @param {Function} callback
  7108. */
  7109. function whilst(test, iterator, callback) {
  7110. callback = callback || noop;
  7111. var sync = false;
  7112. if (test()) {
  7113. iterate();
  7114. } else {
  7115. callback(null);
  7116. }
  7117. function iterate() {
  7118. if (sync) {
  7119. nextTick(next);
  7120. } else {
  7121. sync = true;
  7122. iterator(done);
  7123. }
  7124. sync = false;
  7125. }
  7126. function next() {
  7127. iterator(done);
  7128. }
  7129. function done(err, arg) {
  7130. if (err) {
  7131. return callback(err);
  7132. }
  7133. if (arguments.length <= 2) {
  7134. if (test(arg)) {
  7135. iterate();
  7136. } else {
  7137. callback(null, arg);
  7138. }
  7139. return;
  7140. }
  7141. arg = slice(arguments, 1);
  7142. if (test.apply(null, arg)) {
  7143. iterate();
  7144. } else {
  7145. callback.apply(null, [null].concat(arg));
  7146. }
  7147. }
  7148. }
  7149. /**
  7150. * @memberof async
  7151. * @namespace doWhilst
  7152. * @param {Function} iterator
  7153. * @param {Function} test
  7154. * @param {Function} callback
  7155. */
  7156. function doWhilst(iterator, test, callback) {
  7157. callback = callback || noop;
  7158. var sync = false;
  7159. next();
  7160. function iterate() {
  7161. if (sync) {
  7162. nextTick(next);
  7163. } else {
  7164. sync = true;
  7165. iterator(done);
  7166. }
  7167. sync = false;
  7168. }
  7169. function next() {
  7170. iterator(done);
  7171. }
  7172. function done(err, arg) {
  7173. if (err) {
  7174. return callback(err);
  7175. }
  7176. if (arguments.length <= 2) {
  7177. if (test(arg)) {
  7178. iterate();
  7179. } else {
  7180. callback(null, arg);
  7181. }
  7182. return;
  7183. }
  7184. arg = slice(arguments, 1);
  7185. if (test.apply(null, arg)) {
  7186. iterate();
  7187. } else {
  7188. callback.apply(null, [null].concat(arg));
  7189. }
  7190. }
  7191. }
  7192. /**
  7193. * @memberof async
  7194. * @namespace until
  7195. * @param {Function} test
  7196. * @param {Function} iterator
  7197. * @param {Function} callback
  7198. */
  7199. function until(test, iterator, callback) {
  7200. callback = callback || noop;
  7201. var sync = false;
  7202. if (!test()) {
  7203. iterate();
  7204. } else {
  7205. callback(null);
  7206. }
  7207. function iterate() {
  7208. if (sync) {
  7209. nextTick(next);
  7210. } else {
  7211. sync = true;
  7212. iterator(done);
  7213. }
  7214. sync = false;
  7215. }
  7216. function next() {
  7217. iterator(done);
  7218. }
  7219. function done(err, arg) {
  7220. if (err) {
  7221. return callback(err);
  7222. }
  7223. if (arguments.length <= 2) {
  7224. if (!test(arg)) {
  7225. iterate();
  7226. } else {
  7227. callback(null, arg);
  7228. }
  7229. return;
  7230. }
  7231. arg = slice(arguments, 1);
  7232. if (!test.apply(null, arg)) {
  7233. iterate();
  7234. } else {
  7235. callback.apply(null, [null].concat(arg));
  7236. }
  7237. }
  7238. }
  7239. /**
  7240. * @memberof async
  7241. * @namespace doUntil
  7242. * @param {Function} iterator
  7243. * @param {Function} test
  7244. * @param {Function} callback
  7245. */
  7246. function doUntil(iterator, test, callback) {
  7247. callback = callback || noop;
  7248. var sync = false;
  7249. next();
  7250. function iterate() {
  7251. if (sync) {
  7252. nextTick(next);
  7253. } else {
  7254. sync = true;
  7255. iterator(done);
  7256. }
  7257. sync = false;
  7258. }
  7259. function next() {
  7260. iterator(done);
  7261. }
  7262. function done(err, arg) {
  7263. if (err) {
  7264. return callback(err);
  7265. }
  7266. if (arguments.length <= 2) {
  7267. if (!test(arg)) {
  7268. iterate();
  7269. } else {
  7270. callback(null, arg);
  7271. }
  7272. return;
  7273. }
  7274. arg = slice(arguments, 1);
  7275. if (!test.apply(null, arg)) {
  7276. iterate();
  7277. } else {
  7278. callback.apply(null, [null].concat(arg));
  7279. }
  7280. }
  7281. }
  7282. /**
  7283. * @memberof async
  7284. * @namespace during
  7285. * @param {Function} test
  7286. * @param {Function} iterator
  7287. * @param {Function} callback
  7288. */
  7289. function during(test, iterator, callback) {
  7290. callback = callback || noop;
  7291. _test();
  7292. function _test() {
  7293. test(iterate);
  7294. }
  7295. function iterate(err, truth) {
  7296. if (err) {
  7297. return callback(err);
  7298. }
  7299. if (truth) {
  7300. iterator(done);
  7301. } else {
  7302. callback(null);
  7303. }
  7304. }
  7305. function done(err) {
  7306. if (err) {
  7307. return callback(err);
  7308. }
  7309. _test();
  7310. }
  7311. }
  7312. /**
  7313. * @memberof async
  7314. * @namespace doDuring
  7315. * @param {Function} test
  7316. * @param {Function} iterator
  7317. * @param {Function} callback
  7318. */
  7319. function doDuring(iterator, test, callback) {
  7320. callback = callback || noop;
  7321. iterate(null, true);
  7322. function iterate(err, truth) {
  7323. if (err) {
  7324. return callback(err);
  7325. }
  7326. if (truth) {
  7327. iterator(done);
  7328. } else {
  7329. callback(null);
  7330. }
  7331. }
  7332. function done(err, res) {
  7333. if (err) {
  7334. return callback(err);
  7335. }
  7336. switch (arguments.length) {
  7337. case 0:
  7338. case 1:
  7339. test(iterate);
  7340. break;
  7341. case 2:
  7342. test(res, iterate);
  7343. break;
  7344. default:
  7345. var args = slice(arguments, 1);
  7346. args.push(iterate);
  7347. test.apply(null, args);
  7348. break;
  7349. }
  7350. }
  7351. }
  7352. /**
  7353. * @memberof async
  7354. * @namespace forever
  7355. */
  7356. function forever(iterator, callback) {
  7357. var sync = false;
  7358. iterate();
  7359. function iterate() {
  7360. iterator(next);
  7361. }
  7362. function next(err) {
  7363. if (err) {
  7364. if (callback) {
  7365. return callback(err);
  7366. }
  7367. throw err;
  7368. }
  7369. if (sync) {
  7370. nextTick(iterate);
  7371. } else {
  7372. sync = true;
  7373. iterate();
  7374. }
  7375. sync = false;
  7376. }
  7377. }
  7378. /**
  7379. * @memberof async
  7380. * @namespace compose
  7381. */
  7382. function compose() {
  7383. return seq.apply(null, reverse(arguments));
  7384. }
  7385. /**
  7386. * @memberof async
  7387. * @namespace seq
  7388. */
  7389. function seq( /* functions... */ ) {
  7390. var fns = createArray(arguments);
  7391. return function() {
  7392. var self = this;
  7393. var args = createArray(arguments);
  7394. var callback = args[args.length - 1];
  7395. if (typeof callback === func) {
  7396. args.pop();
  7397. } else {
  7398. callback = noop;
  7399. }
  7400. reduce(fns, args, iterator, done);
  7401. function iterator(newargs, fn, callback) {
  7402. var func = function(err) {
  7403. var nextargs = slice(arguments, 1);
  7404. callback(err, nextargs);
  7405. };
  7406. newargs.push(func);
  7407. fn.apply(self, newargs);
  7408. }
  7409. function done(err, res) {
  7410. res = isArray(res) ? res : [res];
  7411. res.unshift(err);
  7412. callback.apply(self, res);
  7413. }
  7414. };
  7415. }
  7416. function createApplyEach(func) {
  7417. return function applyEach(fns /* arguments */ ) {
  7418. var go = function() {
  7419. var self = this;
  7420. var args = createArray(arguments);
  7421. var callback = args.pop() || noop;
  7422. return func(fns, iterator, callback);
  7423. function iterator(fn, done) {
  7424. fn.apply(self, args.concat([done]));
  7425. }
  7426. };
  7427. if (arguments.length > 1) {
  7428. var args = slice(arguments, 1);
  7429. return go.apply(this, args);
  7430. } else {
  7431. return go;
  7432. }
  7433. };
  7434. }
  7435. /**
  7436. * @see https://github.com/caolan/async/blob/master/lib/internal/DoublyLinkedList.js
  7437. */
  7438. function DLL() {
  7439. this.head = null;
  7440. this.tail = null;
  7441. this.length = 0;
  7442. }
  7443. DLL.prototype._removeLink = function(node) {
  7444. var prev = node.prev;
  7445. var next = node.next;
  7446. if (prev) {
  7447. prev.next = next;
  7448. } else {
  7449. this.head = next;
  7450. }
  7451. if (next) {
  7452. next.prev = prev;
  7453. } else {
  7454. this.tail = prev;
  7455. }
  7456. node.prev = null;
  7457. node.next = null;
  7458. this.length--;
  7459. return node;
  7460. };
  7461. DLL.prototype.empty = DLL;
  7462. DLL.prototype._setInitial = function(node) {
  7463. this.length = 1;
  7464. this.head = this.tail = node;
  7465. };
  7466. DLL.prototype.insertBefore = function(node, newNode) {
  7467. newNode.prev = node.prev;
  7468. newNode.next = node;
  7469. if (node.prev) {
  7470. node.prev.next = newNode;
  7471. } else {
  7472. this.head = newNode;
  7473. }
  7474. node.prev = newNode;
  7475. this.length++;
  7476. };
  7477. DLL.prototype.unshift = function(node) {
  7478. if (this.head) {
  7479. this.insertBefore(this.head, node);
  7480. } else {
  7481. this._setInitial(node);
  7482. }
  7483. };
  7484. DLL.prototype.push = function(node) {
  7485. var tail = this.tail;
  7486. if (tail) {
  7487. node.prev = tail;
  7488. node.next = tail.next;
  7489. this.tail = node;
  7490. tail.next = node;
  7491. this.length++;
  7492. } else {
  7493. this._setInitial(node);
  7494. }
  7495. };
  7496. DLL.prototype.shift = function() {
  7497. return this.head && this._removeLink(this.head);
  7498. };
  7499. DLL.prototype.splice = function(end) {
  7500. var task;
  7501. var tasks = [];
  7502. while (end-- && (task = this.shift())) {
  7503. tasks.push(task);
  7504. }
  7505. return tasks;
  7506. };
  7507. DLL.prototype.remove = function(test) {
  7508. var node = this.head;
  7509. while(node) {
  7510. if (test(node)) {
  7511. this._removeLink(node);
  7512. }
  7513. node = node.next;
  7514. }
  7515. return this;
  7516. };
  7517. /**
  7518. * @private
  7519. */
  7520. function baseQueue(isQueue, worker, concurrency, payload) {
  7521. if (concurrency === undefined) {
  7522. concurrency = 1;
  7523. } else if (isNaN(concurrency) || concurrency < 1) {
  7524. throw new Error('Concurrency must not be zero');
  7525. }
  7526. var workers = 0;
  7527. var workersList = [];
  7528. var _callback, _unshift;
  7529. var q = {
  7530. _tasks: new DLL(),
  7531. concurrency: concurrency,
  7532. payload: payload,
  7533. saturated: noop,
  7534. unsaturated: noop,
  7535. buffer: concurrency / 4,
  7536. empty: noop,
  7537. drain: noop,
  7538. error: noop,
  7539. started: false,
  7540. paused: false,
  7541. push: push,
  7542. kill: kill,
  7543. unshift: unshift,
  7544. remove: remove,
  7545. process: isQueue ? runQueue : runCargo,
  7546. length: getLength,
  7547. running: running,
  7548. workersList: getWorkersList,
  7549. idle: idle,
  7550. pause: pause,
  7551. resume: resume,
  7552. _worker: worker
  7553. };
  7554. return q;
  7555. function push(tasks, callback) {
  7556. _insert(tasks, callback);
  7557. }
  7558. function unshift(tasks, callback) {
  7559. _insert(tasks, callback, true);
  7560. }
  7561. function _exec(task) {
  7562. var item = {
  7563. data: task,
  7564. callback: _callback
  7565. };
  7566. if (_unshift) {
  7567. q._tasks.unshift(item);
  7568. } else {
  7569. q._tasks.push(item);
  7570. }
  7571. nextTick(q.process);
  7572. }
  7573. function _insert(tasks, callback, unshift) {
  7574. if (callback == null) {
  7575. callback = noop;
  7576. } else if (typeof callback !== 'function') {
  7577. throw new Error('task callback must be a function');
  7578. }
  7579. q.started = true;
  7580. var _tasks = isArray(tasks) ? tasks : [tasks];
  7581. if (tasks === undefined || !_tasks.length) {
  7582. if (q.idle()) {
  7583. nextTick(q.drain);
  7584. }
  7585. return;
  7586. }
  7587. _unshift = unshift;
  7588. _callback = callback;
  7589. arrayEachSync(_tasks, _exec);
  7590. }
  7591. function kill() {
  7592. q.drain = noop;
  7593. q._tasks.empty();
  7594. }
  7595. function _next(q, tasks) {
  7596. var called = false;
  7597. return function done(err, res) {
  7598. if (called) {
  7599. throwError();
  7600. }
  7601. called = true;
  7602. workers--;
  7603. var task;
  7604. var index = -1;
  7605. var size = workersList.length;
  7606. var taskIndex = -1;
  7607. var taskSize = tasks.length;
  7608. var useApply = arguments.length > 2;
  7609. var args = useApply && createArray(arguments);
  7610. while (++taskIndex < taskSize) {
  7611. task = tasks[taskIndex];
  7612. while (++index < size) {
  7613. if (workersList[index] === task) {
  7614. workersList.splice(index, 1);
  7615. index = size;
  7616. size--;
  7617. }
  7618. }
  7619. index = -1;
  7620. if (useApply) {
  7621. task.callback.apply(task, args);
  7622. } else {
  7623. task.callback(err, res);
  7624. }
  7625. if (err) {
  7626. q.error(err, task.data);
  7627. }
  7628. }
  7629. if (workers <= q.concurrency - q.buffer) {
  7630. q.unsaturated();
  7631. }
  7632. if (q._tasks.length + workers === 0) {
  7633. q.drain();
  7634. }
  7635. q.process();
  7636. };
  7637. }
  7638. function runQueue() {
  7639. while (!q.paused && workers < q.concurrency && q._tasks.length) {
  7640. var task = q._tasks.shift();
  7641. workers++;
  7642. workersList.push(task);
  7643. if (q._tasks.length === 0) {
  7644. q.empty();
  7645. }
  7646. if (workers === q.concurrency) {
  7647. q.saturated();
  7648. }
  7649. var done = _next(q, [task]);
  7650. worker(task.data, done);
  7651. }
  7652. }
  7653. function runCargo() {
  7654. while (!q.paused && workers < q.concurrency && q._tasks.length) {
  7655. var tasks = q._tasks.splice(q.payload || q._tasks.length);
  7656. var index = -1;
  7657. var size = tasks.length;
  7658. var data = Array(size);
  7659. while (++index < size) {
  7660. data[index] = tasks[index].data;
  7661. }
  7662. workers++;
  7663. nativePush.apply(workersList, tasks);
  7664. if (q._tasks.length === 0) {
  7665. q.empty();
  7666. }
  7667. if (workers === q.concurrency) {
  7668. q.saturated();
  7669. }
  7670. var done = _next(q, tasks);
  7671. worker(data, done);
  7672. }
  7673. }
  7674. function getLength() {
  7675. return q._tasks.length;
  7676. }
  7677. function running() {
  7678. return workers;
  7679. }
  7680. function getWorkersList() {
  7681. return workersList;
  7682. }
  7683. function idle() {
  7684. return q.length() + workers === 0;
  7685. }
  7686. function pause() {
  7687. q.paused = true;
  7688. }
  7689. function _resume() {
  7690. nextTick(q.process);
  7691. }
  7692. function resume() {
  7693. if (q.paused === false) {
  7694. return;
  7695. }
  7696. q.paused = false;
  7697. var count = q.concurrency < q._tasks.length ? q.concurrency : q._tasks.length;
  7698. timesSync(count, _resume);
  7699. }
  7700. /**
  7701. * @param {Function} test
  7702. */
  7703. function remove(test) {
  7704. q._tasks.remove(test);
  7705. }
  7706. }
  7707. /**
  7708. * @memberof async
  7709. * @namespace queue
  7710. */
  7711. function queue(worker, concurrency) {
  7712. return baseQueue(true, worker, concurrency);
  7713. }
  7714. /**
  7715. * @memberof async
  7716. * @namespace priorityQueue
  7717. */
  7718. function priorityQueue(worker, concurrency) {
  7719. var q = baseQueue(true, worker, concurrency);
  7720. q.push = push;
  7721. delete q.unshift;
  7722. return q;
  7723. function push(tasks, priority, callback) {
  7724. q.started = true;
  7725. priority = priority || 0;
  7726. var _tasks = isArray(tasks) ? tasks : [tasks];
  7727. var taskSize = _tasks.length;
  7728. if (tasks === undefined || taskSize === 0) {
  7729. if (q.idle()) {
  7730. nextTick(q.drain);
  7731. }
  7732. return;
  7733. }
  7734. callback = typeof callback === func ? callback : noop;
  7735. var nextNode = q._tasks.head;
  7736. while (nextNode && priority >= nextNode.priority) {
  7737. nextNode = nextNode.next;
  7738. }
  7739. while (taskSize--) {
  7740. var item = {
  7741. data: _tasks[taskSize],
  7742. priority: priority,
  7743. callback: callback
  7744. };
  7745. if (nextNode) {
  7746. q._tasks.insertBefore(nextNode, item);
  7747. } else {
  7748. q._tasks.push(item);
  7749. }
  7750. nextTick(q.process);
  7751. }
  7752. }
  7753. }
  7754. /**
  7755. * @memberof async
  7756. * @namespace cargo
  7757. */
  7758. function cargo(worker, payload) {
  7759. return baseQueue(false, worker, 1, payload);
  7760. }
  7761. /**
  7762. * @memberof async
  7763. * @namespace auto
  7764. * @param {Object} tasks
  7765. * @param {number} [concurrency]
  7766. * @param {Function} [callback]
  7767. */
  7768. function auto(tasks, concurrency, callback) {
  7769. if (typeof concurrency === func) {
  7770. callback = concurrency;
  7771. concurrency = null;
  7772. }
  7773. var keys = nativeKeys(tasks);
  7774. var rest = keys.length;
  7775. var results = {};
  7776. if (rest === 0) {
  7777. return callback(null, results);
  7778. }
  7779. var runningTasks = 0;
  7780. var readyTasks = [];
  7781. var listeners = Object.create(null);
  7782. callback = onlyOnce(callback || noop);
  7783. concurrency = concurrency || rest;
  7784. baseEachSync(tasks, iterator, keys);
  7785. proceedQueue();
  7786. function iterator(task, key) {
  7787. // no dependencies
  7788. var _task, _taskSize;
  7789. if (!isArray(task)) {
  7790. _task = task;
  7791. _taskSize = 0;
  7792. readyTasks.push([_task, _taskSize, done]);
  7793. return;
  7794. }
  7795. var dependencySize = task.length - 1;
  7796. _task = task[dependencySize];
  7797. _taskSize = dependencySize;
  7798. if (dependencySize === 0) {
  7799. readyTasks.push([_task, _taskSize, done]);
  7800. return;
  7801. }
  7802. // dependencies
  7803. var index = -1;
  7804. while (++index < dependencySize) {
  7805. var dependencyName = task[index];
  7806. if (notInclude(keys, dependencyName)) {
  7807. var msg = 'async.auto task `' + key + '` has non-existent dependency `' + dependencyName + '` in ' + task.join(', ');
  7808. throw new Error(msg);
  7809. }
  7810. var taskListeners = listeners[dependencyName];
  7811. if (!taskListeners) {
  7812. taskListeners = listeners[dependencyName] = [];
  7813. }
  7814. taskListeners.push(taskListener);
  7815. }
  7816. function done(err, arg) {
  7817. if (key === null) {
  7818. throwError();
  7819. }
  7820. arg = arguments.length <= 2 ? arg : slice(arguments, 1);
  7821. if (err) {
  7822. rest = 0;
  7823. runningTasks = 0;
  7824. readyTasks.length = 0;
  7825. var safeResults = objectClone(results);
  7826. safeResults[key] = arg;
  7827. key = null;
  7828. var _callback = callback;
  7829. callback = noop;
  7830. _callback(err, safeResults);
  7831. return;
  7832. }
  7833. runningTasks--;
  7834. rest--;
  7835. results[key] = arg;
  7836. taskComplete(key);
  7837. key = null;
  7838. }
  7839. function taskListener() {
  7840. if (--dependencySize === 0) {
  7841. readyTasks.push([_task, _taskSize, done]);
  7842. }
  7843. }
  7844. }
  7845. function proceedQueue() {
  7846. if (readyTasks.length === 0 && runningTasks === 0) {
  7847. if (rest !== 0) {
  7848. throw new Error('async.auto task has cyclic dependencies');
  7849. }
  7850. return callback(null, results);
  7851. }
  7852. while (readyTasks.length && runningTasks < concurrency && callback !== noop) {
  7853. runningTasks++;
  7854. var array = readyTasks.shift();
  7855. if (array[1] === 0) {
  7856. array[0](array[2]);
  7857. } else {
  7858. array[0](results, array[2]);
  7859. }
  7860. }
  7861. }
  7862. function taskComplete(key) {
  7863. var taskListeners = listeners[key] || [];
  7864. arrayEachSync(taskListeners, function(task) {
  7865. task();
  7866. });
  7867. proceedQueue();
  7868. }
  7869. }
  7870. var FN_ARGS = /^(function)?\s*[^\(]*\(\s*([^\)]*)\)/m;
  7871. var FN_ARG_SPLIT = /,/;
  7872. var FN_ARG = /(=.+)?(\s*)$/;
  7873. var STRIP_COMMENTS = /((\/\/.*$)|(\/\*[\s\S]*?\*\/))/mg;
  7874. /**
  7875. * parse function arguments for `autoInject`
  7876. *
  7877. * @private
  7878. */
  7879. function parseParams(func) {
  7880. func = func.toString().replace(STRIP_COMMENTS, '');
  7881. func = func.match(FN_ARGS)[2].replace(' ', '');
  7882. func = func ? func.split(FN_ARG_SPLIT) : [];
  7883. func = func.map(function (arg) {
  7884. return arg.replace(FN_ARG, '').trim();
  7885. });
  7886. return func;
  7887. }
  7888. /**
  7889. * @memberof async
  7890. * @namespace autoInject
  7891. * @param {Object} tasks
  7892. * @param {number} [concurrency]
  7893. * @param {Function} [callback]
  7894. */
  7895. function autoInject(tasks, concurrency, callback) {
  7896. var newTasks = {};
  7897. baseEachSync(tasks, iterator, nativeKeys(tasks));
  7898. auto(newTasks, concurrency, callback);
  7899. function iterator(task, key) {
  7900. var params;
  7901. var taskLength = task.length;
  7902. if (isArray(task)) {
  7903. if (taskLength === 0) {
  7904. throw new Error('autoInject task functions require explicit parameters.');
  7905. }
  7906. params = createArray(task);
  7907. taskLength = params.length - 1;
  7908. task = params[taskLength];
  7909. if (taskLength === 0) {
  7910. newTasks[key] = task;
  7911. return;
  7912. }
  7913. } else if (taskLength === 1) {
  7914. newTasks[key] = task;
  7915. return;
  7916. } else {
  7917. params = parseParams(task);
  7918. if (taskLength === 0 && params.length === 0) {
  7919. throw new Error('autoInject task functions require explicit parameters.');
  7920. }
  7921. taskLength = params.length - 1;
  7922. }
  7923. params[taskLength] = newTask;
  7924. newTasks[key] = params;
  7925. function newTask(results, done) {
  7926. switch (taskLength) {
  7927. case 1:
  7928. task(results[params[0]], done);
  7929. break;
  7930. case 2:
  7931. task(results[params[0]], results[params[1]], done);
  7932. break;
  7933. case 3:
  7934. task(results[params[0]], results[params[1]], results[params[2]], done);
  7935. break;
  7936. default:
  7937. var i = -1;
  7938. while(++i < taskLength) {
  7939. params[i] = results[params[i]];
  7940. }
  7941. params[i] = done;
  7942. task.apply(null, params);
  7943. break;
  7944. }
  7945. }
  7946. }
  7947. }
  7948. /**
  7949. * @memberof async
  7950. * @namespace retry
  7951. * @param {integer|Object|Function} opts
  7952. * @param {Function} [task]
  7953. * @param {Function} [callback]
  7954. */
  7955. function retry(opts, task, callback) {
  7956. var times, intervalFunc, errorFilter;
  7957. var count = 0;
  7958. if (arguments.length < 3 && typeof opts === func) {
  7959. callback = task || noop;
  7960. task = opts;
  7961. opts = null;
  7962. times = DEFAULT_TIMES;
  7963. } else {
  7964. callback = callback || noop;
  7965. switch (typeof opts) {
  7966. case 'object':
  7967. if (typeof opts.errorFilter === func) {
  7968. errorFilter = opts.errorFilter;
  7969. }
  7970. var interval = opts.interval;
  7971. switch (typeof interval) {
  7972. case func:
  7973. intervalFunc = interval;
  7974. break;
  7975. case 'string':
  7976. case 'number':
  7977. interval = +interval;
  7978. intervalFunc = interval ? function() {
  7979. return interval;
  7980. } : function() {
  7981. return DEFAULT_INTERVAL;
  7982. };
  7983. break;
  7984. }
  7985. times = +opts.times || DEFAULT_TIMES;
  7986. break;
  7987. case 'number':
  7988. times = opts || DEFAULT_TIMES;
  7989. break;
  7990. case 'string':
  7991. times = +opts || DEFAULT_TIMES;
  7992. break;
  7993. default:
  7994. throw new Error('Invalid arguments for async.retry');
  7995. }
  7996. }
  7997. if (typeof task !== 'function') {
  7998. throw new Error('Invalid arguments for async.retry');
  7999. }
  8000. if (intervalFunc) {
  8001. task(intervalCallback);
  8002. } else {
  8003. task(simpleCallback);
  8004. }
  8005. function simpleIterator() {
  8006. task(simpleCallback);
  8007. }
  8008. function simpleCallback(err, res) {
  8009. if (++count === times || !err || errorFilter && !errorFilter(err)) {
  8010. if (arguments.length <= 2) {
  8011. return callback(err, res);
  8012. }
  8013. var args = createArray(arguments);
  8014. return callback.apply(null, args);
  8015. }
  8016. simpleIterator();
  8017. }
  8018. function intervalIterator() {
  8019. task(intervalCallback);
  8020. }
  8021. function intervalCallback(err, res) {
  8022. if (++count === times || !err || errorFilter && !errorFilter(err)) {
  8023. if (arguments.length <= 2) {
  8024. return callback(err, res);
  8025. }
  8026. var args = createArray(arguments);
  8027. return callback.apply(null, args);
  8028. }
  8029. setTimeout(intervalIterator, intervalFunc(count));
  8030. }
  8031. }
  8032. function retryable(opts, task) {
  8033. if (!task) {
  8034. task = opts;
  8035. opts = null;
  8036. }
  8037. return done;
  8038. function done() {
  8039. var taskFn;
  8040. var args = createArray(arguments);
  8041. var lastIndex = args.length - 1;
  8042. var callback = args[lastIndex];
  8043. switch (task.length) {
  8044. case 1:
  8045. taskFn = task1;
  8046. break;
  8047. case 2:
  8048. taskFn = task2;
  8049. break;
  8050. case 3:
  8051. taskFn = task3;
  8052. break;
  8053. default:
  8054. taskFn = task4;
  8055. }
  8056. if (opts) {
  8057. retry(opts, taskFn, callback);
  8058. } else {
  8059. retry(taskFn, callback);
  8060. }
  8061. function task1(done) {
  8062. task(done);
  8063. }
  8064. function task2(done) {
  8065. task(args[0], done);
  8066. }
  8067. function task3(done) {
  8068. task(args[0], args[1], done);
  8069. }
  8070. function task4(callback) {
  8071. args[lastIndex] = callback;
  8072. task.apply(null, args);
  8073. }
  8074. }
  8075. }
  8076. /**
  8077. * @memberof async
  8078. * @namespace iterator
  8079. */
  8080. function iterator(tasks) {
  8081. var size = 0;
  8082. var keys = [];
  8083. if (isArray(tasks)) {
  8084. size = tasks.length;
  8085. } else {
  8086. keys = nativeKeys(tasks);
  8087. size = keys.length;
  8088. }
  8089. return makeCallback(0);
  8090. function makeCallback(index) {
  8091. var fn = function() {
  8092. if (size) {
  8093. var key = keys[index] || index;
  8094. tasks[key].apply(null, createArray(arguments));
  8095. }
  8096. return fn.next();
  8097. };
  8098. fn.next = function() {
  8099. return (index < size - 1) ? makeCallback(index + 1) : null;
  8100. };
  8101. return fn;
  8102. }
  8103. }
  8104. /**
  8105. * @memberof async
  8106. * @namespace apply
  8107. */
  8108. function apply(func) {
  8109. switch (arguments.length) {
  8110. case 0:
  8111. case 1:
  8112. return func;
  8113. case 2:
  8114. return func.bind(null, arguments[1]);
  8115. case 3:
  8116. return func.bind(null, arguments[1], arguments[2]);
  8117. case 4:
  8118. return func.bind(null, arguments[1], arguments[2], arguments[3]);
  8119. case 5:
  8120. return func.bind(null, arguments[1], arguments[2], arguments[3], arguments[4]);
  8121. default:
  8122. var size = arguments.length;
  8123. var index = 0;
  8124. var args = Array(size);
  8125. args[index] = null;
  8126. while (++index < size) {
  8127. args[index] = arguments[index];
  8128. }
  8129. return func.bind.apply(func, args);
  8130. }
  8131. }
  8132. /**
  8133. * @memberof async
  8134. * @namespace timeout
  8135. * @param {Function} func
  8136. * @param {number} millisec
  8137. * @param {*} info
  8138. */
  8139. function timeout(func, millisec, info) {
  8140. var callback, timer;
  8141. return wrappedFunc;
  8142. function wrappedFunc() {
  8143. timer = setTimeout(timeoutCallback, millisec);
  8144. var args = createArray(arguments);
  8145. var lastIndex = args.length - 1;
  8146. callback = args[lastIndex];
  8147. args[lastIndex] = injectedCallback;
  8148. simpleApply(func, args);
  8149. }
  8150. function timeoutCallback() {
  8151. var name = func.name || 'anonymous';
  8152. var err = new Error('Callback function "' + name + '" timed out.');
  8153. err.code = 'ETIMEDOUT';
  8154. if (info) {
  8155. err.info = info;
  8156. }
  8157. timer = null;
  8158. callback(err);
  8159. }
  8160. function injectedCallback() {
  8161. if (timer !== null) {
  8162. simpleApply(callback, createArray(arguments));
  8163. clearTimeout(timer);
  8164. }
  8165. }
  8166. function simpleApply(func, args) {
  8167. switch(args.length) {
  8168. case 0:
  8169. func();
  8170. break;
  8171. case 1:
  8172. func(args[0]);
  8173. break;
  8174. case 2:
  8175. func(args[0], args[1]);
  8176. break;
  8177. default:
  8178. func.apply(null, args);
  8179. break;
  8180. }
  8181. }
  8182. }
  8183. /**
  8184. * @memberof async
  8185. * @namespace times
  8186. * @param {number} n - n >= 1
  8187. * @param {Function} iterator
  8188. * @param {Function} callback
  8189. * @example
  8190. *
  8191. * var iterator = function(n, done) {
  8192. * done(null, n);
  8193. * };
  8194. * async.times(4, iterator, function(err, res) {
  8195. * console.log(res); // [0, 1, 2, 3];
  8196. * });
  8197. *
  8198. */
  8199. function times(n, iterator, callback) {
  8200. callback = callback || noop;
  8201. n = +n;
  8202. if (isNaN(n) || n < 1) {
  8203. return callback(null, []);
  8204. }
  8205. var result = Array(n);
  8206. timesSync(n, iterate);
  8207. function iterate(num) {
  8208. iterator(num, createCallback(num));
  8209. }
  8210. function createCallback(index) {
  8211. return function(err, res) {
  8212. if (index === null) {
  8213. throwError();
  8214. }
  8215. result[index] = res;
  8216. index = null;
  8217. if (err) {
  8218. callback(err);
  8219. callback = noop;
  8220. } else if (--n === 0) {
  8221. callback(null, result);
  8222. }
  8223. };
  8224. }
  8225. }
  8226. /**
  8227. * @memberof async
  8228. * @namespace timesSeries
  8229. * @param {number} n - n >= 1
  8230. * @param {Function} iterator
  8231. * @param {Function} callback
  8232. * @example
  8233. *
  8234. * var iterator = function(n, done) {
  8235. * done(null, n);
  8236. * };
  8237. * async.timesSeries(4, iterator, function(err, res) {
  8238. * console.log(res); // [0, 1, 2, 3];
  8239. * });
  8240. *
  8241. */
  8242. function timesSeries(n, iterator, callback) {
  8243. callback = callback || noop;
  8244. n = +n;
  8245. if (isNaN(n) || n < 1) {
  8246. return callback(null, []);
  8247. }
  8248. var result = Array(n);
  8249. var sync = false;
  8250. var completed = 0;
  8251. iterate();
  8252. function iterate() {
  8253. iterator(completed, done);
  8254. }
  8255. function done(err, res) {
  8256. result[completed] = res;
  8257. if (err) {
  8258. callback(err);
  8259. callback = throwError;
  8260. } else if (++completed >= n) {
  8261. callback(null, result);
  8262. callback = throwError;
  8263. } else if (sync) {
  8264. nextTick(iterate);
  8265. } else {
  8266. sync = true;
  8267. iterate();
  8268. }
  8269. sync = false;
  8270. }
  8271. }
  8272. /**
  8273. * @memberof async
  8274. * @namespace timesLimit
  8275. * @param {number} n - n >= 1
  8276. * @param {number} limit - n >= 1
  8277. * @param {Function} iterator
  8278. * @param {Function} callback
  8279. * @example
  8280. *
  8281. * var iterator = function(n, done) {
  8282. * done(null, n);
  8283. * };
  8284. * async.timesLimit(4, 2, iterator, function(err, res) {
  8285. * console.log(res); // [0, 1, 2, 3];
  8286. * });
  8287. *
  8288. */
  8289. function timesLimit(n, limit, iterator, callback) {
  8290. callback = callback || noop;
  8291. n = +n;
  8292. if (isNaN(n) || n < 1 || isNaN(limit) || limit < 1) {
  8293. return callback(null, []);
  8294. }
  8295. var result = Array(n);
  8296. var sync = false;
  8297. var started = 0;
  8298. var completed = 0;
  8299. timesSync(limit > n ? n : limit, iterate);
  8300. function iterate() {
  8301. var index = started++;
  8302. if (index < n) {
  8303. iterator(index, createCallback(index));
  8304. }
  8305. }
  8306. function createCallback(index) {
  8307. return function(err, res) {
  8308. if (index === null) {
  8309. throwError();
  8310. }
  8311. result[index] = res;
  8312. index = null;
  8313. if (err) {
  8314. callback(err);
  8315. callback = noop;
  8316. } else if (++completed >= n) {
  8317. callback(null, result);
  8318. callback = throwError;
  8319. } else if (sync) {
  8320. nextTick(iterate);
  8321. } else {
  8322. sync = true;
  8323. iterate();
  8324. }
  8325. sync = false;
  8326. };
  8327. }
  8328. }
  8329. /**
  8330. * @memberof async
  8331. * @namespace race
  8332. * @param {Array|Object} tasks - functions
  8333. * @param {Function} callback
  8334. * @example
  8335. *
  8336. * // array
  8337. * var called = 0;
  8338. * var tasks = [
  8339. * function(done) {
  8340. * setTimeout(function() {
  8341. * called++;
  8342. * done(null, '1');
  8343. * }, 30);
  8344. * },
  8345. * function(done) {
  8346. * setTimeout(function() {
  8347. * called++;
  8348. * done(null, '2');
  8349. * }, 20);
  8350. * },
  8351. * function(done) {
  8352. * setTimeout(function() {
  8353. * called++;
  8354. * done(null, '3');
  8355. * }, 10);
  8356. * }
  8357. * ];
  8358. * async.race(tasks, function(err, res) {
  8359. * console.log(res); // '3'
  8360. * console.log(called); // 1
  8361. * setTimeout(function() {
  8362. * console.log(called); // 3
  8363. * }, 50);
  8364. * });
  8365. *
  8366. * @example
  8367. *
  8368. * // object
  8369. * var called = 0;
  8370. * var tasks = {
  8371. * 'test1': function(done) {
  8372. * setTimeout(function() {
  8373. * called++;
  8374. * done(null, '1');
  8375. * }, 30);
  8376. * },
  8377. * 'test2': function(done) {
  8378. * setTimeout(function() {
  8379. * called++;
  8380. * done(null, '2');
  8381. * }, 20);
  8382. * },
  8383. * 'test3': function(done) {
  8384. * setTimeout(function() {
  8385. * called++;
  8386. * done(null, '3');
  8387. * }, 10);
  8388. * }
  8389. * };
  8390. * async.race(tasks, function(err, res) {
  8391. * console.log(res); // '3'
  8392. * console.log(called); // 1
  8393. * setTimeout(function() {
  8394. * console.log(called); // 3
  8395. * done();
  8396. * }, 50);
  8397. * });
  8398. *
  8399. */
  8400. function race(tasks, callback) {
  8401. callback = once(callback || noop);
  8402. var size, keys;
  8403. var index = -1;
  8404. if (isArray(tasks)) {
  8405. size = tasks.length;
  8406. while (++index < size) {
  8407. tasks[index](callback);
  8408. }
  8409. } else if (tasks && typeof tasks === obj) {
  8410. keys = nativeKeys(tasks);
  8411. size = keys.length;
  8412. while (++index < size) {
  8413. tasks[keys[index]](callback);
  8414. }
  8415. } else {
  8416. return callback(new TypeError('First argument to race must be a collection of functions'));
  8417. }
  8418. if (!size) {
  8419. callback(null);
  8420. }
  8421. }
  8422. /**
  8423. * @memberof async
  8424. * @namespace memoize
  8425. */
  8426. function memoize(fn, hasher) {
  8427. hasher = hasher || function(hash) {
  8428. return hash;
  8429. };
  8430. var memo = {};
  8431. var queues = {};
  8432. var memoized = function() {
  8433. var args = createArray(arguments);
  8434. var callback = args.pop();
  8435. var key = hasher.apply(null, args);
  8436. if (has(memo, key)) {
  8437. nextTick(function() {
  8438. callback.apply(null, memo[key]);
  8439. });
  8440. return;
  8441. }
  8442. if (has(queues, key)) {
  8443. return queues[key].push(callback);
  8444. }
  8445. queues[key] = [callback];
  8446. args.push(done);
  8447. fn.apply(null, args);
  8448. function done(err) {
  8449. var args = createArray(arguments);
  8450. if (!err) {
  8451. memo[key] = args;
  8452. }
  8453. var q = queues[key];
  8454. delete queues[key];
  8455. var i = -1;
  8456. var size = q.length;
  8457. while (++i < size) {
  8458. q[i].apply(null, args);
  8459. }
  8460. }
  8461. };
  8462. memoized.memo = memo;
  8463. memoized.unmemoized = fn;
  8464. return memoized;
  8465. }
  8466. /**
  8467. * @memberof async
  8468. * @namespace unmemoize
  8469. */
  8470. function unmemoize(fn) {
  8471. return function() {
  8472. return (fn.unmemoized || fn).apply(null, arguments);
  8473. };
  8474. }
  8475. /**
  8476. * @memberof async
  8477. * @namespace ensureAsync
  8478. */
  8479. function ensureAsync(fn) {
  8480. return function( /* ...args, callback */ ) {
  8481. var args = createArray(arguments);
  8482. var lastIndex = args.length - 1;
  8483. var callback = args[lastIndex];
  8484. var sync = true;
  8485. args[lastIndex] = done;
  8486. fn.apply(this, args);
  8487. sync = false;
  8488. function done() {
  8489. var innerArgs = createArray(arguments);
  8490. if (sync) {
  8491. nextTick(function() {
  8492. callback.apply(null, innerArgs);
  8493. });
  8494. } else {
  8495. callback.apply(null, innerArgs);
  8496. }
  8497. }
  8498. };
  8499. }
  8500. /**
  8501. * @memberof async
  8502. * @namespace constant
  8503. */
  8504. function constant( /* values... */ ) {
  8505. var args = [null].concat(createArray(arguments));
  8506. return function(callback) {
  8507. callback = arguments[arguments.length - 1];
  8508. callback.apply(this, args);
  8509. };
  8510. }
  8511. function asyncify(fn) {
  8512. return function( /* args..., callback */ ) {
  8513. var args = createArray(arguments);
  8514. var callback = args.pop();
  8515. var result;
  8516. try {
  8517. result = fn.apply(this, args);
  8518. } catch (e) {
  8519. return callback(e);
  8520. }
  8521. if (result && typeof result.then === func) {
  8522. result.then(function(value) {
  8523. invokeCallback(callback, null, value);
  8524. }, function(err) {
  8525. invokeCallback(callback, err && err.message ? err : new Error(err));
  8526. });
  8527. } else {
  8528. callback(null, result);
  8529. }
  8530. };
  8531. }
  8532. function invokeCallback(callback, err, value) {
  8533. try {
  8534. callback(err, value);
  8535. } catch (e) {
  8536. nextTick(rethrow, e);
  8537. }
  8538. }
  8539. function rethrow(error) {
  8540. throw error;
  8541. }
  8542. /**
  8543. * @memberof async
  8544. * @namespace reflect
  8545. * @param {Function} func
  8546. * @return {Function}
  8547. */
  8548. function reflect(func) {
  8549. return function( /* args..., callback */ ) {
  8550. var callback;
  8551. switch (arguments.length) {
  8552. case 1:
  8553. callback = arguments[0];
  8554. return func(done);
  8555. case 2:
  8556. callback = arguments[1];
  8557. return func(arguments[0], done);
  8558. default:
  8559. var args = createArray(arguments);
  8560. var lastIndex = args.length - 1;
  8561. callback = args[lastIndex];
  8562. args[lastIndex] = done;
  8563. func.apply(this, args);
  8564. }
  8565. function done(err, res) {
  8566. if (err) {
  8567. return callback(null, {
  8568. error: err
  8569. });
  8570. }
  8571. if (arguments.length > 2) {
  8572. res = slice(arguments, 1);
  8573. }
  8574. callback(null, {
  8575. value: res
  8576. });
  8577. }
  8578. };
  8579. }
  8580. /**
  8581. * @memberof async
  8582. * @namespace reflectAll
  8583. * @param {Array[]|Object} tasks
  8584. * @return {Function}
  8585. */
  8586. function reflectAll(tasks) {
  8587. var newTasks, keys;
  8588. if (isArray(tasks)) {
  8589. newTasks = Array(tasks.length);
  8590. arrayEachSync(tasks, iterate);
  8591. } else if (tasks && typeof tasks === obj) {
  8592. keys = nativeKeys(tasks);
  8593. newTasks = {};
  8594. baseEachSync(tasks, iterate, keys);
  8595. }
  8596. return newTasks;
  8597. function iterate(func, key) {
  8598. newTasks[key] = reflect(func);
  8599. }
  8600. }
  8601. /**
  8602. * @memberof async
  8603. * @namespace createLogger
  8604. */
  8605. function createLogger(name) {
  8606. return function(fn) {
  8607. var args = slice(arguments, 1);
  8608. args.push(done);
  8609. fn.apply(null, args);
  8610. };
  8611. function done(err) {
  8612. if (typeof console === obj) {
  8613. if (err) {
  8614. if (console.error) {
  8615. console.error(err);
  8616. }
  8617. return;
  8618. }
  8619. if (console[name]) {
  8620. var args = slice(arguments, 1);
  8621. arrayEachSync(args, function(arg) {
  8622. console[name](arg);
  8623. });
  8624. }
  8625. }
  8626. }
  8627. }
  8628. /**
  8629. * @memberof async
  8630. * @namespace safe
  8631. */
  8632. function safe() {
  8633. createImmediate();
  8634. return exports;
  8635. }
  8636. /**
  8637. * @memberof async
  8638. * @namespace fast
  8639. */
  8640. function fast() {
  8641. createImmediate(false);
  8642. return exports;
  8643. }
  8644. }));