Saltar al contenido principal

utilityProcess

utilityProcess crea un proceso hijo con los puertos de Node.js y Message habilitados. Este proporciona un equivalente al API child_process.fork de Node.js, pero en su lugar usa el API Services de Chromium para lanzar el proceso hijo.

Proceso: principal

Métodos​

utilityProcess.fork(modulePath[, args][, options])​

  • Cadena modulePath - Ruta al script que debe ejecutarse como punto de entrada del proceso hijo.
  • args string[] (opcional) - Listado de argumentos de cadena que deben estar disponibles como process.argv en el proceso hijo.
  • options Object (opcional)
    • Objeto env (opcional) - Pares de clave-valor del entorno. Por defecto es process.env.
    • execArgv string[] (opcional) - Lista de cadenas de argumento enviada al ejecutable.
    • Cadena cwd (opcional) - Directorio actualmente operativo del proceso hijo.
    • stdio (string[] | cadena) (opcional) - Permite configurar el modo para stdout y stderr del proceso hijo. Por defecto es inherit. El valor de la cadena puede ser uno de pipe, ignore, inherit, para más detalles sobre estos valores puede consultar la documentación stdio de Node.js. Actualmente, esta opción sólo soporta configurar stdout y stderr para pipe, inherit o ignore. Configuring stdin to any property other than ignore is not supported and will result in an error. Por ejemplo, los valores soportados se procesarán como:
      • pipe: equivalent to ['ignore', 'pipe', 'pipe']
      • ignore: equivalente a ['ignore', 'ignore', 'ignore']
      • inherit: equivalent to ['ignore', 'inherit', 'inherit'] (the default)
    • serviceName string (optional) - Name of the process that will appear in name property of ProcessMetric returned by app.getAppMetrics and child-process-gone event of app. Por defecto es Node Utility Process.
    • Booleano allowLoadingUnsignedLibraries (opcional) macOS - Con esta bandera, el proceso de utilidad se iniciará por medio del ejecutable de ayuda Electron Helper (Plugin).app en macOS, que puede ser codiseñado con com.apple.security.cs.disable-library-validation y los derechos adicionales de com.apple.security.cs.allow-unsigned-executable-memory. Esto le permitirá al proceso de utilidar cargar librerías sin firmar. A menos que usted necesite específicamente esta característica, es mejor dejar esto desactivado. Por defecto es false.
    • respondToAuthRequestsFromMainProcess boolean (optional) - With this flag, all HTTP 401 and 407 network requests created via the net module will allow responding to them via the app#login event in the main process instead of the default login event on the ClientRequest object. Por defecto es false.

Returns UtilityProcess

Clase: UtilityProcess​

Las instancias de UtilityProcess representan el proceso hijo generado por Chromium con la integración de Node.js.

UtilityProcess es un EventEmitter.

Métodos de Instancia​

child.postMessage(message, [transfer])​

  • mensaje cualquiera
  • transfer 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

Finaliza el proceso con gracia. 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. Until the child process has spawned successfully, the value is undefined. When the child process exits, then the value is undefined after the exit event is emitted.

const child = utilityProcess.fork(path.join(__dirname, 'test.js'))

console.log(child.pid) // undefined

child.on('spawn', () => {
  console.log(child.pid) // Integer
})

child.on('exit', () => {
  console.log(child.pid) // undefined
})

Note: You can use the pid to determine if the process is currently running.

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: 'error' Experimental​

Devuelve:

  • type string - Type of error. Uno de los siguiente valores:
    • FatalError
  • location string - Source location from where the error originated.
  • report string - Node.js diagnostic report.

Emitted when the child process needs to terminate due to non continuable error from V8.

No matter if you listen to the error event, the exit event will be emitted after the child process terminates.

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().