Node.js trace_events.createTracing()用法及代碼示例

trace_events.createTracing(options)(在 v10.0.0 中添加)方法是 ‘trace_events’ 模塊的內置應用程序編程接口，它創建 Tracing 對象並為給定的類別集返回相同的對象。 trace_events 模塊包含用於啟用或禁用類別集跟蹤的跟蹤對象。

用法:

trace_events.createTracing(options)

為了使用這個 (trace_events.createTracing()) 方法，我們需要導入 ‘trace_events’ 模塊。

const trace_events = require('trace_events');

參數：該函數接受對象作為參數，如上所述，如下所述：

options <Object>：它接受一個對象，其中包含一些在跟蹤時需要的分類字符串值。
categories <string[]> 它接受一個包含跟蹤類別名稱的字符串數組。如果可能，則將值包含在數組中並說服為字符串。如果無法說服該值，則將返回錯誤。

返回值<Tracing>：返回一個包含類別 <string[]> 和啟用的 <boolean> 值的對象。

以下示例程序旨在說明 Node.js 中的 trace_events.createTracing() 方法：

範例1： 文件名：index.js


// Node.js program to demonstrate the 
// trace_events.createTracing() methods 
  
// Using require to access trace_events module 
const tracing_events = require("trace_events");
  
// Different types of tracing categories
const categories = [ 'myapp.category', 
    'v8', 'node', 'node.async_hooks', 
    'node.promises.rejections', 
    'node.vm.script', 'node.perf.usertiming', 
    'node.perf.timerify'
];
  
// Now creating tracing for custom
// trace category.
const newTracing = tracing_events.createTracing(
    { categories });
  
// Printing tracing event
console.log(newTracing);

輸出：

>> Tracing {
enabled:false,
categories:‘myapp.category, v8, node, node.async_hooks,
node.promises.rejections, node.vm.script, node.perf.usertiming, node.perf.timerify’
}

範例2： 文件名：index.js


// Node.js program to demonstrate the 
// trace_events.createTracing() methods 
  
// Using require to access trace_events module 
const { createTracing } = require('trace_events');
  
// Now create tracing for custom trace category.
const tracing = createTracing({ categories:['perf_hooks', 
'node.promises.rejections'] });
console.log("Tracing Created...");
  
// Printing tracing event
console.log(tracing);
  
// Enabling Tracing event
tracing.enable();
  
// Do some steff here
const perf_hooks = require("perf_hooks");
perf_hooks.performance.mark("A");
() => {
  perf_hooks.performance.mark("B");
  perf_hooks.performance.measure("A to B", "C", "D");
};
  
// Disabling tracing event
tracing.disable();

使用以下命令運行index.js文件：

node index.js

輸出：

Tracing Created…
Tracing { enabled:false, categories:‘perf_hooks, node.promises.rejections’ }

參考：https://nodejs.org/api/tracing.html#tracing_trace_events_createtracing_options

相關用法

注：本文由純淨天空篩選整理自vikas_g大神的英文原創作品 Node.js trace_events.createTracing() Method。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。