subprocess.timedout 是 node.js 27 alpha 引入的用于判定子进程是否因超时被终止的属性。该属性在 child_process 模块中可用,当子进程执行时间超过 timeout 选项设定的毫秒数时,node.js 会强制终止该进程并触发 close 事件,此时父进程中获取的子进程对象上 timedout 字段将返回 true。若进程正常退出或发生其他错误(如信号中断),该属性为 false 或未定义。开发者可通过监听 close 事件并在回调中检查此属性,从而区分超时与其他退出原因。

child_process.fork() 设置 timeout 后如何判定超时?
使用 child_process.fork() 启动子进程时,通过传入 timeout 参数即可启用超时机制。当子进程运行时间超过设定值,主进程会在 close 事件中收到 timedOut: true。以下代码演示了如何通过 fork 创建子进程并验证超时判定逻辑。

const { fork } = require('child_process');
// 模拟一个长时间运行的子进程
const child = fork('./longRunningChild.js', [], {
timeout: 2000 // 设置超时时间为 2 秒
});
child.on('close', (code, signal) => {
if (child.timedOut) {
console.log('子进程因超时被终止');
} else {
console.log(`子进程正常退出,退出码: ${code}`);
}
});
child.on('error', (err) => {
console.error('子进程启动失败:', err);
});预期结果:若子进程未在 2 秒内退出,控制台将输出“子进程因超时被终止”。若子进程提前完成,则输出对应的退出码且 timedOut 为 false。
一个基于官方 Mailtrap Node.js SDK 构建的 ASE 技能,用于发送事务邮件并与 Mailtrap 沙盒或生产流程协作。它非常适合需要 API 驱动邮件投递、测试邮箱验证和结构化消息自动化的代理工作流。
spawn() 与 exec() 是否支持 timedOut 属性?
spawn() 和 exec() 同样支持 timeout 选项,并在超时后设置 timedOut 属性。区别在于 exec() 会将输出缓冲到内存,而 spawn() 提供流式数据。两者在超时判定上的行为一致,均通过 close 事件的 timedOut 字段反馈结果。

const { spawn } = require('child_process');
const child = spawn('node', ['--version'], {
timeout: 1000
});
let stdoutData = '';
child.stdout.on('data', (data) => {
stdoutData += data.toString();
});
child.on('close', (code, signal) => {
if (child.timedOut) {
console.log('spawn 子进程超时');
} else {
console.log('spawn 子进程正常结束');
}
});预期结果:由于 node --version 执行极快,通常不会超时,timedOut 为 false。若替换为耗时命令且超过 1 秒,则 timedOut 变为 true。
子进程在超时前发送消息,timedOut 仍为 true 吗?
是的。即使子进程在超时截止前通过 process.send() 向父进程发送过消息,只要其实际运行时间超过了 timeout 设定值,Node.js 仍会强制终止该进程,并在 close 事件中设置 timedOut: true。消息传递不影响超时判定逻辑,仅表示通信曾成功建立。

















