Unsere Freiwilligen haben diesen Artikel noch nicht in Deutsch übersetzt. Machen Sie mit und helfen Sie, das zu erledigen!
Sie können den Artikel auch auf English (US) lesen.
Match patterns are a way to specify groups of URLs: a match pattern matches a specific set of URLs. They are for extensions using WebExtensions APIs in a few places, most notably to specify which documents to load content scripts into, and to specify which URLs to add webRequest
listeners to.
APIs that use match patterns usually accept a list of match patterns, and will perform the appropriate action if the URL matches any of the patterns. See, for example, the content_scripts
key in manifest.json.
Match pattern structure
Note: Some browsers don’t support certain schemes.
Check the Browser compatibility table for details.
All match patterns are specified as strings. Apart from the special "<all_urls>" pattern, match patterns consist of three parts: scheme, host, and path. The scheme and host are separated by "://".
<scheme>://<host><path>
scheme
The scheme component may take one of two forms:
Form | Matches |
---|---|
"*" | Only "http" and "https" and in some browsers also "ws" and "wss". |
One of "http", "https", "ws", "wss", "ftp", "ftps", "data" or "file". | Only the given scheme. |
host
The host component may take one of three forms:
Form | Matches |
---|---|
"*" | Any host. |
"*." followed by part of the hostname. | The given host and any of its subdomains. |
A complete hostname, without wildcards. | Only the given host. |
host must not include a port number.
host is optional only if the scheme is "file".
Note that the wildcard may only appear at the start.
path
The path component must begin with a "/".
After that, it may subsequently contain any combination of the "*" wildcard and any of the characters that are allowed in URL paths. Unlike host, the path component may contain the "*" wildcard in the middle or at the end, and the "*" wildcard may appear more than once.
<all_urls>
The special value "<all_urls>" matches all URLs under any of the supported schemes: that is "http", "https", "ws", "wss", "ftp", "data", and "file".
Examples
Pattern | Example matches | Example non-matches |
---|---|---|
Match all URLs. |
|
|
Match all HTTP, HTTPS and WebSocket URLs. |
|
|
Match all HTTP, HTTPS and WebSocket URLs that are hosted at "mozilla.org" or one of its subdomains. |
|
|
Match all HTTP, HTTPS and WebSocket URLs that are hosted at exactly "mozilla.org/". |
|
|
Match only "ftp://mozilla.org/". |
ftp://mozilla.org |
|
Match HTTPS URLs on any host, whose path is "path". |
|
|
Match HTTPS URLs on any host, whose path is "path/". |
|
|
Match HTTPS URLs only at "mozilla.org", with any path. |
|
|
Match only this URL. |
https://mozilla.org/a/b/c/ |
Anything else. |
Match HTTPS URLs hosted on "mozilla.org", whose path contains a component "b" somewhere in the middle. |
|
|
Match any FILE URL whose path begins with "blah". |
|
file:///bleh/ (unmatched path) |
Invalid match patterns
Invalid pattern | Reason |
---|---|
resource://path/ |
Unsupported scheme. |
https://mozilla.org |
No path. |
https://mozilla.*.org/ |
"*" in host must be at the start. |
https://*zilla.org/ |
"*" in host must be the only character or be followed by ".". |
http*://mozilla.org/ |
"*" in scheme must be the only character. |
https://mozilla.org:80/ |
Host must not include a port number. |
*://* |
Empty path: this should be "*://*/* ". |
file://* |
Empty path: this should be "file:///* ". |
Browser compatibility
scheme
Desktop | Mobile | ||||
---|---|---|---|---|---|
Wildcard * scheme | Chrome Full support Yes | Edge Full support 14 | Firefox Full support 48 | Opera Full support Yes | Firefox Android Full support 48 |
* matches ws and wss | Chrome No support No | Edge ? | Firefox Full support 55 | Opera No support No | Firefox Android Full support 55 |
http | Chrome Full support Yes | Edge Full support 14 | Firefox Full support 48 | Opera Full support Yes | Firefox Android Full support 48 |
https | Chrome Full support Yes | Edge Full support 14 | Firefox Full support 48 | Opera Full support Yes | Firefox Android Full support 48 |
ws | Chrome No support No | Edge ? | Firefox Full support 55 | Opera No support No | Firefox Android Full support 55 |
wss | Chrome No support No | Edge ? | Firefox Full support 55 | Opera No support No | Firefox Android Full support 55 |
ftp | Chrome Full support Yes | Edge Full support 14 | Firefox Full support 48 | Opera Full support Yes | Firefox Android Full support 48 |
ftps | Chrome No support No | Edge No support No | Firefox
No support
No
| Opera No support No | Firefox Android
No support
No
|
file | Chrome Full support Yes | Edge Full support 14 | Firefox Full support 48 | Opera Full support Yes | Firefox Android Full support 48 |
data | Chrome No support No | Edge ? | Firefox
Partial support
48
| Opera No support No | Firefox Android
Partial support
48
|
Legend
- Full support
- Full support
- Partial support
- Partial support
- No support
- No support
- Compatibility unknown
- Compatibility unknown
- See implementation notes.
- See implementation notes.