Node.js process.allowedNodeEnvironmentFlags用法及代码示例

process.allowedNodeEnvironmentFlags

• <Set>

process.allowedNodeEnvironmentFlags 属性是 NODE_OPTIONS 环境变量中允许的标志的特殊只读 Set。

process.allowedNodeEnvironmentFlags 扩展 Set ，但覆盖 Set.prototype.has 以识别几种不同的可能标志表示。在以下情况下，process.allowedNodeEnvironmentFlags.has() 将返回 true：

• 标志可以省略前导单 (-) 或双 (--) 破折号；例如，inspect-brk 用于 --inspect-brk ，或 r 用于 -r 。
• 传递给 V8 的标志(如在--v8-options) 可以替换一个或多个非领先破折号代表下划线，反之亦然；例如：，--perf_basic_prof,--perf-basic-prof,--perf_basic-prof， 等等。
• 标志可能包含一个或多个等号 (=) 字符；包括第一个等号之后的所有字符都将被忽略；例如，--stack-trace-limit=100。
• 标志必须允许范围内NODE_OPTIONS.

当迭代 process.allowedNodeEnvironmentFlags 时，标志只会出现一次；每个都以一个或多个破折号开头。传递给 V8 的标志将包含下划线而不是非前导破折号：

import { allowedNodeEnvironmentFlags } from 'node:process';

allowedNodeEnvironmentFlags.forEach((flag) => {
  // -r
  // --inspect-brk
  // --abort_on_uncaught_exception
  // ...
});const { allowedNodeEnvironmentFlags } = require('node:process');

allowedNodeEnvironmentFlags.forEach((flag) => {
  // -r
  // --inspect-brk
  // --abort_on_uncaught_exception
  // ...
});

process.allowedNodeEnvironmentFlags 的方法 add() 、 clear() 和 delete() 什么都不做，并且会静默失败。

如果 Node.js 在没有 NODE_OPTIONS 支持的情况下编译(显示在 process.config 中)，则 process.allowedNodeEnvironmentFlags 将包含允许的内容。