Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Response.json() : créer une réponse JSON

La méthode statique Response.json() crée une réponse contenant des données JSON. Ne la confondez pas avec response.json(), qui lit le corps d’une réponse.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

Response.json(data[, init])

Response.json(data, init) renvoie de façon synchrone un nouvel objet Response avec un corps encodé en JSON. Elle n’envoie aucune requête réseau.

Le paramètre facultatif init définit status, statusText et headers ; le statut par défaut est 200. Content-Type vaut par défaut application/json, sauf si une valeur est explicitement fournie. Les statuts 204, 205 et 304 interdisent un corps et provoquent donc une TypeError.

Ne la confondez pas avec response.json() : cette méthode d’instance consomme le corps et renvoie une Promise contenant la valeur analysée. Il s’agit d’une API Web Fetch, et non d’une fonctionnalité d’une édition particulière d’ECMAScript. Vérifiez typeof Response !== "undefined" && typeof Response.json === "function" ; sa disponibilité dans Node 24 ne prouve pas sa prise en charge par les navigateurs.

Exemples

(async () => {
  const response = Response.json({ name: "Ada" }, { status: 201 });
  console.log(response.status);
  console.log(response.headers.get("Content-Type"));
  const data = await response.json();
  console.log(data.name);
})().catch(console.error);

Résultat

201
application/json
Ada

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources