jQuery.when()メソッド
実例
$.when() に 1 つの引数が渡されて解決されると、コールバック関数が実行されます。
試してみる »
定義と使い方
$.when() 関数は、1 つ以上のオブジェクトのコールバック関数を実行する方法を提供します。
ヒント:jQuery.when に Deferred オブジェクトを渡すと、その Promise オブジェクト(Deferred メソッドのサブセット)が返されます。Promise オブジェクトの他のメソッド(例: defered.then)を引き続きバインドできます。Deferred オブジェクトが解決(resolved)または拒否(rejected)されたとき(通常は Deferred オブジェクトを作成した初期コードによって実行されます)、対応するコールバック関数が呼び出されます。
構文
| パラメータ | 説明 |
|---|---|
| deferreds | Deferred 型: 1 つ以上の Deferred オブジェクト、または通常の JavaScript オブジェクト。 |
その他の実例
引数を何も渡さない場合、jQuery.when() は resolved(解決)状態の promise オブジェクトを返します。
実例
引数を何も渡さずにコールバック関数を実行します。
試してみる »
複数の Deferred オブジェクトが jQuery.when() に渡された場合、このメソッドは新しい「ホスト」Deferred オブジェクトを返します。すべての Deferred オブジェクトが解決(resolve)されたときだけ、このメソッドはホストの Deferred オブジェクトを解決します。いずれかの Deferred オブジェクトが拒否(rejected)されたとき、このメソッドはホストの Deferred オブジェクトを拒否します。ホストオブジェクトが解決されると、doneCallbacks(解決コールバック)が実行されます。
実例
複数の Deferred オブジェクトを渡す
試してみる »
Deferred オブジェクトの解決(resolved)イベントに値が渡されない場合、対応する doneCallback パラメータは undefined になります。解決イベントに単一の値が渡された場合、対応するパラメータはその値を保持します。解決イベントに複数の値が渡された場合、対応するパラメータはそれらの値からなる配列になります。
実例
異なる型の複数の Deferred オブジェクトを渡す
試してみる »
複数の Deferred の場合、いずれかの Deferred オブジェクトが拒否(rejected)されると、jQuery.when() は即座に「ホスト」Deferred オブジェクトの failCallbacks コールバック関数を呼び出します。
実例
複数の Deferred オブジェクトの 1 つが拒否されたときに failCallbacks コールバック関数を呼び出す
試してみる »
その他の拡張機能
jQuery 雑多なメソッド