jQuery deferred.promise()メソッド
例
ランダムな遅延時間を持つ2つのタイマーを設定し、それぞれ遅延オブジェクトを解決(resolve)と拒否(reject)に使用します
$(function () {
function asyncEvent(){
var dfd = new jQuery.Deferred();
//ランダムな時間間隔の後に Resolve(解決状態)
setTimeout(function(){
dfd.resolve("万歳");
}, Math.floor(400+Math.random()*2000));
//ランダムな時間間隔の後に reject(拒否状態)
setTimeout(function(){
dfd.reject("ごめんなさい");
}, Math.floor(400+Math.random()*2000));
//0.5秒ごとに「working...」メッセージを表示します
setTimeout(function working(){
if ( dfd.state() === "pending" ) {
dfd.notify("working... ");
setTimeout(working, 500);
}
}, 1);
//Promise オブジェクトを返します。呼び出し側は遅延オブジェクトを変更できません。
return dfd.promise();
}
//非同期関数に done、fail、progress ハンドラーを追加します
$.when( asyncEvent() ).then(
function(status){
alert( status+'、順調に進んでいます' );
},
function(status){
alert( status+'、今回は失敗しました' );
},
function(status){
$("body").append(status);
}
);
})
試してみる »
定義と用法
deferred.promise() 関数は Deferred(遅延)の Promise オブジェクトを返します。
注意:1. このメソッドは、非同期関数が内部リクエストの進行(progress)や状態(status)に干渉する他のコードを防止することを可能にします。
2. deferred オブジェクトのメソッド群のみを含みます:done(), then(), fail(), isResolved(), isRejected(), always() など。これらのメソッドは deferred の状態を観察することしかできず、deferred オブジェクトの内部状態を変更することはできません。
3. deferred.promise() は target パラメータも受け入れることができます。その場合、渡された target には Promise のメソッドが付与され、結果として返され、新しいオブジェクトは作成されません。
構文
deferred.promise( [target ] )
| パラメータ | 説明 |
|---|---|
| target | Object型 promise メソッドをバインドするオブジェクト。 |
その他の例
target パラメータを使用する
target パラメータを使用して、既存のオブジェクトを Promise に昇格させます
その他の拡張
jQuery 雑多なメソッド