Syntax

json()

Parameters

None.

Return value

A Promise that resolves to a JavaScript object. This object could be anything that can be represented by JSON — an object, an array, a string, a number…

Exceptions

TypeError

Thrown for one of the following reasons:

• The request body is disturbed or locked.
• There was an error decoding the body content (for example, because the Content-Encoding header is incorrect).

SyntaxError

The request body cannot be parsed as JSON.

Examples

const obj = { hello: "world" };
const request = new Request("/myEndpoint", {
  method: "POST",
  body: JSON.stringify(obj),
});
request.json().then((data) => {
  // do something with the data sent in the request
});

Specifications

Browser compatibility

See also

• Response.json()