Performance API
The initiatorType read-only property is a string representing web platform feature that initiated the resource load.
[!NOTE] This property does not represent the type of content fetched. A
.cssfile can be fetched using a link element leading to aninitiatorTypeoflink. When loading images usingbackground: url()in a CSS file, theinitiatorTypewill becssand notimg.
Value
The initiatorType property can have the following values, or other if none of the conditions match.
audio- : If the request was initiated by an audio element's
srcattribute.
- : If the request was initiated by an audio element's
beacon- : If the request was initiated by a navigator.sendBeacon() method.
body- : If the request was initiated by a body element's
backgroundattribute.
- : If the request was initiated by a body element's
css- : If the request was initiated by a CSS
url()function.
- : If the request was initiated by a CSS
early-hint- : If the request was initiated by an 103
Early Hintresponse.
- : If the request was initiated by an 103
embed- : If the request was initiated by an embed element's
srcattribute.
- : If the request was initiated by an embed element's
fetch- : If the request was initiated by a Window/fetch method.
frame- : If the request was initiated by loading a frame element.
iframe- : If the request was initiated by an iframe element's
srcattribute.
- : If the request was initiated by an iframe element's
icon- : If the request was initiated by a favicon. Non-standard and only reported by Safari.
image- : If the request was initiated by an image element.
img- : If the request was initiated by an img element's
srcorsrcsetattribute.
- : If the request was initiated by an img element's
input- : If the request was initiated by an input element of type
image.
- : If the request was initiated by an input element of type
link- : If the request was initiated by a link element.
navigation- : If the request was initiated by a navigation request.
object- : If the request was initiated by an object element.
ping- : If the request was initiated by an a element's
ping.
- : If the request was initiated by an a element's
script- : If the request was initiated by a script element.
track- : If the request was initiated by a track element's
src.
- : If the request was initiated by a track element's
video- : If the request was initiated by a video element's
posterorsrc.
- : If the request was initiated by a video element's
xmlhttprequest- : If the request was initiated by an XMLHttpRequest.
Examples
Filtering resources
The initiatorType property can be used to get specific resource timing entries only. For example, only those that were initiated by script elements.
Example using a PerformanceObserver, which notifies of new resource performance entries as they are recorded in the browser's performance timeline. Use the buffered option to access entries from before the observer creation.
const observer = new PerformanceObserver((list) => {
const scripts = list
.getEntries()
.filter((entry) => entry.initiatorType === "script");
console.log(scripts);
});
observer.observe({ type: "resource", buffered: true });
Example using Performance.getEntriesByType(), which only shows resource performance entries present in the browser's performance timeline at the time you call this method:
const scripts = performance
.getEntriesByType("resource")
.filter((entry) => entry.initiatorType === "script");
console.log(scripts);
Specifications
Browser compatibility
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
