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

CKTIS / JavaScript

fetch — obtención asíncrona de recursos

fetch() obtiene un recurso y devuelve Promise<Response>. Un estado HTTP de error no rechaza automáticamente la promesa; comprueba response.ok.

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

fetch(input, init?) → Promise<Response>

fetch(input, init?) es una API web, no forma parte de ECMAScript. Acepta una URL o un objeto Request; el parámetro opcional init configura la solicitud. Si no se especifica init.method, se usa GET por defecto al pasar una URL, mientras que un objeto Request existente conserva su método (por ejemplo, una solicitud POST sigue siendo POST).

await fetch(...) proporciona un objeto Response, no su contenido ya leído. await response.json() lee y analiza JSON; puede rechazar la promesa. Por lo general, el contenido solo se puede leer una vez.

response.ok significa que el estado está entre 200 y 299. Los estados HTTP 404 y 500 por sí solos no rechazan la promesa; los errores de red sí. En los navegadores se aplica CORS: mode: 'no-cors' no permite leer una respuesta de otro origen.

Ejemplos

async function main() {
  const response = await fetch('data:application/json,%7B%22value%22%3A42%7D');
  if (!response.ok) {
    throw new Error(`HTTP ${response.status}`);
  }
  const data = await response.json();
  console.log(data.value);
}

main().catch(console.error);

Resultado

42

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