W przypadku nowszej wersji Node.js (wersja 8.1.4) zdarzenia i wywołania są podobne lub identyczne jak w starszych wersjach, ale zaleca się korzystanie ze standardowych nowszych funkcji językowych. Przykłady:
W przypadku buforowanych, nie sformatowanych danych wyjściowych (otrzymujesz wszystko naraz), użyj 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}`);
});
Możesz go również używać z Obietnicami:
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();
Jeśli chcesz otrzymywać dane stopniowo we fragmentach (dane wyjściowe jako strumień), użyj 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}`);
});
Obie te funkcje mają synchroniczny odpowiednik. Przykład dla 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');
Jak również 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);
Uwaga: Poniższy kod jest nadal funkcjonalny, ale przede wszystkim jest przeznaczony dla użytkowników ES5 i wcześniejszych.
Moduł do odradzania procesów potomnych za pomocą Node.js jest dobrze udokumentowany w dokumentacji (v5.0.0). Aby wykonać polecenie i pobrać pełne dane wyjściowe jako bufor, użyj 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
});
Jeśli chcesz obsługiwać procesowe operacje we / wy ze strumieniami, na przykład gdy oczekujesz dużej ilości danych wyjściowych, użyj 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);
Jeśli wykonujesz plik zamiast polecenia, możesz użyć tego child_process.execFile
, które parametry są prawie identyczne spawn
, ale mają czwarty parametr wywołania zwrotnego, taki jak exec
do pobierania buforów wyjściowych. Może to wyglądać trochę tak:
var execFile = require('child_process').execFile;
execFile(file, args, options, function(error, stdout, stderr) {
// command output is in stdout
});
Od v0.11.12 Node obsługuje teraz synchroniczne spawn
i exec
. Wszystkie metody opisane powyżej są asynchroniczne i mają synchroniczny odpowiednik. Dokumentację dla nich można znaleźć tutaj . Chociaż są one przydatne w skryptach, zauważ, że w przeciwieństwie do metod używanych do asynchronicznego odradzania procesów potomnych, metody synchroniczne nie zwracają instancji ChildProcess
.