Fale conosco
Desenvolvimento

Node.js 26 vira LTS: o que quebra ao sair da 24 e como auditar antes de subir

44 min de leitura
Node.js 26 vira LTS: o que quebra ao sair da 24 e como auditar antes de subir

Node.js 26 vira LTS: o que quebra ao sair da 24 e como auditar antes de subir

Em 28 de outubro de 2026, a linha 26.x do Node.js passou a Active LTS com a versão 26.13.0, codinome Lithium , com suporte até 30 de abril de 2029. A release de promoção é quase vazia: só atualiza metadados e marca a linha como LTS. O conteúdo que importa está no que entrou desde maio, quando a 26 saiu como Current, e no que foi removido de lá para cá.

Para quem desenvolve, o recado é prático: a 24 entrou em Maintenance e segue com correções até abril de 2028, então não há incêndio. Mas o pulo de 24 para 26 não é trocar a versão no .nvmrc . Três coisas saíram do runtime, o ABI dos addons nativos mudou e a API de data/hora padrão deixou de ser Date . Em times com serviços Express ou NestJS em produção há anos, é onde aparecem os primeiros incidentes.

Vale notar a mudança de calendário: 26 é a última linha do modelo par/ímpar antigo. A partir da 27, toda versão maior vira LTS , o que reduz o número de janelas de migração "obrigatórias" no ano — e aumenta a importância de saber ler release notes com atenção.

O que a 26 traz de novo de fato

O resumo do que mudou em relação à 22 e à 24:

Temporal habilitado por padrão , com o namespace global disponível sem flag.

V8 14.6 (paridade com Chromium 146), Undici 8 no cliente HTTP interno.

require(esm) estável : CommonJS e ESM podem se carregar mutuamente, com a exceção conhecida de módulos com top-level await ( ERR_REQUIRE_ASYNC_MODULE ).

Modelo de permissões estável ( --permission ), útil como cinto de segurança contra dependência comprometida — não como substituto de container.

Globais novos: URLPattern , Web Storage e companhia.

NODE_MODULE_VERSION 147 : todo addon nativo precisa ser recompilado.

TypeScript nativo — e o limite dos enums

A 26 é a primeira LTS em que type stripping é a única forma nativa de rodar TypeScript: a flag --experimental-transform-types foi removida. Na prática, o Node apaga os tipos e executa o resto; ele não transpila sintaxe que gera código em tempo de execução.

A correção é trocar por construções apagáveis:

E, principalmente, deixar o compilador avisar antes do runtime:

Com erasableSyntaxOnly , enum , namespace com código e parameter properties viram erro de compilação em vez de erro de boot em produção. É a mudança de uma linha em tsconfig com o melhor retorno por esforço nessa migração — e um bom primeiro passo em qualquer serviço Node que usa NestJS ou decorators.

As remoções que derrubam processo

Aqui está o que costuma passar batido no npm test verde:

http.Server.prototype.writeHeader() foi removido. Código antigo que chamava res.writeHeader(...) em vez de res.writeHead(...) estoura em runtime, geralmente em middlewares próprios de baixo nível.

Os seis módulos internos _stream_* deixaram de existir. Se alguma dependência transitiva importava node:_stream_readable (comum em pacotes mantidos em modo de manutenção), ela passa a falhar no require .

--experimental-transform-types sumiu, junto com o caminho de transpilação.

Uma leva de APIs marcadas como runtime-deprecated em versões anteriores passou a registrar aviso em cada chamada.

Nada disso aparece em teste unitário que mocka http . Aparece em teste de integração, num endpoint que envia stream grande ou em um relatório de erro.

Temporal por padrão: o Date começa a divergir

Com Temporal global, bibliotecas que fazem feature detection — if (typeof Temporal !== 'undefined') — passam a usar a implementação nativa sem que você tenha decidido isso. É aí que aparecem diferenças de arredondamento em fusos, em somas de meses e no tratamento de horário de verão histórico.

