Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Request — popis požadavku Fetch

Request představuje požadavek pro Fetch. Jeho konstruktor připraví URL, metodu, hlavičky a volitelné tělo, ale nic neodešle. Tělo je proud: jeho čtení ovlivňuje, zda ho lze znovu použít.

Verze: 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 je webové API ze standardu Fetch Standard, nikoli součást ECMAScriptu. new Request(input, init?) nic neodesílá; požadavek předejte funkci fetch().

input přijímá URL nebo jiný objekt Request; init nastavuje možnosti, například method, headers a body. Výchozí metoda je GET. Tělo u GET nebo HEAD vyvolá TypeError.

text() a json() tělo spotřebují. bodyUsed udává, zda je proud těla ve stavu disturbed, tedy zda už začalo jeho čtení nebo byl proud zrušen. I zrušení proudu bez čtení změní hodnotu bodyUsed na true. Před čtením zavolejte clone(), abyste získali samostatnou větev proudu; spotřebované nebo uzamčené tělo klonování znemožňuje.

Příklad nepoužívá síť: čte původní tělo a tělo jeho kopie.

Příklady

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

Výsledek

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

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje