Noções Básicas de Processos

7 exemplos para você começar com Processos e Workers - 5 básicos e 2 intermediários.

Pré-requisitos

• Node.js 24.18.0 em um host multi-core para exemplos de cluster.
• Leia Como o Node.js Funciona para o modelo JavaScript de thread única.

Exemplos Básicos

1. process.pid e argv

Identifique o processo em execução e os argumentos da linha de comando.

console.log('pid', process.pid);
console.log('argv', process.argv.slice(2));

• process.pid é único por processo do SO - registre em logs estruturados.
• argv inclui argumentos do usuário após node e o caminho do script.
• Orquestradores de contêiner identificam pods pela combinação de pid + hostname.

Relacionado: os e process - metadados do host

2. Códigos de Saída process.exit

Sinalize sucesso ou falha para shells e CI.

function main(): void {
  const ok = true;
  process.exit(ok ? 0 : 1);
}

• Código de saída 0 é sucesso; não zero falha CI e unidades systemd.
• Prefira a saída natural após a conclusão do trabalho assíncrono - process.exit ignora o flush de I/O.
• Exceções não capturadas saem com código não zero automaticamente.

3. Quando Permanecer no Mesmo Processo

APIs limitadas por I/O não devem criar processos por solicitação.

import { createServer } from 'node:http';
 
createServer(async (req, res) => {
  const data = await fetch('https://example.com').then((r) => r.text());
  res.end(data.slice(0, 100));
}).listen(3000);

• await cede durante o I/O de rede - nenhum processo extra é necessário.
• Criar um processo por solicitação adiciona latência e pressão de descritores de arquivo (FD).
• Aumente a escala de réplicas horizontalmente antes de usar workers por padrão.

Relacionado: Melhores Práticas do Event Loop - mantenha a thread principal responsiva

4. Esboço de worker_threads

Trabalho de CPU fora da thread principal do JavaScript.

import { Worker } from 'node:worker_threads';
 
const worker = new Worker(`
  const { parentPort, workerData } = require('worker_threads');
  parentPort.postMessage(workerData.x * 2);
`, { eval: true, workerData: { x: 21 } });
 
worker.on('message', (msg) => console.log(msg)); // 42

• Workers compartilham a mesma máquina, isolados (V8 isolates) separados.
• workerData clona dados serializáveis no início.
• Prefira um arquivo de worker .ts separado em vez de eval: true em produção.

Relacionado: worker_threads - pools e SharedArrayBuffer

5. Esboço de child_process spawn

Execute ferramentas CLI externas como processos filhos.

import { spawn } from 'node:child_process';
 
const child = spawn('node', ['--version'], { stdio: 'inherit' });
child.on('exit', (code) => console.log('exit', code));

• spawn transmite stdio - bom para rastreamento de logs e ffmpeg.
• Evite shell: true com entrada do usuário - risco de injeção.
• Veja child_process para exec vs spawn.

Exemplos Intermediários

6. cluster para Fan-Out HTTP

Cria processos (forks) de workers para usar múltiplos núcleos de CPU para o loop de aceitação.

import cluster from 'node:cluster';
import { availableParallelism } from 'node:os';
import { createServer } from 'node:http';
 
if (cluster.isPrimary) {
  const cpus = availableParallelism();
  for (let i = 0; i < cpus; i++) cluster.fork();
} else {
  createServer((_req, res) => res.end(`worker ${process.pid}`)).listen(3000);
}

• O processo primário gerencia o ciclo de vida do worker - reinicia em exit em produção.
• Cada worker tem memória isolada - sem cache compartilhado no mesmo processo.
• O Kubernetes geralmente escala pods em vez do módulo cluster.

Relacionado: Módulo cluster - padrões de produção

7. Hook de Encerramento Gracioso

Pare de aceitar trabalho antes de sair em SIGTERM.

process.on('SIGTERM', () => {
  console.log('draining...');
  setTimeout(() => process.exit(0), 2000);
});

• Coordene com server.close() do HTTP e o fim do pool de banco de dados.
• Veja Sinais de Processo e Encerramento para o padrão completo.

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.