utilityProcess

utilityProcess 创建一个启用了 Node.js 和消息端口的子进程。它提供了 Node.js 中的 child_process.fork API 的等效功能，但使用 Chromium 中的 Services API 启动子进程。

进程：主进程

方法

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

• modulePath string - 应该作为子进程中的入口点运行的脚本的路径。
• args string[] (可选) - 将作为子进程中的 process.argv 提供的字符串参数列表。
• options Object (可选)
  • env Object (可选) - 环境变量键值对。默认为 process.env。
  • execArgv string[] (可选) - 传递给可执行文件的字符串参数列表。
  • cwd string (可选) - 子进程的当前工作目录。
  • stdio (string[] | string) (可选) - 允许配置子进程的 stdout 和 stderr 的模式。 默认值为 inherit。字符串值可以是 pipe、ignore、inherit 之一，有关这些值的更多详细信息，您可以参考 Node.js 的 stdio 文档。 当前，此选项仅支持将 stdout 和 stderr 配置为 pipe、inherit 或 ignore。 不支持将 stdin 配置为除 ignore 之外的任何属性，否则会导致错误。 例如，支持的值将按以下方式处理
    • pipe: 等效于 ['ignore', 'pipe', 'pipe']
    • ignore: 等效于 ['ignore', 'ignore', 'ignore']
    • inherit: 等效于 ['ignore', 'inherit', 'inherit'] (默认值)
  • serviceName string (可选) - 将出现在 ProcessMetric 的 name 属性中的进程名称，该 ProcessMetric 由 app.getAppMetrics 和 app 的 child-process-gone 事件 返回。 默认值为 Node Utility Process。
  • allowLoadingUnsignedLibraries boolean (可选) macOS - 使用此标志，实用程序进程将通过 macOS 上的 Electron Helper (Plugin).app 辅助可执行文件启动，该文件可以使用 com.apple.security.cs.disable-library-validation 和 com.apple.security.cs.allow-unsigned-executable-memory 授权进行代码签名。 这将允许实用程序进程加载未签名的库。 除非您特别需要此功能，否则最好禁用此功能。 默认值为 false。
  • respondToAuthRequestsFromMainProcess boolean (可选) - 使用此标志，所有通过 net 模块 创建的 HTTP 401 和 407 网络请求都允许通过主进程中的 app#login 事件响应它们，而不是默认的 login 事件 ClientRequest 对象。 默认值为 false。

返回 UtilityProcess

注意

utilityProcess.fork 只能在 App 上发出 ready 事件后调用。

类：UtilityProcess

UtilityProcess 的实例表示具有 Node.js 集成的 Chromium 生成的子进程。

UtilityProcess 是一个 EventEmitter。

实例方法

child.postMessage(message, [transfer])

• message any
• transfer MessagePortMain[] (可选)

向子进程发送消息，可以选择传递零个或多个 MessagePortMain 对象的所有权。

例如

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

返回 boolean

正常终止进程。 在 POSIX 上，它使用 SIGTERM，但将确保在退出时重新获取进程。 如果终止成功，此函数返回 true，否则返回 false。

实例属性

child.pid

一个 Integer | undefined，表示子进程的进程标识符 (PID)。 在子进程成功生成之前，该值为 undefined。 当子进程退出时，该值在发出 exit 事件后为 undefined。

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
})

注意

您可以使用 pid 来确定进程当前是否正在运行。

child.stdout

一个 NodeJS.ReadableStream | null，表示子进程的 stdout。 如果使用 options.stdio[1] 设置为除“pipe”以外的任何内容生成子进程，则此值将为 null。 当子进程退出时，该值在发出 exit 事件后为 null。

// 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

一个 NodeJS.ReadableStream | null，表示子进程的 stderr。 如果使用 options.stdio[2] 设置为除“pipe”以外的任何内容生成子进程，则此值将为 null。 当子进程退出时，该值在发出 exit 事件后为 null。

实例事件

事件：'spawn'

子进程成功生成后发出一次。

事件：'error' 实验性

返回

• type string - 错误的类型。 以下值之一
  • 致命错误
• location string - 错误源自的源位置。
• report string - Node.js 诊断报告。

当子进程由于 V8 中的不可继续错误而需要终止时发出。

无论您是否侦听 error 事件，子进程终止后都会发出 exit 事件。

事件：'exit'

返回

• code number - 包含从 POSIX 上的 waitpid 或 Windows 上的 GetExitCodeProcess 获取的进程的退出代码。

子进程结束后发出。

事件：'message'

返回

• message any

当子进程使用 process.parentPort.postMessage() 发送消息时发出。