Referência rápida

Guia Rápido de APIs Principais do Node.js

Um guia de referencia rapida para as APIs centrais do Node.js: objetos globais, execucao e inicializacao de subprocessos, inspecao e fluxos.

· Publicado

Node.js e um ambiente de execucao JavaScript desenvolvido sobre o motor V8 do Chrome que executa codigo assincrono orientado a eventos.

Variáveis Globais

Variaveis globais comuns em nivel de modulo no CommonJS:

__filename; // Caminho absoluto do arquivo do modulo atual
__dirname;  // Caminho absoluto do diretorio do modulo atual

Subprocessos (Child Processes)

child_process.exec()

Armazena a saida do processo em buffer e passa stdout/stderr para um retorno de chamada (ideal para scripts pequenos):

const { exec } = require('child_process');

exec('ls -la | grep .js', (error, stdout, stderr) => {
  if (error) {
    console.error(`Execution error: ${error.message}`);
    return;
  }
  console.log(`Output: ${stdout}`);
});

child_process.spawn()

Transmite dados do processo em fluxo sem buffer (ideal para processos longos e saidas volumosas):

const { spawn } = require('child_process');

// Herdar stdin/stdout/stderr diretamente no terminal
const child = spawn('npm', ['test'], { stdio: 'inherit' });

child.on('error', (err) => {
  if (err.code === 'ENOENT') console.error('Executavel nao encontrado');
  if (err.code === 'EACCES') console.error('Permissao negada');
});

child.on('exit', (code, signal) => {
  console.log(`Processo finalizado com codigo ${code}`);
});

Formatação e Inspeção (util.inspect)

const util = require('util');

// Inspecionar objetos complexos em profundidade com destaque de sintaxe
const output = util.inspect(complexObject, {
  showHidden: false,
  depth: null,
  colors: true
});

process.stdout.write(output + '\n');

Referências

Temas relacionados