0Pricing
TypeScript Academy · Aula

O padrão Result: Ok e Err

Retorne erros como valores em vez de lançá-los

O padrão Result: Ok e Err é uma aula grátis de TypeScript Academy no CoddyKit. Esta é a aula 2 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de TypeScript Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de TypeScript Academy inclui 4 aulas no total.

Boas-vindas

O padrão Resultado retorna erros como valores, permitindo um tratamento de erros seguro quanto aos tipos, sem try/catch.

Tipo Resultado

Defina um tipo Resultado genérico com as variantes Ok e Err.
type Ok<T> = { ok: true; value: T };
type Err<E = Error> = { ok: false; error: E };
type Result<T, E = Error> = Ok<T> | Err<E>;

Construtores auxiliares

Crie os auxiliares ok() e err() para obter um código mais limpo.
const ok = <T>(value: T): Ok<T> => ({ ok: true, value });
const err = <E>(error: E): Err<E> => ({ ok: false, error });

Retornando resultados

Retorne Resultados pelas funções em vez de lançar erros.
async function fetchUser(id: number): Promise<Result<User>> {
  try {
    const user = await db.findUser(id);
    if (!user) return err(new Error('Not found'));
    return ok(user);
  } catch (e) { return err(e as Error); }
}

Consumindo resultados

Verifique o sinalizador ok antes de usar o valor.
const result = await fetchUser(1);
if (result.ok) {
  console.log(result.value.name); // User
} else {
  console.error(result.error.message);
}

Auxiliar mapResult

Aplique um mapeamento sobre um Resultado bem-sucedido para transformar o valor.
function mapResult<T, U, E>(r: Result<T, E>, fn: (v: T) => U): Result<U, E> {
  return r.ok ? ok(fn(r.value)) : r;
}

Auxiliar flatMapResult

Encadeie com segurança funções que retornam Resultados.
function flatMap<T, U, E>(r: Result<T, E>, fn: (v: T) => Result<U, E>): Result<U, E> {
  return r.ok ? fn(r.value) : r;
}

Resultados versus exceções

Exceções são implícitas e não têm tipo. Resultados são valores explícitos na assinatura de tipo.

Suporte de bibliotecas

Bibliotecas como neverthrow, true-myth e fp-ts fornecem tipos Resultado prontos para produção.

Resultado em manipuladores de API

Use Resultados em manipuladores do Express para propagar erros de forma limpa.
app.get('/users/:id', async (req, res) => {
  const result = await fetchUser(parseInt(req.params.id));
  if (result.ok) res.json(result.value);
  else res.status(404).json({ error: result.error.message });
});

Resultados assíncronos

Use uma Promise que contenha um Resultado para combinar operações assíncronas com o padrão Resultado.
type AsyncResult<T, E = Error> = Promise<Result<T, E>>;

Verificação rápida

Qual é a principal vantagem do padrão Resultado em relação ao lançamento de exceções?

Recapitulação

O padrão Resultado: Ok e Err: você aprendeu os principais conceitos deste tópico e como aplicá-los em projetos reais de TypeScript.

Perguntas Frequentes

A aula “O padrão Result: Ok e Err” é grátis?

Sim — o texto completo de “O padrão Result: Ok e Err” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de TypeScript Academy, atualize para CoddyKit PRO. O curso de TypeScript Academy inclui 4 aulas no total.

O que vou aprender em “O padrão Result: Ok e Err”?

Retorne erros como valores em vez de lançá-los Você pratica TypeScript Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar TypeScript Academy?

Nenhuma experiência prévia é necessária. TypeScript Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 2 de 4.

Quanto tempo leva a aula “O padrão Result: Ok e Err”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de TypeScript Academy?

Sim. Cada aula de TypeScript Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

  1. Classes e hierarquias de erros tipadas
  2. O padrão Result: Ok e Err
  3. Restringindo erros capturados (unknown versus Error)
  4. Tratamento de erros em código TypeScript assíncrono
← Voltar para TypeScript Academy