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

CKTIS / JavaScript

Response.status — código de estado da resposta

Response.status expõe o código numérico de estado de uma resposta. Distinga o estado HTTP, a propriedade ok e a rejeição da promessa fetch().

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

response.status

Response.status é uma propriedade de instância só de leitura que devolve um número. Leia-a como response.status, sem parênteses. Faz parte da norma Fetch, não de ECMAScript.

response.ok indica um estado entre 200 e 299; response.statusText contém a mensagem de estado, não o código. Uma resposta HTTP 404 ou 500, por si só, não rejeita a promessa fetch() — verifique explicitamente o estado.

O estado 0 ocorre com Response.error() e com respostas do tipo opaque e opaqueredirect; não é um código HTTP do servidor. Um erro de rede em fetch() rejeita a promessa em vez de fornecer uma resposta deste tipo.

Exemplos

const responses = [
  new Response(null, { status: 200 }),
  new Response(null, { status: 404 }),
  Response.error()
];

for (const response of responses) {
  console.log(response.status, response.ok);
}

Resultado

200 true
404 false
0 false

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