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 theContent-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'ssrcset
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 asobject
. object_subrequest
- Requests sent by plugins.
ping
- Requests sent to the URL given in a hyperlink's
ping
attribute, when the hypelink is followed. - Browsers that don't have a dedicated
beacon
type (see browser compatibility below), also label requests sent through the Beacon API asping
. script
- Code that is loaded to be executed by a
<script>
element or running in a Worker. 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
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Chrome | Edge | Firefox | Firefox for Android | Opera | |
---|---|---|---|---|---|
Basic support | 44 | No | 45 | 48 | 31 |
ping | 491 | No | 45 | 48 | 361 |
font | 49 | No | 45 | 48 | 36 |
media | 58 | No | 45 | 48 | 45 |
websocket | 58 | No | 45 | 48 | 45 |
csp_report | 58 | No | 45 | 48 | 45 |
xbl | No | No | 45 | 48 | No |
xslt | No | No | 45 | 48 | No |
beacon | No | No | 45 | 48 | No |
xml_dtd | No | No | 45 | 48 | No |
imageset | No | No | 45 | 48 | No |
web_manifest | No | No | 45 | 48 | No |
object_subrequest | No | No | 552 | 552 | No |
1. Requests sent by navigator.sendBeacon(), and CSP reports in Chrome 49-57 (Opera 36-44), are also labeled as `ping`.
2. Requests have been reported as `object_subrequest` before, but the type was missing in the `ResourceType` object before Firefox 55.
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.
// Copyright 2015 The Chromium Authors. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are // met: // // * Redistributions of source code must retain the above copyright // notice, this list of conditions and the following disclaimer. // * Redistributions in binary form must reproduce the above // copyright notice, this list of conditions and the following disclaimer // in the documentation and/or other materials provided with the // distribution. // * Neither the name of Google Inc. nor the names of its // contributors may be used to endorse or promote products derived from // this software without specific prior written permission. // // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.