<\> Casa do Dev
Notícias abrir
Ferramentas abrir
Vagas abrir
Aprender abrir
Comunidade abrir
Guia de Compras abrir

Ky 2.0 chega com melhorias em hooks e validação nativa para seus projetos

DA

4 min

Entusiasta das Tecnologias

Ky 2.0 chega com melhorias em hooks e validação nativa para seus projetos

Com suporte a Node.js 22, validação via Standard Schema e gestão de erros mais robusta, o Ky 2.0 se consolida como uma alternativa leve ao Axios.

Neste artigo

O amadurecimento do Ky 2.0 no ecossistema JavaScript

Para desenvolvedores que buscam uma alternativa mais moderna e leve ao tradicional Axios, o lançamento do Ky 2.0 representa uma mudança importante. Mantido por Sindre Sorhus e sua equipe, o Ky foi construído desde o início para ser um wrapper nativo da Fetch API, eliminando comportamentos inesperados que surgem ao tentar adaptar bibliotecas legadas para o ambiente moderno de requisições HTTP.

Esta nova versão não é apenas uma atualização incremental; ela traz refatorações profundas na forma como lidamos com o ciclo de vida de uma requisição. Se você trabalha com aplicações full-stack em React, Next.js ou Node.js, entender como essas mudanças afetam seu fluxo de dados é fundamental para manter um código mais limpo e seguro.

Hooks unificados e controle de fluxo

A maior mudança estrutural no Ky 2.0 está na unificação dos hooks. Anteriormente, diferentes hooks recebiam parâmetros variados, o que tornava a extensão da biblioteca complexa.

Agora, todos os ganchos (beforeRequest, afterResponse, beforeRetry e beforeError) compartilham um único objeto de estado, contendo request, options e retryCount.

1. O novo hook init

A introdução do hook init permite que você execute lógica global antes de qualquer outra etapa da requisição. Isso é extremamente útil para autenticação centralizada, onde você precisa injetar tokens ou cabeçalhos customizados de forma transparente para o restante da aplicação.

2. Tratamento de erros aprimorado

O hook beforeError agora é disparado para qualquer falha, e não apenas para erros HTTP. Além disso, o objeto HTTPError expõe uma propriedade de dados pré-processada, corrigindo vazamentos de recursos comuns em versões anteriores e permitindo que você leia o corpo do erro sem a necessidade de chamadas assíncronas redundantes.

Gerenciamento inteligente de rede

Lidar com timeouts e tentativas de reenvio costuma ser uma das partes mais frustrantes ao configurar um cliente HTTP. O Ky 2.0 resolve isso de maneira elegante com a introdução do totalTimeout, que limita a duração total da operação, incluindo todos os processos de retentativa.

Resposta rapida: O totalTimeout garante que sua aplicação não fique pendurada indefinidamente, mesmo com múltiplas tentativas de retry automáticas. Isso protege a experiência do usuário final, especialmente em conexões móveis instáveis ou redes corporativas com latência elevada.

Validação de schema nativa

A integração com o ecossistema de validação é talvez a feature mais aguardada pelos desenvolvedores que utilizam TypeScript. Com suporte ao padrão Standard Schema, o método .json() agora permite validar respostas automaticamente utilizando bibliotecas como Zod ou Valibot.

FeatureVantagem no Ky 2.0
Schema ValidationTipagem automática e validação de dados em tempo real
Total TimeoutControle total sobre a duração da operação completa
URL HandlingSeparação clara entre prefix e baseUrl
NetworkErrorRetry apenas para falhas reais de rede (DNS, conexão recusada)

O que esperar daqui para frente

Se você já utiliza o Ky em seus projetos, é importante notar que a versão 2.0 exige Node.js 22 e altera o comportamento padrão de respostas vazias, que agora lançam exceções. A transição para o novo modelo de estado nos hooks exige um pequeno esforço de refatoração, mas o ganho em manutenibilidade a longo prazo é inegável.

A comunidade de desenvolvedores tem recebido as mudanças positivamente, destacando a facilidade de migrar de bibliotecas mais pesadas e a confiabilidade de usar algo nativo ao Fetch.

Como o mercado brasileiro tem adotado cada vez mais o Next.js e o uso de Edge Functions, ter uma ferramenta leve e com suporte a TypeScript nativo coloca o Ky como uma escolha estratégica para o futuro de qualquer stack JavaScript.

Perguntas frequentes

O Ky 2.0 é melhor que o Axios?

O Ky é projetado nativamente para a Fetch API, o que garante menor tamanho de bundle e melhor performance em ambientes modernos como Bun, Deno e Node.js 22. O Axios é mais consolidado para sistemas legados, enquanto o Ky foca em modernidade.

É obrigatório usar Zod com o novo schema validation?

Não. O Ky 2.0 utiliza o padrão Standard Schema, permitindo o uso de qualquer biblioteca compatível, como Zod, Valibot ou ArkType, oferecendo flexibilidade total na escolha da sua ferramenta de validação.

Como migrar de versões anteriores?

A equipe do Ky disponibilizou um guia de migração detalhado nas notas de lançamento. As mudanças principais envolvem a atualização da assinatura dos hooks para o objeto de estado único e a leitura de dados de erro através da propriedade error.data.

Produtos relacionados

Este conteúdo tem links de afiliado: se você comprar por eles, podemos receber uma comissão sem custo extra para você. A escolha dos produtos segue critérios próprios e não é influenciada por comissão.

O que você achou deste artigo?

Responda a Pergunta do Dia Teste seu conhecimento e mantenha sua streak. Crie seu Dev Card público Perfil dev compartilhável em um único link.

Depois dessa formação...

Veja vagas em tecnologia →

Vagas relacionadas

Ver todas as vagas →
DA

Escrito por

Dagmar Cirino

Entusiasta das Tecnologias

Atualizado em 06/10/2026 •

Sou o Cirino, e desenvolvo soluções e produtos utilizando linguagens de programação e ferramentas de analytics e monitoração baseadas em Cloud. Trabalho com tecnologia desde 2010,...

Ver perfil do autor

COMPARTILHAR