Why does $.getJSON silently fail?

Question

It seems very inconvenient that jQuery's $.getJSON silently fails when the data returned is not valid JSON. Why was this implemented with silent failure? What is the easiest way to perform getJSON with better failure behavior (e.g. throw an exception, console.log(), or whatever)?

While adequate answers were provided for my problem, I'm still baffled that the devs would program silent failure into `$.getJSON`...wtf jQuery guys? — Dan Burton, Mar 30 '11 at 23:26
It's because jQuery is *old*. Before JS had proper debugging tools, or even a console to log to, every failure was either silent, added to the page, or displayed in an `alert()`. Throwing exceptions would have halted the code, and prevented any possible recovery by client code later on; unless every bit of 3rd-party code were wrapped in a try-catch block by the developer. — jpaugh, Apr 24 '18 at 14:36

score 89 · Accepted Answer · edited Sep 12 '16 at 15:25

89

you can use

        function name() {
            $.getJSON("", function(d) {
                alert("success");
            }).done(function(d) {
                alert("done");
            }).fail(function(d) {
                alert("error");
            }).always(function(d) {
                alert("complete");
            });
        }

If you want to see the cause of the error, use the full version

function name() {
    $.getJSON("", function(d) {
        alert("success");
    }).fail( function(d, textStatus, error) {
        console.error("getJSON failed, status: " + textStatus + ", error: "+error)
    });
}

If your JSON is not well-formed, you will see something like

getJSON failed, status: parsererror, error: SyntaxError: JSON Parse error: Unrecognized token '/'

If the URL is wrong, you will see something like

getJSON failed, status: error, error: Not Found

If you are trying to get JSON from another domain, violating the Same-origin policy, this approach returns an empty message. Note that you can work around the Same-origin policy by using JSONP (which has it's limitations) or the preferred method of Cross-origin Resource Sharing (CORS).

edited Sep 12 '16 at 15:25

Community

1
1

answered Apr 27 '12 at 14:01

Mr Shoubs

14,629
17
68
107

3

Note that .error is deprecated - best to use .fail instead: http://api.jquery.com/jQuery.ajax/ – micapam Apr 11 '13 at 02:44
Why you will use this? instead of ajax? while this is a wrap for ajax method right? So basically would be better use Ajax when you want to handle all this "status".. what do you think? – ncubica Jun 05 '13 at 19:44
1

@superluminary: use `fail(function(d, textStatus, error)...` I've just edited the answer. – Sergey Orshanskiy Oct 07 '13 at 21:13
In the case where this is a CORS-related issue (as it was in mine) you will get textStatus='error' and error='' so I'd called this a JSON fail in the design. It should report something back to the developer in this case. Adding the CORS-related response header for my server side fixed this issue and immediately allowed my client to now see the correct JSON returned. – Michael Blankenship Dec 15 '15 at 18:14

score 29 · Answer 2 · answered Mar 30 '11 at 21:48

29

Straight from the documentation:

Important: As of jQuery 1.4, if the JSON file contains a syntax error, the request will usually fail silently.

As the documentation page says, getJSON is simply a shorthand method for

$.ajax({
    url: url,
    dataType: 'json',
    data: data,
    success: callback
});

To get failure behavior, you can use $.ajax like this:

$.ajax({
    url: url,
    dataType: 'json',
    data: data,
    success: callback,
    error: another callback
});

answered Mar 30 '11 at 21:48

Håvard

9,900
1
41
46

3

+1 the shorthand `$.getJSON` was convenient, but not flexible enough to be truly useful. /sigh. – Dan Burton Mar 30 '11 at 23:24
1

The documentation is clear, but this doesn't explain _why_ it silently fails. What is the rationale behind the layer responsible for parsing a String into a JavaScript Object being silent about errors by default? – semperos Jan 18 '12 at 19:22
3

The shorthand is useful with the new promise syntax `$.getJSON(...).error(function() {...})` – Paul Tyng Nov 03 '12 at 19:29

score 3 · Answer 3 · answered Mar 30 '11 at 21:48

3

You can use $.ajax instead, and set the dataType options to "json". From the documentation:

"json": Evaluates the response as JSON and returns a JavaScript object. In jQuery 1.4 the JSON data is parsed in a strict manner; any malformed JSON is rejected and a parse error is thrown. (See json.org for more information on proper JSON formatting.)

answered Mar 30 '11 at 21:48

karim79

339,989
67
413
406

+1 Apparently `$.ajax` also catches the parse error and sends information about it to the `error` callback, as mentioned by Håvard. – Dan Burton Mar 30 '11 at 23:25

score 0 · Answer 4 · edited May 23 '17 at 12:32

0

If you're requesting JSONP as the response, you will get a silent fail if there is no response (e.g. network outage). See this thread for details.

edited May 23 '17 at 12:32

Community

1
1

answered Jan 13 '16 at 17:41

b.squared

1
1
1

score 0 · Answer 5 · answered Mar 30 '11 at 21:48

0

You should have a look at the docs for this API... it has a .error on it.

http://api.jquery.com/jQuery.getJSON/

answered Mar 30 '11 at 21:48

CrazyDart

3,803
2
23
29

1

The .success(), .error(), and .complete() callback methods introduced in jQuery 1.5 are deprecated as of jQuery 1.8. – Jim Bergman Feb 27 '14 at 10:16

Why does $.getJSON silently fail?

5 Answers5

Linked