Desde o Deno 1.0.0, as APIs do namespace Deno são estáveis. Isso significa que nos esforçaremos para fazer código que funciona na versão 1.0.0 continuar funcionando em versões futuras.

Cronograma de releases, canais e suporte de longo prazo

O Deno lança uma nova versão stable minor (por exemplo, v2.1.0, v2.0.0) em um cronograma de 12 semanas.

Patch releases, incluindo correções de bugs para a versão minor mais recente, são lançadas conforme necessário — você pode esperar várias patch releases antes de uma nova versão minor ser lançada.

Canais de release

O Deno oferece 4 canais de release:

  • stable - uma release semver minor/patch, como descrito acima. Este é o canal de distribuição padrão, recomendado para a maioria dos usuários.
  • lts - suporte de longo prazo para uma release stable específica, recomendado para usuários enterprise que preferem não atualizar com tanta frequência. Veja detalhes abaixo.
  • rc - uma release candidate para a próxima release semver minor.
  • canary - uma release instável que muda várias vezes por dia, permitindo testar correções de bugs e novos recursos mais recentes que podem acabar no canal stable.

Long Term Support (LTS)

:::warning

O suporte LTS será descontinuado depois de 30 de abril de 2026; não haverá releases LTS nem manutenção além dessa data.

:::

O Deno oferece um canal LTS (long-term support). Esta é uma versão semver minor que mantemos apenas com correções retrocompatíveis.

Versão LTS Início da manutenção LTS Fim da manutenção LTS
v2.1 1º de fevereiro de 2025 30 de abril de 2025
v2.2 1º de maio de 2025 31 de outubro de 2025
v2.5 1º de novembro de 2025 30 de abril de 2026

Backports LTS incluem:

  • Patches de segurança
  • Correções críticas de bugs (por exemplo, crashes, computações incorretas)
  • Melhorias de performance críticas podem receber backport com base na severidade.

Mudanças de API e grandes recursos novos não receberão backport.

APIs instáveis

Ao introduzir novas APIs, elas primeiro são marcadas como instáveis. Isso significa que a API pode mudar no futuro. Essas APIs não ficam disponíveis a menos que você passe explicitamente uma flag instável, como --unstable-kv. Saiba mais sobre flags --unstable-*.

Também existem alguns recursos do Deno que não são do runtime e são considerados instáveis, ficando protegidos por flags instáveis. Por exemplo, a flag --unstable-sloppy-imports é usada para permitir import de código sem especificar extensões de arquivo.

Biblioteca padrão

A Biblioteca Padrão do Deno (jsr.io/@std) é em grande parte estável. Todos os módulos da biblioteca padrão na versão 1.0.0 ou superior são considerados estáveis. Todos os outros módulos (0.x) são considerados instáveis e podem mudar no futuro.

Usar módulos instáveis da biblioteca padrão não é recomendado para código de produção, mas é uma ótima forma de experimentar novos recursos e fornecer feedback à equipe do Deno. Não é necessário usar flags instáveis para usar módulos instáveis da biblioteca padrão.