Para uma versão ainda mais recente do Node.js (v8.1.4), os eventos e as chamadas são semelhantes ou idênticas às versões mais antigas, mas é recomendável usar os recursos de idioma mais recentes padrão. Exemplos:
Para saída formatada em buffer e sem fluxo (você obtém tudo de uma vez), use child_process.exec
:
const { exec } = require('child_process');
exec('cat *.js bad_file | wc -l', (err, stdout, stderr) => {
if (err) {
// node couldn't execute the command
return;
}
// the *entire* stdout and stderr (buffered)
console.log(`stdout: ${stdout}`);
console.log(`stderr: ${stderr}`);
});
Você também pode usá-lo com o Promises:
const util = require('util');
const exec = util.promisify(require('child_process').exec);
async function ls() {
const { stdout, stderr } = await exec('ls');
console.log('stdout:', stdout);
console.log('stderr:', stderr);
}
ls();
Se você deseja receber os dados gradualmente em partes (saída como um fluxo), use child_process.spawn
:
const { spawn } = require('child_process');
const child = spawn('ls', ['-lh', '/usr']);
// use child.stdout.setEncoding('utf8'); if you want text chunks
child.stdout.on('data', (chunk) => {
// data from standard output is here as buffers
});
// since these are streams, you can pipe them elsewhere
child.stderr.pipe(dest);
child.on('close', (code) => {
console.log(`child process exited with code ${code}`);
});
Ambas as funções têm uma contraparte síncrona. Um exemplo para child_process.execSync
:
const { execSync } = require('child_process');
// stderr is sent to stderr of parent process
// you can set options.stdio if you want it to go elsewhere
let stdout = execSync('ls');
Bem como child_process.spawnSync
:
const { spawnSync} = require('child_process');
const child = spawnSync('ls', ['-lh', '/usr']);
console.log('error', child.error);
console.log('stdout ', child.stdout);
console.log('stderr ', child.stderr);
Nota: O código a seguir ainda está funcional, mas é voltado principalmente para usuários do ES5 e anteriores.
O módulo para gerar processos filhos com o Node.js está bem documentado na documentação (v5.0.0). Para executar um comando e buscar sua saída completa como um buffer, use child_process.exec
:
var exec = require('child_process').exec;
var cmd = 'prince -v builds/pdf/book.html -o builds/pdf/book.pdf';
exec(cmd, function(error, stdout, stderr) {
// command output is in stdout
});
Se você precisar usar E / S de processo de manipulação com fluxos, como quando espera grandes quantidades de saída, use child_process.spawn
:
var spawn = require('child_process').spawn;
var child = spawn('prince', [
'-v', 'builds/pdf/book.html',
'-o', 'builds/pdf/book.pdf'
]);
child.stdout.on('data', function(chunk) {
// output will be here in chunks
});
// or if you want to send output elsewhere
child.stdout.pipe(dest);
Se você estiver executando um arquivo em vez de um comando, convém usar child_process.execFile
quais parâmetros são quase idênticos spawn
, mas tem um quarto parâmetro de retorno de chamada como exec
para recuperar buffers de saída. Isso pode parecer um pouco com isso:
var execFile = require('child_process').execFile;
execFile(file, args, options, function(error, stdout, stderr) {
// command output is in stdout
});
A partir da v0.11.12 , o Nó agora suporta síncrono spawn
e exec
. Todos os métodos descritos acima são assíncronos e têm uma contrapartida síncrona. A documentação para eles pode ser encontrada aqui . Embora sejam úteis para scripts, observe que, diferentemente dos métodos usados para gerar processos filho de forma assíncrona, os métodos síncronos não retornam uma instância de ChildProcess
.