O significado de um recurso depreciado
Depreciação é a indicação de que um projeto desaconselha o uso de um recurso de software. A função ou opção pode continuar disponível, mas sua documentação sinaliza a necessidade de rever o uso. O termo aparece em inglês como deprecated e, neste caso, se refere à manutenção do software, sem o sentido contábil de perda de valor de um bem.
No Node.js, o índice de estabilidade classifica os recursos depreciados no nível 0. Eles podem emitir avisos e não têm garantia de compatibilidade retroativa. A indicação exige consultar o histórico do recurso na versão utilizada, porque a depreciação e a retirada são etapas diferentes.
Uma substituição depende da entrada
O construtor new Buffer() é um exemplo documentado de depreciação no Node.js, identificado pelo código DEP0005. Ele aceitava tipos diferentes de entrada na mesma chamada. As alternativas separam a criação de um buffer a partir de conteúdo da reserva de memória por tamanho.
Para converter um texto em bytes, este exemplo usa a alternativa Buffer.from():
const conteudo = Buffer.from('teste', 'utf8')console.log(conteudo.toString('utf8'))A entrada é o texto teste, convertido para um buffer com codificação UTF-8. A saída é teste, pois toString() converte o conteúdo de volta para texto usando a mesma codificação. Para reservar dez bytes inicializados com zeros, a alternativa é Buffer.alloc(10). Substituir qualquer chamada antiga por Buffer.from() seria incorreto quando o argumento numérico indicava o tamanho da memória desejada, conforme a documentação da DEP0005.
Avisos e compatibilidade
O Node.js distingue depreciações presentes apenas na documentação das que geram mensagens durante a execução. O código continuar funcionando ou não exibir aviso no terminal não confirma que o recurso continua recomendado. Você precisa conferir a entrada correspondente na documentação e localizar a chamada no código da aplicação ou da dependência indicada.
Quando houver uma alternativa, compare os tipos aceitos e o resultado produzido antes de alterar a chamada. A ausência do aviso depois da troca deve vir acompanhada de uma verificação do comportamento da aplicação. Ocultar a mensagem mantém o uso antigo e não esclarece se uma atualização futura ainda o aceitará.
Dúvidas frequentes
Perguntas frequentes sobre depreciação
- Um recurso depreciado já foi removido?
- A depreciação comunica que o uso foi desaconselhado. A remoção retira o recurso da versão correspondente. Consulte o histórico do item para saber se ele ainda existe na versão que você utiliza.
- Todo recurso depreciado emite aviso no terminal?
- No Node.js, há depreciações registradas apenas na documentação e outras que emitem avisos durante a execução. A emissão também pode depender das opções de execução e da origem da chamada.
- Existe um prazo fixo entre a depreciação e a remoção?
- O prazo depende da política do projeto e do histórico do recurso. A indicação de depreciação, por si só, não informa uma data de retirada nem confirma uma substituição compatível com todos os usos.
Para continuar
Recursos relacionados
Documentação
Node.js: estabilidade e recursos depreciados
Explica o nível de estabilidade 0 do Node.js, os possíveis avisos e a ausência de garantia de compatibilidade retroativa.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Orientação ao vivo para localizar uma chamada depreciada e testar sua substituição, com você operando o código e o terminal.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Ao atualizar uma dependência com agentes, você precisa reconhecer os recursos depreciados e testar se a substituição preserva o comportamento da aplicação.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.