Throwing an Error in jQuery's Deferred object

error-handling, javascript, jquery-deferred, promise

Solution

Now updated for jQuery 1.8+

The easiest way to tackle this is to run the response of `$.ajax` through `.then` to filter based on success or failure of the data.

$.ajax()
    .then(function (response) {
        return $.Deferred(function (deferred) {
            var problem = hasError(response);

            if (problem) {
                return deferred.reject(problem)
            }

            deferred.resolve(response);
        }).promise();
    });

You could then return this new promise to whatever calling code would consume this:

var request = function () {
    return $.ajax()
        .then(function (response) {
            return $.Deferred(function (deferred) {
                var problem = hasError(response);

                if (problem) {
                    return deferred.reject(problem)
                }

                deferred.resolve(response);
            }).promise();
        });
};

request()
    .done(function (response) {
        // handle success
    })
    .fail(function (problem) {
        // handle failure
    });

Problem

I have an `$.ajax` promise and want to check whether my (syntactically valid) response contains an error, triggering the rejected status in that case. I have worked with my own promise library which deals such tasks easily. I do not really like jQuery's Promise (cache) implementation with its `Deferred` object and may have overlooked something, because I seldom use it. I think the way to go is just using `.then()`, which seems to be rather complicated: ``` return $.ajax(...).then(function success(response) { var problem = hasError(response); if (problem) { var error = new $.Deferred; error.reject(problem); return error; } else return response; }); ``` This should return a promise which is rejected in case of network errors or problems with the response. But is returning a rejected deferred really the [only|best|shortest] way to go? I also would appriciate help on how to deal with such "error-throwing response handlers" in the ajax options themselfes, I could not find good documentation about them. Disclaimer: No, I cant change the server responses. The problem-detecting method is synchronous. I don't want to use other libraries, I'm particularly interested in the way jQuery solves this.

Original source