PerformanceScriptTiming: sourceFunctionName property
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The sourceFunctionName read-only property of the PerformanceScriptTiming interface returns a string representing the name of the function that contributed to the long animation frame (LoAF).
It is important to note that the reported function name will be the "entry point" of the script, that is, the top level of the stack, not any specific slow sub-function.
For example, if an event handler calls a top-level function, which then calls a slow sub-function, the source* fields will report the name and location of the top-level function, not the slow sub-function — the function that was passed to the platform API is always the one reported. This is because of performance reasons; a full stack trace is costly.
In the following snippet:
setTimeout(function lib_func() {
slow_function();
});
sourceFunctionName would report lib_func, not slow_function.
Value
A string. Returns an empty string if the function name was not found.
Examples
See Long animation frame timing for examples related to the Long Animation Frames API.
Specifications
| Specification |
|---|
| Long Animation Frames API # dom-performancescripttiming-sourcefunctionname |
Browser compatibility
BCD tables only load in the browser