util.getCallSites([frameCount][, options])

• frameCount <number> 可选择捕获的调用点对象帧数。默认值: 10。允许的范围是 1 到 200。
• options <Object> 可选
  • sourceMap <boolean> 从源映射重建堆栈跟踪中的原始位置。默认情况下通过 --enable-source-maps 标志启用。
• 返回：<Object[]> 一组调用点对象
  • functionName <string> 返回与该调用点关联的函数名称。
  • scriptName <string> 返回包含此调用点函数脚本的资源名称。
  • scriptId <string> 返回脚本的唯一 ID，如 Chrome 开发者工具协议 Runtime.ScriptId 所示。
  • lineNumber <number> 返回 JavaScript 脚本的行号（从 1 开始）。
  • columnNumber <number> 返回 JavaScript 脚本的列号（从 1 开始）。

返回一个包含调用者函数堆栈的调用点对象数组。

🌐 Returns an array of call site objects containing the stack of the caller function.

import { getCallSites } from 'node:util';

function exampleFunction() {
  const callSites = getCallSites();

  console.log('Call Sites:');
  callSites.forEach((callSite, index) => {
    console.log(`CallSite ${index + 1}:`);
    console.log(`Function Name: ${callSite.functionName}`);
    console.log(`Script Name: ${callSite.scriptName}`);
    console.log(`Line Number: ${callSite.lineNumber}`);
    console.log(`Column Number: ${callSite.column}`);
  });
  // CallSite 1:
  // Function Name: exampleFunction
  // Script Name: /home/example.js
  // Line Number: 5
  // Column Number: 26

  // CallSite 2:
  // Function Name: anotherFunction
  // Script Name: /home/example.js
  // Line Number: 22
  // Column Number: 3

  // ...
}

// A function to simulate another stack layer
function anotherFunction() {
  exampleFunction();
}

anotherFunction();const { getCallSites } = require('node:util');

function exampleFunction() {
  const callSites = getCallSites();

  console.log('Call Sites:');
  callSites.forEach((callSite, index) => {
    console.log(`CallSite ${index + 1}:`);
    console.log(`Function Name: ${callSite.functionName}`);
    console.log(`Script Name: ${callSite.scriptName}`);
    console.log(`Line Number: ${callSite.lineNumber}`);
    console.log(`Column Number: ${callSite.column}`);
  });
  // CallSite 1:
  // Function Name: exampleFunction
  // Script Name: /home/example.js
  // Line Number: 5
  // Column Number: 26

  // CallSite 2:
  // Function Name: anotherFunction
  // Script Name: /home/example.js
  // Line Number: 22
  // Column Number: 3

  // ...
}

// A function to simulate another stack layer
function anotherFunction() {
  exampleFunction();
}

anotherFunction();拷贝

通过将选项 sourceMap 设置为 true，可以重建原始位置。 如果源映射不可用，原始位置将与当前位置相同。 当启用 --enable-source-maps 标志时，例如使用 --experimental-transform-types，sourceMap 将默认为 true。

🌐 It is possible to reconstruct the original locations by setting the option sourceMap to true. If the source map is not available, the original location will be the same as the current location. When the --enable-source-maps flag is enabled, for example when using --experimental-transform-types, sourceMap will be true by default.

import { getCallSites } from 'node:util';

interface Foo {
  foo: string;
}

const callSites = getCallSites({ sourceMap: true });

// With sourceMap:
// Function Name: ''
// Script Name: example.js
// Line Number: 7
// Column Number: 26

// Without sourceMap:
// Function Name: ''
// Script Name: example.js
// Line Number: 2
// Column Number: 26 拷贝

const { getCallSites } = require('node:util');

const callSites = getCallSites({ sourceMap: true });

// With sourceMap:
// Function Name: ''
// Script Name: example.js
// Line Number: 7
// Column Number: 26

// Without sourceMap:
// Function Name: ''
// Script Name: example.js
// Line Number: 2
// Column Number: 26 拷贝