当前位置 : 主页 > 编程语言 > 其它开发 >

获取 NodeJS 程序退出码

来源:互联网 收集:自由互联 发布时间:2021-08-24
前言 想要退出正在运行的 NodeJS 程序,我们既可以通过 Ctrl + C 的方式,也可以通过 process.exit() 来执行退出。 这两种操作都将强制进程尽快退出,即使仍有未完全完成的异步操作挂起,

前言

想要退出正在运行的 NodeJS 程序,我们既可以通过 Ctrl + C 的方式,也可以通过process.exit()来执行退出。

这两种操作都将强制进程尽快退出,即使仍有未完全完成的异步操作挂起,包括对 process.stdoutprocess.stderr 的 I/O 操作。

如果由于错误情况需要终止 Node.js 进程,则抛出未捕获的错误并允许进程相应地终止比调用 process.exit() 更安全,比如:

  1. import process from 'process';
  2. // 如何正确设置退出码,同时让进程正常退出。
  3. if (someConditionNotMet()) {
  4. printUsageToStdout();
  5. process.exitCode = 1;
  6. }

Worker 线程中,该函数停止当前线程而不是当前进程。

那么对于一些意外推出的情况,如何来获取 exitCode ?每一个退出码又代表什么?今天我们就来学习一下。

通过 NodeJS 的 child_process 子进程获取退出码

child_process.fork() 方法是 child_process.spawn() 的特例,专门用于衍生新的 NodeJS 进程。

  1. const fork = require("child_process").fork;
  2. console.log("main ", process.argv);
  3. const fs = require("fs");
  4. const fd = fs.openSync("./a.log", "a");
  5. const child = fork("./index.js", {
  6. stdio: ["ipc", "pipe", fd]
  7. });
  8. child.on("error", (error) => {
  9. let info = `child process error ${error}`;
  10. fs.writeSync(fd, info);
  11. console.log(info);
  12. });
  13. child.on("exit", (code) => {
  14. let info = `child process exited with code ${code}`;
  15. fs.writeSync(fd, info);
  16. console.log(info);
  17. });

子程序执行参数

  1. const fork = require('child_process').fork;
  2. console.log('main ',process.argv);
  3. const fs=require('fs');
  4. const fd = fs.openSync('./a.log','a');
  5. // 子程序参数
  6. let args = [];
  7. args[0] = 'test';
  8. const child = fork('./index.js',args,{
  9. stdio:['ipc','pipe',fd]
  10. });
  11. child.on('error', (error) => {
  12. let info = `child process error ${error}`;
  13. fs.writeSync(fd,info);
  14. console.log(info);
  15. });
  16. child.on('exit', (code) => {
  17. let info = `child process exited with code ${code}`;
  18. fs.writeSync(fd,info);
  19. console.log(info);
  20. });

NodeJS退出码

当没有更多异步操作挂起时,NodeJS 通常会以 0 状态代码退出。 在其他情况下使用以下状态代码:

  • 1 未捕获的致命异常:存在未捕获的异常,并且其没有被域或 'uncaughtException' 事件句柄处理。
  • 2: 未使用(由 Bash 保留用于内置误用)
  • 3 内部 JavaScript 解析错误:NodeJS 引导过程中的内部 JavaScript 源代码导致解析错误。 这是极其罕见的,通常只能在 NodeJS 本身的开发过程中发生。
  • 4 内部 JavaScript 评估失败:NodeJS 引导过程中的内部 JavaScript 源代码在评估时未能返回函数值。 这是极其罕见的,通常只能在 NodeJS 本身的开发过程中发生。
  • 5 致命错误:V8 中存在不可恢复的致命错误。 通常将打印带有前缀 FATAL ERROR 的消息到标准错误。
  • 6 非函数的内部异常句柄:存在未捕获的异常,但内部致命异常句柄不知何故设置为非函数,无法调用。
  • 7 内部异常句柄运行时失败:存在未捕获的异常,并且内部致命异常句柄函数本身在尝试处理时抛出错误。 例如,如果 'uncaughtException'domain.on('error') 句柄抛出错误,就会发生这种情况。
  • 8: 未使用。 在以前版本的 NodeJS 中,退出码 8 有时表示未捕获的异常。
  • 9 无效参数:指定了未知选项,或者提供了需要值的选项而没有值。
  • 10 内部 JavaScript 运行时失败:NodeJS 引导过程中的内部 JavaScript 源代码在调用引导函数时抛出错误。 这是极其罕见的,通常只能在 NodeJS 本身的开发过程中发生。
  • 12 无效的调试参数:设置了 --inspect 和/或 --inspect-brk 选项,但选择的端口号无效或不可用。
  • 13 未完成的顶层等待:在顶层代码中的函数外使用了 await,但传入的 Promise 从未解决。
  • >128 信号退出:如果 NodeJS 收到致命的信号,例如 SIGKILLSIGHUP,则其退出码将是 128 加上信号代码的值。 这是标准的 POSIX 实践,因为退出码被定义为 7 位整数,并且信号退出设置高位,然后包含信号代码的值。 例如,信号 SIGABRT 的值是 6,因此预期的退出码将是 128 + 6134

总结

以上就是获取 NodeJS 程序退出码的方法以及退出码枚举。

~

~本文完,感谢阅读!

~

学习有趣的知识,结识有趣的朋友,塑造有趣的灵魂!

大家好,我是〖编程三昧〗的作者 隐逸王,我的公众号是『编程三昧』,欢迎关注,希望大家多多指教!

你来,怀揣期望,我有墨香相迎! 你归,无论得失,唯以余韵相赠!

知识与技能并重,内力和外功兼修,理论和实践两手都要抓、两手都要硬!

网友评论