web_extensions / latest / api / webrequest / resourcetype.html /

webRequest.ResourceType

This type is a string, which represents the context in which a resource was fetched in a web request.

It's used to filter the requests you listen to using the webRequest API. For example: you can listen to requests only for images, or only for scripts.

Type

Values of this type are strings. Possible values are:

beacon

Requests sent through the Beacon API.

csp_report

Requests sent to the report-uri given in the Content-Security-Policy header, when an attempt to violate the policy is detected.

font

Web fonts loaded for a @font-face CSS rule.

image

Resources loaded to be rendered as image, except for imageset on browsers that support that type (see browser compatibility below).

imageset

Images loaded by a <picture> element or given in an <img> element's srcset attribute.

main_frame

Top-level documents loaded into a tab.

media

Resources loaded by a <video> or <audio> element.

object

Resources loaded by an <object> or <embed> element.

Browsers that don't have a dedicated object_subrequest type (see browser compatibility below), also label subsequent requests sent by the plugin as object.

object_subrequest

Requests sent by plugins.

ping

Requests sent to the URL given in a hyperlink's ping attribute, when the hyperlink is followed.

Browsers that don't have a dedicated beacon type (see browser compatibility below), also label requests sent through the Beacon API as ping.

script

Code that is loaded to be executed by a <script> element or running in a Worker.

speculative

In a speculative connection, the browser has determined that a request to a URI may be coming soon, so it starts a TCP and/or TLS handshake immediately, so it is ready more quickly when the resource is actually requested. Note that this type of connection does not provide valid tab information, so request details such as tabId, frameId, parentFrameId, etc. are inaccurate.

stylesheet

CSS stylesheets loaded to describe the representation of a document.

sub_frame

Documents loaded into an <iframe> or <frame> element.

web_manifest

Web App Manifests loaded for websites that can be installed to the homescreen.

websocket

Requests initiating a connection to a server through the WebSocket API.

xbl

XBL bindings loaded to extend the behavior of elements in a document.

xml_dtd

DTDs loaded for an XML document.

xmlhttprequest

Requests sent by an XMLHttpRequest object or through the Fetch API.

xslt

XSLT stylesheets loaded for transforming an XML document.

other

Resources that aren't covered by any other available type.

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
ResourceType
44
79
45
?
31
No
?
?
48
?
No
?
beacon
No
No
45
?
No
No
?
?
48
?
No
?
csp_report
58
79
45
?
45
No
?
?
48
?
No
?
font
49
79
45
?
36
No
?
?
48
?
No
?
imageset
No
No
45
?
No
No
?
?
48
?
No
?
media
58
79
45
?
45
No
?
?
48
?
No
?
object_subrequest
No
No
55
Requests have been reported as object_subrequest before, but the type was missing in the ResourceType object before Firefox 55.
?
No
No
?
?
55
Requests have been reported as object_subrequest before, but the type was missing in the ResourceType object before Firefox 55.
?
No
?
ping
49
Requests sent by navigator.sendBeacon(), and CSP reports in Chrome 49-57 (Opera 36-44), are also labeled as ping.
79
45
?
36
Requests sent by navigator.sendBeacon(), and CSP reports in Chrome 49-57 (Opera 36-44), are also labeled as ping.
No
?
?
48
?
No
?
speculative
No
No
63
?
No
No
?
?
63
?
No
?
web_manifest
No
No
45
?
No
No
?
?
48
?
No
?
websocket
58
79
45
?
45
No
?
?
48
?
No
?
xbl
No
No
45-78
?
No
No
?
?
48
?
No
?
xml_dtd
No
No
45
?
No
No
?
?
48
?
No
?
xslt
No
No
45
?
No
No
?
?
48
?
No
?

Note: This API is based on Chromium's chrome.webRequest API. This documentation is derived from web_request.json in the Chromium code.

Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.

© 2005–2022 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/webRequest/ResourceType