Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Request — descrivere una richiesta Fetch

Request rappresenta una richiesta per Fetch. Il costruttore prepara l’URL, il metodo, le intestazioni e un corpo facoltativo senza inviare nulla. Il corpo è uno stream: leggerlo influisce sulla possibilità di riutilizzarlo.

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

Sintassi

new Request(input, init?)

Request è una Web API del Fetch Standard, non un elemento di ECMAScript. new Request(input, init?) non invia nulla; passa la richiesta a fetch().

input accetta un URL o un altro oggetto Request; init imposta opzioni tra cui method, headers e body. Il metodo predefinito è GET. Un corpo con GET o HEAD genera un TypeError.

text() e json() consumano il corpo. bodyUsed indica se lo stream del corpo è nello stato disturbed, ossia se la lettura è iniziata o se lo stream è stato annullato. Anche annullare lo stream senza averlo letto fa sì che bodyUsed diventi true. Chiama clone() prima di leggere per ottenere un ramo di stream separato; un corpo consumato o bloccato impedisce la clonazione.

L’esempio non usa la rete: legge il corpo originale e quello della sua copia.

Esempi

(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);

Risultato

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

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti