utilityProcess
utilityProcess
creates a child process with Node.js and Message ports enabled. It provides the equivalent of child_process.fork
API from Node.js but instead uses Services API from Chromium to launch the child process.
Proceso: principal</0>
Métodos
utilityProcess.fork(modulePath[, args][, options])
modulePath
string - Path to the script that should run as entrypoint in the child process.args
string[] (optional) - List of string arguments that will be available asprocess.argv
in the child process.
Devuelve UtilityProcess
Class: UtilityProcess
Instances of the
UtilityProcess
represent the Chromium spawned child process with Node.js integration.
UtilityProcess
es un EventEmitter.
Métodos de Instancia
child.postMessage(message, [transfer])
mensaje
cualquieratransfer
MessagePortMain[] (optional)
Send a message to the child process, optionally transferring ownership of zero or more MessagePortMain
objects.
Por ejemplo:
// Main process
const { port1, port2 } = new MessageChannelMain()
const child = utilityProcess.fork(path.join(__dirname, 'test.js'))
child.postMessage({ message: 'hello' }, [port1])
// Child process
process.parentPort.once('message', (e) => {
const [port] = e.ports
// ...
})
child.kill()
Devuelve boolean
Terminates the process gracefully. On POSIX, it uses SIGTERM but will ensure the process is reaped on exit. This function returns true if the kill is successful, and false otherwise.
Propiedades de la instancia
child.pid
A Integer | undefined
representing the process identifier (PID) of the child process. If the child process fails to spawn due to errors, then the value is undefined
. When the child process exits, then the value is undefined
after the exit
event is emitted.
child.stdout
A NodeJS.ReadableStream | null
that represents the child process's stdout. If the child was spawned with options.stdio[1] set to anything other than 'pipe', then this will be null
. When the child process exits, then the value is null
after the exit
event is emitted.
// Main process
const { port1, port2 } = new MessageChannelMain()
const child = utilityProcess.fork(path.join(__dirname, 'test.js'))
child.stdout.on('data', (data) => {
console.log(`Received chunk ${data}`)
})
child.stderr
A NodeJS.ReadableStream | null
that represents the child process's stderr. If the child was spawned with options.stdio[2] set to anything other than 'pipe', then this will be null
. When the child process exits, then the value is null
after the exit
event is emitted.
Eventos de Instancia
Event: 'spawn'
Emitted once the child process has spawned successfully.
Event: 'exit'
Devuelve:
code
number - Contains the exit code for the process obtained from waitpid on posix, or GetExitCodeProcess on windows.
Emitted after the child process ends.
Evento: 'message'
Devuelve:
mensaje
cualquiera
Emitted when the child process sends a message using process.parentPort.postMessage()
.