test/unit/deferred.js

   1 module("deferred", { teardown: moduleTeardown });
   2
   3 test("jQuery._Deferred()", function() {
   4
   5         expect( 11 );
   6
   7         var deferred,
   8                 object,
   9                 test;
  10
  11         deferred = jQuery._Deferred();
  12
  13         test = false;
  14
  15         deferred.done( function( value ) {
  16                 equals( value , "value" , "Test pre-resolve callback" );
  17                 test = true;
  18         } );
  19
  20         deferred.resolve( "value" );
  21
  22         ok( test , "Test pre-resolve callbacks called right away" );
  23
  24         test = false;
  25
  26         deferred.done( function( value ) {
  27                 equals( value , "value" , "Test post-resolve callback" );
  28                 test = true;
  29         } );
  30
  31         ok( test , "Test post-resolve callbacks called right away" );
  32
  33         deferred.cancel();
  34
  35         test = true;
  36
  37         deferred.done( function() {
  38                 ok( false , "Cancel was ignored" );
  39                 test = false;
  40         } );
  41
  42         ok( test , "Test cancel" );
  43
  44         deferred = jQuery._Deferred().resolve();
  45
  46         try {
  47                 deferred.done( function() {
  48                         throw "Error";
  49                 } , function() {
  50                         ok( true , "Test deferred do not cancel on exception" );
  51                 } );
  52         } catch( e ) {
  53                 strictEqual( e , "Error" , "Test deferred propagates exceptions");
  54                 deferred.done();
  55         }
  56
  57         test = "";
  58         deferred = jQuery._Deferred().done( function() {
  59
  60                 test += "A";
  61
  62         }, function() {
  63
  64                 test += "B";
  65
  66         } ).resolve();
  67
  68         strictEqual( test , "AB" , "Test multiple done parameters" );
  69
  70         test = "";
  71
  72         deferred.done( function() {
  73
  74                 deferred.done( function() {
  75
  76                         test += "C";
  77
  78                 } );
  79
  80                 test += "A";
  81
  82         }, function() {
  83
  84                 test += "B";
  85         } );
  86
  87         strictEqual( test , "ABC" , "Test done callbacks order" );
  88
  89         deferred = jQuery._Deferred();
  90
  91         deferred.resolveWith( jQuery , [ document ] ).done( function( doc ) {
  92                 ok( this === jQuery && arguments.length === 1 && doc === document , "Test fire context & args" );
  93         });
  94
  95         // #8421
  96         deferred = jQuery._Deferred();
  97         deferred.resolveWith().done(function() {
  98                 ok( true, "Test resolveWith can be called with no argument" );
  99         });
 100 });
 101
 102 test("jQuery.Deferred()", function() {
 103
 104         expect( 10 );
 105
 106         jQuery.Deferred( function( defer ) {
 107                 strictEqual( this , defer , "Defer passed as this & first argument" );
 108                 this.resolve( "done" );
 109         }).then( function( value ) {
 110                 strictEqual( value , "done" , "Passed function executed" );
 111         });
 112
 113         jQuery.Deferred().resolve().then( function() {
 114                 ok( true , "Success on resolve" );
 115         }, function() {
 116                 ok( false , "Error on resolve" );
 117         });
 118
 119         jQuery.Deferred().reject().then( function() {
 120                 ok( false , "Success on reject" );
 121         }, function() {
 122                 ok( true , "Error on reject" );
 123         });
 124
 125         ( new jQuery.Deferred( function( defer ) {
 126                 strictEqual( this , defer , "Defer passed as this & first argument (new)" );
 127                 this.resolve( "done" );
 128         }) ).then( function( value ) {
 129                 strictEqual( value , "done" , "Passed function executed (new)" );
 130         });
 131
 132         ( new jQuery.Deferred() ).resolve().then( function() {
 133                 ok( true , "Success on resolve (new)" );
 134         }, function() {
 135                 ok( false , "Error on resolve (new)" );
 136         });
 137
 138         ( new jQuery.Deferred() ).reject().then( function() {
 139                 ok( false , "Success on reject (new)" );
 140         }, function() {
 141                 ok( true , "Error on reject (new)" );
 142         });
 143
 144         var tmp = jQuery.Deferred();
 145
 146         strictEqual( tmp.promise() , tmp.promise() , "Test deferred always return same promise" );
 147         strictEqual( tmp.promise() , tmp.promise().promise() , "Test deferred's promise always return same promise as deferred" );
 148 });
 149
 150 test("jQuery.when()", function() {
 151
 152         expect( 23 );
 153
 154         // Some other objects
 155         jQuery.each( {
 156
 157                 "an empty string": "",
 158                 "a non-empty string": "some string",
 159                 "zero": 0,
 160                 "a number other than zero": 1,
 161                 "true": true,
 162                 "false": false,
 163                 "null": null,
 164                 "undefined": undefined,
 165                 "a plain object": {}
 166
 167         } , function( message , value ) {
 168
 169                 ok( jQuery.isFunction( jQuery.when( value ).then( function( resolveValue ) {
 170                         strictEqual( resolveValue , value , "Test the promise was resolved with " + message );
 171                 } ).promise ) , "Test " + message + " triggers the creation of a new Promise" );
 172
 173         } );
 174
 175         ok( jQuery.isFunction( jQuery.when().then( function( resolveValue ) {
 176                 strictEqual( resolveValue , undefined , "Test the promise was resolved with no parameter" );
 177         } ).promise ) , "Test calling when with no parameter triggers the creation of a new Promise" );
 178
 179         var cache, i;
 180
 181         for( i = 1 ; i < 4 ; i++ ) {
 182                 jQuery.when( cache || jQuery.Deferred( function() {
 183                         this.resolve( i );
 184                 }) ).then( function( value ) {
 185                         strictEqual( value , 1 , "Function executed" + ( i > 1 ? " only once" : "" ) );
 186                         cache = value;
 187                 }, function() {
 188                         ok( false , "Fail called" );
 189                 });
 190         }
 191 });
 192
 193 test("jQuery.when() - joined", function() {
 194
 195         expect(8);
 196
 197         jQuery.when( 1, 2, 3 ).done( function( a, b, c ) {
 198                 strictEqual( a , 1 , "Test first param is first resolved value - non-observables" );
 199                 strictEqual( b , 2 , "Test second param is second resolved value - non-observables" );
 200                 strictEqual( c , 3 , "Test third param is third resolved value - non-observables" );
 201         }).fail( function() {
 202                 ok( false , "Test the created deferred was resolved - non-observables");
 203         });
 204
 205         var successDeferred = jQuery.Deferred().resolve( 1 , 2 , 3 ),
 206                 errorDeferred = jQuery.Deferred().reject( "error" , "errorParam" );
 207
 208         jQuery.when( 1 , successDeferred , 3 ).done( function( a, b, c ) {
 209                 strictEqual( a , 1 , "Test first param is first resolved value - resolved observable" );
 210                 same( b , [ 1 , 2 , 3 ] , "Test second param is second resolved value - resolved observable" );
 211                 strictEqual( c , 3 , "Test third param is third resolved value - resolved observable" );
 212         }).fail( function() {
 213                 ok( false , "Test the created deferred was resolved - resolved observable");
 214         });
 215
 216         jQuery.when( 1 , errorDeferred , 3 ).done( function() {
 217                 ok( false , "Test the created deferred was rejected - rejected observable");
 218         }).fail( function( error , errorParam ) {
 219                 strictEqual( error , "error" , "Test first param is first rejected value - rejected observable" );
 220                 strictEqual( errorParam , "errorParam" , "Test second param is second rejected value - rejected observable" );
 221         });
 222 });