jQuery.when()メソッド

jQuery 杂项方法jQuery 雑多なメソッド

実例

$.when() に 1 つの引数が渡されて解決されると、コールバック関数が実行されます。

$(function () { $.when( { testing: 123 } ).done( function(x) { alert(x.testing); } /* alerts "123" */ ); })

試してみる »

定義と使い方

$.when() 関数は、1 つ以上のオブジェクトのコールバック関数を実行する方法を提供します。

ヒント:jQuery.when に Deferred オブジェクトを渡すと、その Promise オブジェクト(Deferred メソッドのサブセット)が返されます。Promise オブジェクトの他のメソッド(例: defered.then)を引き続きバインドできます。Deferred オブジェクトが解決(resolved)または拒否(rejected)されたとき(通常は Deferred オブジェクトを作成した初期コードによって実行されます)、対応するコールバック関数が呼び出されます。


構文

$.when( deferreds )

パラメータ 説明
deferreds Deferred 型: 1 つ以上の Deferred オブジェクト、または通常の JavaScript オブジェクト。


实例

その他の実例


引数を何も渡さない場合、jQuery.when() は resolved(解決)状態の promise オブジェクトを返します。

実例

引数を何も渡さずにコールバック関数を実行します。

[mycode3 type="javascript"] $(function () { $.when().then(function( x ) { alert( "I fired immediately" ); }); }) [/mycode3]

試してみる »

複数の Deferred オブジェクトが jQuery.when() に渡された場合、このメソッドは新しい「ホスト」Deferred オブジェクトを返します。すべての Deferred オブジェクトが解決(resolve)されたときだけ、このメソッドはホストの Deferred オブジェクトを解決します。いずれかの Deferred オブジェクトが拒否(rejected)されたとき、このメソッドはホストの Deferred オブジェクトを拒否します。ホストオブジェクトが解決されると、doneCallbacks(解決コールバック)が実行されます。

実例

複数の Deferred オブジェクトを渡す

[mycode3 type="javascript"] $(function () { var d1 = $.Deferred(); var d2 = $.Deferred(); $.when( d1, d2 ).done(function ( v1, v2 ) { alert( v1 ); // "Fish" alert( v2 ); // "Pizza" }); d1.resolve( "Fish" ); d2.resolve( "Pizza" ); }) [/mycode3]

試してみる »

Deferred オブジェクトの解決(resolved)イベントに値が渡されない場合、対応する doneCallback パラメータは undefined になります。解決イベントに単一の値が渡された場合、対応するパラメータはその値を保持します。解決イベントに複数の値が渡された場合、対応するパラメータはそれらの値からなる配列になります。

実例

異なる型の複数の Deferred オブジェクトを渡す

[mycode3 type="javascript"] $(function () { var d1 = $.Deferred(); var d2 = $.Deferred(); var d3 = $.Deferred(); $.when( d1, d2, d3 ).done(function ( v1, v2, v3 ) { alert( v1 ); // v1 is undefined alert( v2 ); // v2 is "abc" alert( v3 ); // v3 is an array [ 1, 2, 3, 4, 5 ] }); d1.resolve(); d2.resolve( "abc" ); d3.resolve( 1, 2, 3, 4, 5 ); }) [/mycode3]

試してみる »

複数の Deferred の場合、いずれかの Deferred オブジェクトが拒否(rejected)されると、jQuery.when() は即座に「ホスト」Deferred オブジェクトの failCallbacks コールバック関数を呼び出します。

実例

複数の Deferred オブジェクトの 1 つが拒否されたときに failCallbacks コールバック関数を呼び出す

[mycode3 type="javascript"] $(function () { $.when($.ajax("/page1.php"), $.ajax("/page2.php")).then(function(data, textStatus, jqXHR){ alert(jqXHR.status); }, function(obj){ alert(obj.statusText); }); }) [/mycode3]

試してみる »


jQuery 杂项方法jQuery 雑多なメソッド

その他の拡張機能