AngularJSで$httpの返すPromiseにどのようにsuccess / errorが追加されているか調べてみた

応用可能性の低そうなメモ。

AngularJSの\$httpでは、戻り値のpromiseについて、通常のthenのほかに、success / errorを使うことができます。これはどうしてなのでしょうか？AngularJSのpromiseの隠し仕様で、戻り値の関数名を指定することができるのか、それとも隠しメソッドとして、sucess / errorを持っているのか？などと妄想が膨らんでしまいます。

そこで、AngularJSのコードを読んでみると、大したことはなく、

        promise.success = function(fn) {
            promise.then(function(response) {
                fn(response.data, response.status, response.headers, config);
            });
            return promise;
        };
        promise.error = function(fn) {
            promise.then(null, function(response) {
                fn(response.data, response.status, response.headers, config);
            });
            return promise;
        };

上記コードでsuccess, errorが追加されているだけでした。単にthenのシンタックスシュガーというだけでなく、responseオブジェクトを変数に展開する役割を持っていたんですね・・・。となると、これがPromise全般に実装されていないのも納得できます。

さて、これを応用して、promiseではない通常のデータを\$httpと同じ仕様で戻すための変換処理を書くと以下のようになります。\$httpのキャッシング処理を自前で実装するとき（しかも、どうしても\$httpの外側で処理を行いたいとき）に使える方法です。$q.whenというのがまさにこの用途で使われるメソッドなので、そこにsuccess / errorの追加を実装しただけです。

    function httpize(data, status, headers, config){
        var promise = $q.when({
            data: data,
            status: status,
            headers: headers
        })
        promise.success = function(fn) {
            promise.then(function(response) {
                fn(response.data, response.status, response.headers, config);
            });
            return promise;
        };
        promise.error = function(fn) {
            return promise;
        };
        return promise;
    }
    //Demo
    httpize('target data', 200)
        .success(function(data, status){
            console.log(data, status)
        })

ちなみに、本来自分がやりたかったことはこちらで、sucess / errorの実装方法を調べたのもこのためでしたが、応用可能性が低そうなので、タイトルは違うものにしてみました。