Noções Básicas de APIs Embutidas

8 exemplos para você começar com as APIs embutidas do Node - 6 básicos e 2 intermediários.

Pré-requisitos

• Node.js 24.18.0 - embutidos vêm com o runtime.
• Prefira import from 'node:…' em projetos ESM.

Exemplos Básicos

1. Importação com Prefixo node:

Importe embutidos explicitamente e evite sombreamento.

import { readFile } from 'node:fs/promises';
import { createServer } from 'node:http';
import path from 'node:path';

• O prefixo node: é opcional, mas recomendado em código de aplicação.
• Embutidos não estão nas dependências do package.json.
• Tipagens vêm de @types/node em devDependencies.

2. fs/promises readFile

Leitura de arquivo assíncrona sem util.promisify.

import { readFile } from 'node:fs/promises';
 
const pkg = JSON.parse(await readFile('package.json', 'utf8'));
console.log(pkg.name);

• Sempre especifique a codificação para texto ou obtenha um Buffer.
• Use createReadStream para arquivos grandes.
• Trate ENOENT com try/catch para arquivos de configuração opcionais.

Relacionado: fs e fs/promises - streams e flags

3. path.join e fileURLToPath

Caminhos portáteis em ESM sem __dirname.

import path from 'node:path';
import { fileURLToPath } from 'node:url';
 
const __filename = fileURLToPath(import.meta.url);
const configPath = path.join(path.dirname(__filename), 'config.json');

• path.join normaliza separadores para a plataforma.
• Nunca concatene caminhos com / manualmente em código de biblioteca.
• Use path.posix.join para chaves de armazenamento de objetos em todas as plataformas.

Relacionado: path e url - URL vs caminho

4. Servidor node:http

HTTP mínimo sem Express.

import { createServer } from 'node:http';
 
createServer((req, res) => {
  res.writeHead(200, { 'content-type': 'text/plain' });
  res.end('ok');
}).listen(3000);

• Bom para health checks e sondas internas.
• APIs de produção geralmente adicionam Express 5 ou Fastify 5 para roteamento.
• Defina timeouts no servidor (server.requestTimeout) no Node 24.

5. crypto.randomUUID

Identificadores sem o pacote uuid.

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

• UUID v4 criptograficamente forte.
• Também randomBytes para tokens - codifique como base64url.
• Veja crypto para hashing e HMAC.

6. timers/promises sleep

Atraso baseado em Promise sem npm.

import { setTimeout } from 'node:timers/promises';
 
await setTimeout(100);
console.log('após o atraso');

• Aceita AbortSignal para atrasos canceláveis.
• setInterval ainda é baseado em callback para trabalho periódico.
• Veja Timers e Scheduler.

Exemplos Intermediários

7. fetch (embutido)

Cliente HTTP sem axios para chamadas de saída simples.

const res = await fetch('https://nodejs.org/dist/index.json');
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();

• fetch global no Node 24 - mesma API que navegadores.
• Configure agentes/timeouts via opções do undici quando necessário.
• Para políticas avançadas de retentativa veja got/axios.

8. util.parseEnv e styleText (Node 24)

Utilitários modernos para env e saída de CLI.

import { parseEnv } from 'node:util';
import { styleText } from 'node:util';
 
const env = parseEnv('PORT=3000\nNODE_ENV=production');
console.log(styleText('green', 'boot'), env.PORT);

• parseEnv analisa strings estilo dotenv em memória.
• Prefira Zod para validação de env de produção.
• Veja util e diagnostics.

Relacionado: Zod em Limites - valide env

Versões da Stack: Esta página foi escrita para Node.js 24.18.0 (Active LTS), npm 10+, TypeScript 5.6+, Express 5, Fastify 5, e NestJS 11.