Tratamento de Erros

Classes de Erro Disponiveis

Todas as classes de erro sao exportadas individualmente para tree-shaking. Para detalhes sobre cada codigo de status, veja a Referencia de Status HTTP do MDN.

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

Erros de Rede

Class	Descricao
NetworkError	Conexao recusada, falhas de DNS, timeouts

Tratando Erros com instanceof

import { typedFetch, NotFoundError, UnauthorizedError, NetworkError } from '@pbpeterson/typed-fetch';

type ExpectedErrors = NotFoundError | UnauthorizedError;
const { response, error } = await typedFetch<User, ExpectedErrors>('/api/users/123');

if (error) {
  if (error instanceof NotFoundError) {
    console.log('User not found');
    const details = await error.json<{ message: string }>();
  } else if (error instanceof UnauthorizedError) {
    console.log('Please log in');
  } else if (error instanceof NetworkError) {
    console.log('Network error:', error.message);
  } else {
    // Server errors (5xx)
    console.log('Server error:', error.statusText);
  }
}

Tratando Erros com Type Guards

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

const { error } = await typedFetch<User>('/api/users/123');

if (error) {
  if (isHttpError(error)) {
    // error e restringido para BaseHttpError
    console.log(`${error.name}: ${error.status} ${error.statusText}`);
    const body = await error.json();
  } else if (isNetworkError(error)) {
    // error e restringido para NetworkError
    console.log('Connection failed:', error.message);
  }
}

Corpos de Erro Tipados

O metodo json<T>() aceita um parametro de tipo para tipar o corpo da resposta de erro:

interface ApiError {
  message: string;
  code: string;
  fields?: Record<string, string>;
}

if (error instanceof BadRequestError) {
  const details = await error.json<ApiError>();
  console.log(details.message); // typed as string
  console.log(details.fields);  // typed as Record<string, string> | undefined
}

Propriedades Estaticas

Acesse codigos de status sem criar instancias:

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

console.log(NotFoundError.status);      // 404 (literal type)
console.log(NotFoundError.statusText);  // "Not Found" (literal type)
console.log(BadRequestError.status);    // 400