Issue with "Response.json()": Possible exceptions not documented

[ilyvion]

MDN URL: https://developer.mozilla.org/en-US/docs/Web/API/Response/json

What information was incorrect, unhelpful, or incomplete?

This function can raise exceptions, but these are not documented. Try using it on a response that is not actually JSON, e.g.

Specific section or headline?

Exceptions

What did you expect to see?

The list of possible exceptions and their causes. See the fetch documentation for an example of a function that documents its exceptions well.

MDN Content page report details

• Folder: en-us/web/api/response/json
• MDN URL: https://developer.mozilla.org/en-US/docs/Web/API/Response/json
• GitHub URL: https://github.com/mdn/content/blob/main/files/en-us/web/api/response/json/index.md
• Last commit: 93ae23d
• Document last modified: 2022-02-18T09:26:54.000Z

[hamishwillee]

The other response attributes are also missing exceptions - e.g. body, formData, etc - see https://fetch.spec.whatwg.org/#ref-for-dom-body-json%E2%91%A0

The spec looks a bit confusing. It looks like TypeError if the body of the response is unusable. But that maps to "is non-null and its body’s stream is disturbed or locked." - but then it isn't clear what that means - i.e. how code could have ended up in that state and what it means a user is doing wrong.

On top of that it looks like there would also be SyntaxError from parsing the JSON from the body back into a Javascript object, - like this https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/parse#exceptions

Anyone got any real experience on this?