CKTIS / JavaScript
fetch — obtenção assíncrona de recursos
fetch() obtém um recurso e devolve Promise<Response>. Um estado HTTP de erro não rejeita automaticamente a promessa; verifica response.ok.
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
fetch(input, init?) → Promise<Response>fetch(input, init?) é uma Web API, não faz parte de ECMAScript. Aceita um URL ou um objeto Request; o parâmetro opcional init configura o pedido. Se init.method não for especificado, o método predefinido ao passar um URL é GET, enquanto um objeto Request existente mantém o seu método (por exemplo, um pedido POST continua a ser POST).
await fetch(...) fornece um objeto Response, não o respetivo conteúdo já lido. await response.json() lê e analisa JSON; pode rejeitar a promessa. Em geral, o conteúdo só pode ser lido uma vez.
response.ok significa que o estado está entre 200 e 299. Os estados HTTP 404 e 500, por si só, não rejeitam a promessa; os erros de rede rejeitam-na. Nos browsers aplica-se CORS: mode: 'no-cors' não permite ler uma resposta de outra origem.
Exemplos
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
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.