Classes de Erro

Todas as classes de erro HTTP estendem BaseHttpError (que estende Error).

BaseHttpError

Classe base abstrata para todos os erros HTTP.

Propriedades

Propriedade	Tipo	Descricao
status	literal (ex: 404)	Codigo de status HTTP
statusText	literal (ex: "Not Found")	Texto do status HTTP
headers	Headers	Cabecalhos da resposta
name	string	Nome da classe de erro (ex: "NotFoundError")

Metodos

Metodo	Tipo de Retorno	Descricao
json<T = unknown>()	Promise<T>	Analisa o corpo da resposta como JSON com parametro de tipo opcional
text()	Promise<string>	Analisa o corpo da resposta como texto
blob()	Promise<Blob>	Analisa o corpo da resposta como Blob
arrayBuffer()	Promise<ArrayBuffer>	Analisa o corpo da resposta como ArrayBuffer
clone()	Mesma classe	Clona o erro para multiplas leituras do body

Propriedades Estaticas

Todas as classes de erro tambem possuem status e statusText estaticos:

import { NotFoundError } from '@pbpeterson/typed-fetch';

NotFoundError.status;     // 404 (literal type)
NotFoundError.statusText; // "Not Found" (literal type)

NetworkError

Representa uma falha em nivel de rede (DNS, conexao recusada, timeout). Diferente dos erros HTTP, NetworkError nao possui status, headers ou corpo de resposta — a requisicao nunca chegou ao servidor.

import { NetworkError } from '@pbpeterson/typed-fetch';

const error = new NetworkError('Connection refused');
error.name;    // "NetworkError"
error.message; // "Connection refused"

Erros de Cliente (4xx)

Class	Status	Status Text
BadRequestError	400	Bad Request
UnauthorizedError	401	Unauthorized
PaymentRequiredError	402	Payment Required
ForbiddenError	403	Forbidden
NotFoundError	404	Not Found
MethodNotAllowedError	405	Method Not Allowed
NotAcceptableError	406	Not Acceptable
ProxyAuthenticationRequiredError	407	Proxy Authentication Required
RequestTimeoutError	408	Request Timeout
ConflictError	409	Conflict
GoneError	410	Gone
LengthRequiredError	411	Length Required
PreconditionFailedError	412	Precondition Failed
RequestTooLongError	413	Payload Too Large
RequestUriTooLongError	414	URI Too Long
UnsupportedMediaTypeError	415	Unsupported Media Type
RequestedRangeNotSatisfiableError	416	Range Not Satisfiable
ExpectationFailedError	417	Expectation Failed
ImATeapotError	418	I'm a teapot
MisdirectedRequestError	421	Misdirected Request
UnprocessableEntityError	422	Unprocessable Entity
LockedError	423	Locked
FailedDependencyError	424	Failed Dependency
TooEarlyError	425	Too Early
UpgradeRequiredError	426	Upgrade Required
PreconditionRequiredError	428	Precondition Required
TooManyRequestsError	429	Too Many Requests
RequestHeaderFieldsTooLargeError	431	Request Header Fields Too Large
UnavailableForLegalReasonsError	451	Unavailable For Legal Reasons

Erros de Servidor (5xx)

Class	Status	Status Text
InternalServerError	500	Internal Server Error
NotImplementedError	501	Not Implemented
BadGatewayError	502	Bad Gateway
ServiceUnavailableError	503	Service Unavailable
GatewayTimeoutError	504	Gateway Timeout
HttpVersionNotSupportedError	505	HTTP Version Not Supported
VariantAlsoNegotiatesError	506	Variant Also Negotiates
InsufficientStorageError	507	Insufficient Storage
LoopDetectedError	508	Loop Detected
NotExtendedError	510	Not Extended
NetworkAuthenticationRequiredError	511	Network Authentication Required

Trabalhando com Corpos de Erro

import { typedFetch, BadRequestError, isHttpError } from '@pbpeterson/typed-fetch';

const { error } = await typedFetch('/api/users');

if (error && isHttpError(error)) {
  // Parsing de JSON tipado
  const details = await error.json<{ message: string; code: string }>();

  // Outros formatos (clone primeiro para multiplas leituras)
  const text = await error.clone().text();
  const blob = await error.clone().blob();
  const buffer = await error.clone().arrayBuffer();

  // Metadados da resposta
  console.log(error.status);                         // 400 (literal)
  console.log(error.statusText);                     // "Bad Request" (literal)
  console.log(error.name);                           // "BadRequestError"
  console.log(error.headers.get('content-type'));     // response header
}

Clonando Erros

Clone um erro para ler o body em multiplos formatos:

if (isHttpError(error)) {
  const cloned = error.clone();

  const json = await error.json();
  const text = await cloned.text();
}