Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Request — descrever um pedido Fetch

Request representa um pedido para Fetch. O construtor prepara o URL, o método, os cabeçalhos e um corpo opcional sem enviar nada. O corpo é um fluxo: a sua leitura afeta a possibilidade de o reutilizar.

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

Sintaxe

new Request(input, init?)

Request é uma API Web do Fetch Standard, não um elemento de ECMAScript. new Request(input, init?) não envia nada; passa o pedido a fetch().

input aceita um URL ou outro objeto Request; init define opções como method, headers e body. O método predefinido é GET. Um corpo com GET ou HEAD lança um TypeError.

text() e json() consomem o corpo. bodyUsed indica se o fluxo do corpo está no estado disturbed, ou seja, se a sua leitura foi iniciada ou se o fluxo foi cancelado. Cancelar o fluxo sem o ter lido também faz com que bodyUsed passe a true. Chama clone() antes de ler para obter um ramo de fluxo separado; um corpo consumido ou bloqueado impede a clonagem.

O exemplo não utiliza a rede: lê o corpo original e o da respetiva cópia.

Exemplos

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

Resultado

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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes