Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Request — opis żądania Fetch

Request reprezentuje żądanie dla Fetch. Konstruktor przygotowuje adres, metodę, nagłówki i opcjonalną treść, lecz nie wysyła żądania. Treść jest strumieniem: jej odczyt wpływa na możliwość ponownego użycia.

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

Składnia

new Request(input, init?)

Request to Web API z Fetch Standard, nie element ECMAScript. Samo new Request(input, init?) niczego nie wysyła; żądanie można przekazać do fetch().

input przyjmuje adres lub inny Request; init ustawia między innymi method, headers i body. Domyślna metoda to GET. Treść przy GET lub HEAD powoduje TypeError.

text() i json() zużywają treść. bodyUsed wskazuje, czy strumień treści jest w stanie disturbed, czyli czy rozpoczęto jego odczyt lub go anulowano. Anulowanie strumienia bez odczytu również zmienia wartość bodyUsed na true. Wywołaj clone() przed odczytem, aby uzyskać osobną gałąź strumienia; zużyta lub zablokowana treść uniemożliwia klonowanie.

Przykład nie korzysta z sieci: odczytuje treść oryginału i kopii.

Przykłady

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

Wynik

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

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła