Cinco APIs Integradas do Node.js Que Substituem Pacotes npm

Se você ainda está instalando pacotes npm para requisições HTTP básicas, operações de arquivo ou testes, está adicionando dependências desnecessárias aos seus projetos Node.js. O Node.js moderno (v20+) inclui APIs integradas poderosas que eliminam a necessidade de muitos pacotes populares, reduzindo o tamanho do seu bundle, melhorando a segurança e simplificando a manutenção.

Vamos explorar cinco APIs integradas essenciais do Node.js que podem substituir pacotes npm que você provavelmente está usando agora, com exemplos práticos mostrando exatamente como fazer a transição.

1. fetch() Global Substitui axios e node-fetch

A API nativa fetch, estável desde o Node.js 18, lida com a maioria das requisições HTTP sem dependências externas. Embora pacotes como axios ofereçam conveniências como interceptadores e retentativas automáticas, fetch() cobre a maioria dos casos de uso.

Antes (com axios):

const axios = require('axios');
const response = await axios.get('https://api.github.com/users/nodejs');
console.log(response.data);

Depois (fetch nativo):

const response = await fetch('https://api.github.com/users/nodejs');
const data = await response.json();
console.log(data);

Para timeouts, use AbortController:

const controller = new AbortController();
setTimeout(() => controller.abort(), 5000);
const response = await fetch(url, { signal: controller.signal });

Quando manter o axios: Cadeias complexas de interceptadores, rastreamento de progresso ou retentativas automáticas de requisições.

2. node:test Runner Substitui Jest e Mocha

O test runner integrado (estável e recomendado no Node.js 20+) fornece uma solução de testes sem dependências, perfeita para bibliotecas e aplicações simples.

Antes (com Jest):

// Requer instalação e configuração do jest
describe('Math operations', () => {
  test('adds numbers', () => {
    expect(2 + 2).toBe(4);
  });
});

Depois (node:test nativo):

import { test } from 'node:test';
import assert from 'node:assert';

test('adds numbers', () => {
  assert.strictEqual(2 + 2, 4);
});

Execute os testes com: node --test ou node --test --watch para reexecução automática.

Quando manter o Jest: Testes de snapshot, utilitários extensivos de mock ou necessidades de relatórios de cobertura de código.

3. Auxiliares do Sistema de Arquivos Substituem rimraf, mkdirp e glob

Os métodos modernos do fs lidam com operações recursivas e correspondência de padrões nativamente.

Antes (múltiplos pacotes):

const rimraf = require('rimraf');
const mkdirp = require('mkdirp');
const glob = require('glob');

await rimraf('dist');
await mkdirp('dist/assets');
const files = await glob('src/**/*.js');

Depois (fs nativo):

import { rm, mkdir } from 'node:fs/promises';
import { glob } from 'node:fs';

await rm('dist', { recursive: true, force: true });
await mkdir('dist/assets', { recursive: true });

// Nota: glob() requer Node.js 22+
for await (const file of glob('src/**/*.js')) {
  console.log(file);
}

Esses recursos nativos do Node.js eliminam três dependências com funcionalidade idêntica.

4. crypto.randomUUID() Substitui o Pacote uuid

Gere UUIDs criptograficamente seguros sem o pacote uuid (161M de downloads semanais).

Antes:

const { v4: uuidv4 } = require('uuid');
const id = uuidv4();

Depois:

import { randomUUID } from 'node:crypto';
const id = randomUUID();

Esta API integrada gera UUIDs versão 4 RFC-4122 com as mesmas garantias de segurança do pacote uuid.

Quando manter o uuid: Gerar versões de UUID diferentes da v4 (v1, v3, v5).

5. Cliente WebSocket Substitui o Pacote ws

O Node.js inclui um cliente WebSocket global (estável no Node.js 22+). É adequado para uso no cliente, mas o suporte a WebSocket no lado do servidor ainda requer pacotes como ws.

Antes (com ws):

const WebSocket = require('ws');
const ws = new WebSocket('wss://echo.websocket.org');
ws.on('open', () => ws.send('Hello'));

Depois (WebSocket nativo):

const ws = new WebSocket('wss://echo.websocket.org');
ws.onopen = () => ws.send('Hello');
ws.onmessage = (event) => console.log(event.data);

Quando manter o ws: Implementações de WebSocket no lado do servidor ou uso em produção até que a API se estabilize.

Fazendo a Transição: Considerações Práticas

Antes de substituir pacotes npm por APIs nativas, considere:

• Requisitos de versão do Node.js: Certifique-se de que seu ambiente de produção execute Node.js 20+ (idealmente 22 LTS)
• Paridade de recursos: APIs nativas podem não ter recursos avançados (interceptadores do axios, snapshots do Jest)
• Familiaridade da equipe: Considere as curvas de aprendizado para diferentes APIs

Comece substituindo utilitários simples como randomUUID() e operações do sistema de arquivos. Estes oferecem benefícios imediatos com risco mínimo. Para substituições mais complexas, como frameworks de teste ou clientes HTTP, avalie se os recursos nativos atendem aos seus requisitos específicos.

Conclusão

Essas cinco APIs integradas do Node.js demonstram como a plataforma evoluiu para reduzir a dependência de pacotes externos. Ao aproveitar o fetch nativo, node:test, métodos modernos do fs, utilitários crypto e suporte a WebSocket, você pode reduzir significativamente a pegada de dependências do seu projeto enquanto mantém—ou até melhora—a funcionalidade.

A chave é saber quando as APIs nativas são suficientes e quando pacotes npm especializados ainda fornecem valor. Comece pequeno, teste minuciosamente e migre gradualmente para soluções nativas onde elas fazem sentido para o seu caso de uso.

Perguntas Frequentes

Gain Debugging Superpowers

Unleash the power of session replay to reproduce bugs, track slowdowns and uncover frustrations in your app. Get complete visibility into your frontend with OpenReplay — the most advanced open-source session replay tool for developers. Check our GitHub repo and join the thousands of developers in our community.