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

CKTIS / JavaScript

Request — décrire une requête Fetch

Request représente une requête pour Fetch. Son constructeur prépare l’URL, la méthode, les en-têtes et un corps facultatif sans rien envoyer. Le corps est un flux : sa lecture détermine s’il peut être réutilisé.

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

new Request(input, init?)

Request est une API Web issue du Fetch Standard, et non un élément d’ECMAScript. new Request(input, init?) n’envoie rien ; transmettez la requête à fetch().

input accepte une URL ou un autre objet Request ; init définit des options telles que method, headers et body. La méthode par défaut est GET. Un corps avec GET ou HEAD déclenche une TypeError.

text() et json() consomment le corps. bodyUsed indique si le flux du corps est dans l’état disturbed, c’est-à-dire si sa lecture a commencé ou si le flux a été annulé. Même si le flux est annulé sans avoir été lu, bodyUsed passe à true. Appelez clone() avant la lecture pour obtenir une branche de flux distincte ; un corps déjà consommé ou verrouillé empêche le clonage.

L’exemple n’utilise pas le réseau : il lit le corps d’origine et celui de sa copie.

Exemples

(async () => {
  const request = new Request('https://example.org/items', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ id: 7 })
  });
  const copy = request.clone();

  console.log(request.method);
  console.log(request.headers.get('content-type'));
  console.log(request.bodyUsed);
  console.log(await request.text());
  console.log(request.bodyUsed);
  console.log(await copy.text());
})().catch(console.error);

Résultat

POST
application/json
false
{"id":7}
true
{"id":7}

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