PerformanceScriptTiming: sourceFunctionName 属性

实验性: 这是一个 实验性技术
在生产环境中使用此功能前,请仔细查看 浏览器兼容性表格

sourceFunctionNamePerformanceScriptTiming 接口的只读属性,它返回一个字符串,表示导致长时间动画帧 (LoAF) 的函数的名称。

需要注意的是,报告的函数名称将是脚本的“入口点”,即堆栈的顶层,而不是任何特定的缓慢子函数。

例如,如果事件处理程序调用一个顶级函数,然后该函数调用一个缓慢的子函数,则 source* 字段将报告顶级函数的名称和位置,而不是缓慢的子函数——传递给平台 API 的函数始终是报告的函数。这是出于性能方面的考虑;完整的堆栈跟踪代价很高。

在以下代码片段中

js
setTimeout(function lib_func() {
  slow_function();
});

sourceFunctionName 将报告 lib_func,而不是 slow_function

字符串。如果未找到函数名称,则返回空字符串。

示例

有关长时间动画帧 API 的示例,请参阅 长时间动画帧计时

规范

规范
长时间动画帧 API
# dom-performancescripttiming-sourcefunctionname

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