O que é o objeto process e o que ele pode fazer?

Question

Accepted Answer

**`process`** é um objeto global que fornece informações sobre o **processo Node.js atual** e controle sobre ele. É sua interface para o ambiente, argumentos de linha de comando, fluxos de E/S, ciclo de vida e sinais.

## Lendo variáveis de ambiente

```js
process.env.NODE_ENV;        // "production" | "development"
process.env.DATABASE_URL;    // configuration & secrets injected by the environment
const port = process.env.PORT || 3000;
```

`process.env` é o jeito padrão de ler configuração e segredos (definidos fora do código) — central para configuração twelve-factor.

## Argumentos de linha de comando

```js
// node script.js --name=Ann
process.argv; // ["node", "/path/script.js", "--name=Ann"]
const args = process.argv.slice(2); // skip the first two
```

## Fluxos de E/S padrão

```js
process.stdout.write("output
");   // console.log writes here
process.stderr.write("error
");    // console.error writes here
process.stdin.on("data", (chunk) => { /* read input */ });
```

## Ciclo de vida do processo e saída

```js
process.exit(0);   // exit with success code (1 = error)
process.exitCode = 1; // preferred: set code, let the process finish naturally
process.pid;       // the process id
process.cwd();     // current working directory
process.uptime();  // seconds the process has run
```

## Tratamento de sinais e erros não capturados (para encerramento gracioso / redes de segurança)

```js
process.on("SIGTERM", () => { /* clean up, then exit — e.g. on container stop */ });
process.on("SIGINT", () => { /* Ctrl+C */ });
process.on("uncaughtException", (err) => { log(err); process.exit(1); });
process.on("unhandledRejection", (reason) => { log(reason); });
```

Ouvir `SIGTERM`/`SIGINT` é como você implementa **encerramento gracioso** (finaliza solicitações em andamento, fecha conexões com BD antes de sair), e os manipuladores de erros não capturados são redes de segurança de último recurso.

## Outros membros úteis

```js
process.memoryUsage(); // heap stats (leak detection)
process.nextTick(cb);  // schedule a callback before the next event-loop phase
process.platform;      // "linux" | "darwin" | "win32"
```

## Por que isso importa

`process` é a conexão do seu programa com seu ambiente de execução.

Você o usa constantemente: lendo config/segredos via `process.env`, tratando argumentos CLI, e — importante para produção — capturando sinais para encerramento gracioso e manipuladores de erro de último recurso.

Compreendê-lo é essencial para construir aplicações Node configuráveis, robustas e prontas para produção.