Meu posicionamento: a migração de Date para Temporal não é prioridade do upgrade. Prioridade é saber onde o comportamento mudou sem você pedir . Se o serviço calcula competência, vencimento, folha ou fatura, congele o comportamento com uma flag de desativação da API global no processo durante a janela de migração — o nome exato muda entre releases, então confirme na documentação da versão que você está instalando — e só depois faça a troca de forma consciente.

O custo real: ABI, imagem base e CI

O ponto que mais consome tempo em migração de LTS em empresas de médio porte raramente é a linguagem: é o ABI 147 . Qualquer módulo nativo — driver de banco, biblioteca de imagem, criptografia, node-gyp , sharp , bcrypt e afins — precisa de build compatível. Isso significa:

rebuild de node_modules e não reaproveitamento de cache de CI;

imagem base atualizada em Dockerfile e em pipeline, com a versão fixada por digest, não por latest ;

verificação de que cada dependência nativa publicou binário pré-compilado para a 26 nas plataformas que você suporta (Linux x64/arm64 e, se houver build local, macOS).

Em projetos que a Maquinaweb mantém com stacks que misturam Python, Node.js, .NET e Angular, esse tipo de migração é tratado como mudança de plataforma, não como bump de dependência: entra no roadmap com janela própria, roda primeiro em um serviço de menor risco e ganha rollback definido antes de virar padrão para o resto do time.

Roteiro de migração em ordem

Inventário de remoções : grep por writeHeader , _stream_ , --experimental-transform-types e imports de node:_stream_* no seu código e no de dependências.

TypeScript primeiro : ligue erasableSyntaxOnly na 24. A build quebra hoje, no seu ambiente, e não amanhã no boot da 26.

Addons nativos : liste node-gyp -based e confirme binários para a 26; ajuste a imagem base.

Canário : suba um serviço pequeno na 26 com --permission habilitado em modo permissivo e observe erros de runtime por uma semana.

Cheque semanal de segurança : a 26.13.1, publicada em 11 de novembro, já corrigiu um conjunto de falhas de severidade alta, incluindo um assert alcançável no subsistema HTTP/2 ( CVE-2026-123863 ). Rodar LTS sem patch recente anula o ganho do upgrade.

Só então : Temporal, migração de módulos e limpeza de dívida de require misto com import .

Riscos e o que passa batido

Suíte verde engana : teste que mocka http e driver de banco não pega remoção de API interna nem ABI.

Benchmarks de terceiros pedem contexto : medições independentes em VM única mostram ganhos relevantes em JSON.stringify , filas de await e throughput de node:http , mas números de uma máquina não se transferem para carga real com I/O esperando banco.

Modelo de permissões não é sandbox : ele reduz raio de dano de dependência ruim; não substitui isolamento de container, seccomp ou rede restrita.

Rollback tem prazo : trocar de LTS é fácil; voltar depois de rodar migração de schema ou de código que usa Temporal nativo é bem mais caro.

Recomendação

Para serviços novos, use a 26 já. Para os existentes, trate como um projeto de duas a quatro semanas: comece por erasableSyntaxOnly e inventário de remoções nesta semana, ainda na 24, e agende o canário na 26 com patch de segurança recente. Se o seu time precisa decidir ordem de migração, avaliar risco de stack ou conduzir essa transição sem parar o roadmap, o time da Maquinaweb conversa com você sobre arquitetura, migração de stack e desenvolvimento sob medida — inclusive para colocar esse plano em pé com o time atual.

Fontes

#node.js #javascript #typescript #backend #migração #lts #temporal #esm #docker #ci
Contato

Bora conversar?

Três campos. A resposta vem no WhatsApp.

Ou escreva para contato@maquinaweb.com.br.

Você vai para o WhatsApp com a mensagem pronta. Sem spam, sem lista.

Seus dados seguem a nossa política de privacidade.