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 將包含允許的內容。