Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Request — describir una solicitud Fetch

Request representa una solicitud para Fetch. Su constructor prepara la URL, el método, las cabeceras y un cuerpo opcional sin enviar nada. El cuerpo es un flujo: leerlo afecta a la posibilidad de reutilizarlo.

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

Sintaxis

new Request(input, init?)

Request es una API web del Fetch Standard, no un elemento de ECMAScript. new Request(input, init?) no envía nada; pasa la solicitud a fetch().

input acepta una URL u otro objeto Request; init establece opciones como method, headers y body. El método predeterminado es GET. Un cuerpo con GET o HEAD provoca un TypeError.

text() y json() consumen el cuerpo. bodyUsed indica si el flujo del cuerpo está en el estado disturbed, es decir, si se ha empezado a leer o se ha cancelado. Si se cancela el flujo sin haberlo leído, bodyUsed también pasa a true. Llama a clone() antes de leer para obtener una rama de flujo independiente; un cuerpo consumido o bloqueado impide clonarlo.

El ejemplo no usa la red: lee el cuerpo original y el de su copia.

Ejemplos

(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}

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes