Filters URLs for various criteria. See event filtering. All criteria are case sensitive.
Type
Values of this type are objects. They contain the following properties:
hostContains
Optionalstring
. Matches if the host name of the URL contains a specified string. To test whether a host name component has a prefix 'foo', use hostContains: '.foo'. This matches 'www.foobar.com' and 'foo.com', because an implicit dot is added at the beginning of the host name. Similarly, hostContains can be used to match against component suffix ('foo.') and to exactly match against components ('.foo.'). Suffix- and exact-matching for the last components need to be done separately using hostSuffix, because no implicit dot is added at the end of the host name.hostEquals
Optionalstring
. Matches if the host name of the URL is equal to a specified string.hostPrefix
Optionalstring
. Matches if the host name of the URL starts with a specified string.hostSuffix
Optionalstring
. Matches if the host name of the URL ends with a specified string.pathContains
Optionalstring
. Matches if the path segment of the URL contains a specified string.pathEquals
Optionalstring
. Matches if the path segment of the URL is equal to a specified string.pathPrefix
Optionalstring
. Matches if the path segment of the URL starts with a specified string.pathSuffix
Optionalstring
. Matches if the path segment of the URL ends with a specified string.queryContains
Optionalstring
. Matches if the query segment of the URL contains a specified string.queryEquals
Optionalstring
. Matches if the query segment of the URL is equal to a specified string.queryPrefix
Optionalstring
. Matches if the query segment of the URL starts with a specified string.querySuffix
Optionalstring
. Matches if the query segment of the URL ends with a specified string.urlContains
Optionalstring
. Matches if the URL (without fragment identifier) contains a specified string. Port numbers are stripped from the URL if they match the default port number.urlEquals
Optionalstring
. Matches if the URL (without fragment identifier) is equal to a specified string. Port numbers are stripped from the URL if they match the default port number.urlMatches
Optionalstring
. Matches if the URL (without fragment identifier) matches a specified regular expression. Port numbers are stripped from the URL if they match the default port number. The regular expressions use the RE2 syntax.originAndPathMatches
Optionalstring
. Matches if the URL without query segment and fragment identifier matches a specified regular expression. Port numbers are stripped from the URL if they match the default port number. The regular expressions use the RE2 syntax.urlPrefix
Optionalstring
. Matches if the URL (without fragment identifier) starts with a specified string. Port numbers are stripped from the URL if they match the default port number.urlSuffix
Optionalstring
. Matches if the URL (without fragment identifier) ends with a specified string. Port numbers are stripped from the URL if they match the default port number.schemes
Optionalarray
of
. Matches if the scheme of the URL is equal to any of the schemes specified in the array.string
ports
Optionalarray
of
. Matches if the port of the URL is contained in any of the specified port lists. For example
orinteger
array
ofinteger
[80, 443, [1000, 1200]]
matches all requests on port 80, 443 and in the range 1000-1200.
Browser compatibility
Acknowledgements
This API is based on Chromium's chrome.events
API. This documentation is derived from events.json
in the Chromium code.
// 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.