Node.js 26.10 põe debounce, throttle e parsePKCS12 no core: o que sai do seu package.json
Node.js 26.10 põe debounce, throttle e parsePKCS12 no core: o que sai do seu package.json
O Node.js 26.10.0 levou para a biblioteca padrão duas funções que praticamente todo serviço Node acaba reimplementando: util.debounce() e util.throttle() . Junto com elas vieram util.markPromiseAsHandled() e crypto.parsePKCS12() . O mesmo conjunto de mudanças chegou também à linha 24.x, e a série 26 ("Lithium") já está em Active LTS, com suporte até abril de 2029.
Isso importa menos pelo alívio de "uma dependência a menos" e mais pelo tipo de código que deixa de existir nos repositórios: aquele wrapper de setTimeout / clearTimeout copiado entre arquivos, cada um com uma semântica ligeiramente diferente de cancelamento e de tratamento de erro. Quando o runtime assume essa responsabilidade, o comportamento passa a ser o mesmo em todo o time — e documentado.
O recado prático: vale revisar onde o seu projeto usa lodash.debounce , throttle-debounce ou node-forge só para ler um .p12 , mas a troca não é um sed cego. Abaixo, o que cada API faz e onde a diferença de semântica morde.
O que exatamente entrou no core
util.debounce(fn, wait, options?) — agrupa chamadas repetidas em uma janela de tempo e executa apenas a última. A implementação é Promise-aware e trata AbortSignal para cancelar todas as invocações futuras.
util.throttle(fn, wait, options?) — garante um intervalo mínimo entre execuções, com suporte a fila e limites de concorrência.
Uma opção de borda inicial ( leading ) nas duas: a primeira chamada roda na hora, em vez de esperar a janela fechar.
util.markPromiseAsHandled(promise) — marca explicitamente uma Promise como tratada, evitando o unhandledRejection em código de framework que cria Promises e as entrega adiante.
crypto.parsePKCS12(buffer, passphrase) — devolve a chave privada, o certificado e a cadeia de um bundle .p12 / .pfx , sem passar por openssl em subprocesso.
node:ffi + Virtual File System — o VFS experimental passou a alimentar o carregamento de bibliotecas nativas no node:ffi . Ainda é território experimental; acompanhe, não aposte.
Debounce e throttle, na prática
O caso clássico em back-end é o watcher de arquivos ou o webhook que chega em rajada. Antes:
Depois:
E o throttle para chamadas que precisam de cadência, não de agrupamento:
O detalhe que muda o desenho do código é o signal : antes, cancelar um debounce pendente significava guardar a referência do timer em algum lugar acessível ao teardown. Em servidor que recarrega módulos ou em teste que desmonta fixtures, isso vazava timer e mantinha o processo vivo. Agora o cancelamento é parte do contrato.
Onde o lodash ainda ganha
Aqui entra avaliação, não fato de release: as funções do core cobrem o uso comum, mas não toda a superfície do lodash.debounce . Se o seu código depende de maxWait , de flush() para forçar a execução pendente antes de um shutdown, ou de cancel() para inspecionar estado, confira o que a versão que você vai usar expõe antes de apagar a dependência do package.json .
O caminho de menor risco é gradual: mantenha o lodash, mas troque os usos mais simples — debounce de handler, throttle de log — e observe o comportamento em staging. Em um time médio, essa migração parcial costuma ser mais barata do que reescrever os casos de borda de uma vez.
Em projetos que a Maquinaweb mantém, com serviços em Node.js e TypeScript convivendo com APIs em Python e C#/.NET, esse tipo de decisão passa por um critério simples: só removemos dependência quando a semântica nativa é equivalente ao que o teste já cobre. Caso contrário, o ganho de segurança da cadeia de suprimentos vira risco de regressão silenciosa.
parsePKCS12: o gap que doía no Brasil
Ler certificado A1 em .pfx é rotina em integração fiscal, bancária e de assinatura eletrônica. Até agora, a saída era node-forge , uma biblioteca grande e sem manutenção ativa intensa, ou chamar openssl via child_process — o que significa senha de certificado circulando em argumento de linha de comando.
Dois cuidados que passam batido. Primeiro: process.env para senha é aceitável em container com secret gerenciado, mas evite logar o objeto retornado — a chave privada vai junto. Segundo: o parse é síncrono e custa CPU; faça no bootstrap e guarde o resultado, não a cada requisição.
Riscos e armadilhas
Versão mínima sem engines . Se a API só existe no 26.10+ e o CI roda 22, o erro aparece em produção. Fixe engines.node e teste a matriz de versões de verdade.
Debounce não é rate limit. Ele reduz execuções locais; não protege um recurso externo com múltiplas instâncias da aplicação. Para limite distribuído, continue usando Redis ou o gateway.
Timer não é garantia de execução. A janela é um mínimo, não um contrato de tempo: sob pressão de event loop, a execução atrasa. Não use para agendamento crítico.
Testes com timers falsos. Jest/Vitest precisam avançar o relógio para o debounce disparar. Testes que passavam com o wrapper antigo podem falhar por timeout, não por bug.
Bundle de front-end. node:util não existe no browser. Se o módulo é compartilhado entre servidor e cliente, a troca quebra o build.
markPromiseAsHandled() é ferramenta de framework. Usar para silenciar unhandledRejection em código de aplicação mascara erro real. Ele existe para quem entrega a Promise adiante e sabe que outra camada vai tratar.
Recomendação
Comece pelo inventário: grep por lodash.debounce , throttle-debounce e node-forge no repositório. Para cada ocorrência, verifique se o uso depende de API que o core não cobre. Depois, migre primeiro os casos sem maxWait / flush , rode a suíte com timers falsos e só então remova a dependência. No caso do .p12 , a troca é quase sempre vantajosa: menos código de terceiros manipulando chave privada e nenhum subprocesso com senha na linha de comando.
Se o seu time está avaliando migrar de runtime, rever a camada de utilitários compartilhados ou desenhar um serviço novo com stack Node.js e TypeScript, o time da Maquinaweb pode ajudar a mapear o impacto antes do primeiro commit.
Fontes
Continue lendo
Desenvolvimento Solid 2.0 estável: async dentro do grafo reativo, SolidStart aposentado e 7 APIs a menos
Solid 2.0 chega estável cinco anos depois da 1.0 com Promises no grafo reativo, server functions no core e diagnósticos para agentes. O SolidStart sai de cena e `createResource` e `batch` desaparecem — veja o que muda no código e o que checar antes de migrar.
Ler artigo →
Desenvolvimento Rust 1.100: never type `!` estável, allocator próprio e o Cargo que espera antes de confiar
Rust 1.100 estabiliza o never type `!` e o núcleo da Allocator API, muda o fallback de `()` para `!` nas edições 2015 a 2021 e dá ao Cargo cooldown de dependências e aviso de crates não usadas. Veja o que quebra, como configurar e o custo real de adotar.
Ler artigo →
Desenvolvimento PLAID KARTE expõe 18,29 milhões na JINS e entrega chaves de integração; Puppet 9,4 no KEV e NoisyTCP derruba Linux
Invasão ao KARTE, da PLAID, expõe até 18,29 milhões de contas da JINS e entrega chaves de integração de clientes como MUFG e CAMPFIRE. Na mesma janela, CISA põe o RCE do Puppet Enterprise no KEV e o NoisyTCP derruba servidores Linux com um pacote TCP.
Ler artigo →