events.UrlFilter
Décrit différents critères de filtrage des URL. Si tous les critères spécifiés dans les propriétés du filtre correspondent à l'URL, le filtre correspond. Les filtres sont souvent fournis aux méthodes API dans un Array d'UrlFilters. Par exemple, les écouteurs webNavigation peuvent être ajoutés avec un filtre qui est un objet avec une seule propriété url qui est un Array de UrlFilters, par exemple {url:[UrlFilter,UrlFilter,...]}
. Si un filtre dans le tableau de UrlFilters correspond, il est considéré comme une correspondance pour le tableau. En effet, les critères spécifiés dans un seul filtre sont associés ensemble, alors que tous les filtres individuels dans un tableau sont où.
Tous les critères sont sensibles à la casse.
Type
Les valeurs de ce type sont des objets. Ils contiennent les propriétés suivantes:
Toutefois, notez que ces deux derniers modèles ne correspondent pas au dernier composant du nom d'hôte, car aucun point implicite n'est ajouté à la fin du nom d'hôte. Ainsi, par exemple, "org."
correspondra à "https://borg.com" mais pas "https://example.org". Pour faire correspondre ces modèles, utilisez hostSuffix
.
hostContains
Facultatifstring
. Correspond si le hostname (en-US) de l'URL contient la chaîne donnée.- Pour tester si un composant de nom d'hôte commence par "foo", utilisez
".foo"
. Cela correspond à "www.foobar.com" et "foo.com", car un point implicite est ajouté au début du nom d'hôte. - Pour tester si un composant de nom d'hôte se termine par "foo", utilisez
"foo."
. - Pour tester si un composant de nom d'hôte correspond exactement à "foo", utilisez
".foo."
.
- Pour tester si un composant de nom d'hôte commence par "foo", utilisez
hostEquals
Facultatifstring
. Correspond si le nom d'hôte de l'URL est égal à une chaîne spécifiée.hostPrefix
Facultatifstring
. Correspond si le nom d'hôte de l'URL commence par une chaîne spécifiée.hostSuffix
Facultatifstring
. Correspond si le nom d'hôte de l'URL se termine par une chaîne spécifiée.- Exemple:
".example.com"
correspond à "http://www.example.com/", mais pas à "http://example.com/". - Exemple:
"example.com"
correspond à "http://www.example.com/", et "http://fakeexample.com/".
- Exemple:
pathContains
Facultatifstring
. Correspond si le segment de chemin de l'URL contient une chaîne spécifiée.pathEquals
Facultatifstring
. Correspond si le segment de chemin de l'URL est égal à une chaîne spécifiée.pathPrefix
Facultatifstring
. Correspond si le segment de chemin de l'URL commence par une chaîne spécifiée.pathSuffix
Facultatifstring
. Correspond si le segment de chemin de l'URL se termine par une chaîne spécifiée.queryContains
Facultatifstring
. Correspond si le segment de requête de l'URL contient une chaîne spécifiée.queryEquals
Facultatifstring
. Correspond si le segment de requête de l'URL est égal à une chaîne spécifiée.queryPrefix
Facultatifstring
. Correspond si le segment de requête de l'URL commence par une chaîne spécifiée.querySuffix
Facultatifstring
. Correspond si le segment de requête de l'URL se termine par une chaîne spécifiée.urlContains
Facultatifstring
. Correspond si l'URL (sans identificateur de fragment) contient une chaîne spécifiée. Les numéros de port sont supprimés de l'URL s'ils correspondent au numéro de port par défaut.urlEquals
Facultatifstring
. Correspond si l'URL (sans l'identificateur de fragment) est égale à une chaîne spécifiée. Les numéros de port sont supprimés de l'URL s'ils correspondent au numéro de port par défaut.urlMatches
Facultatifstring
. Correspond si l'URL (sans l'identificateur de fragment) correspond à une expression régulière. Les numéros de port sont supprimés de l'URL s'ils correspondent au numéro de port par défaut.- Par exemple :
urlMatches: "^[^:]*:(?://)?(?:[^/]*\\.)?mozilla\\.org/.*$"
correspond "http://mozilla.org/", "https://developer.mozilla.org/", "ftp://foo.mozilla.org/", mais pas "https://developer.fakemozilla.org/".
- Par exemple :
originAndPathMatches
Facultatifstring
. Correspond si l'URL sans segment de requête et l'identificateur de fragment correspondent à une expression régulière spécifiée. Les numéros de port sont supprimés de l'URL s'ils correspondent au numéro de port par défaut.urlPrefix
Facultatifstring
. Correspond si l'URL (sans l'identificateur de fragment) commence par une chaîne spécifiée. Les numéros de port sont supprimés de l'URL s'ils correspondent au numéro de port par défaut.- Exemple:
"https://developer"
correspond "https://developer.mozilla.org/" et "https://developers.facebook.com/".
- Exemple:
urlSuffix
Facultatifstring
. Correspond si l'URL (sans l'identificateur de fragment) se termine par une chaîne spécifiée. Les numéros de port sont supprimés de l'URL s'ils correspondent au numéro de port par défaut. Notez qu'un slash "/" implicite est ajoutée après l'hôte, donc"com/"
correspond "https://example.com", mais pas"com"
.schemas
Facultatifarray
of
. Correspond si le schéma de l'URL est identique à l'un des schémas spécifiés dans le tableau. Comme les schémas sont toujours convertis en minuscules, ils doivent toujours être en minuscules ou ne correspondent jamais.string
- Exemple:
["https"]
correspond uniquement aux URL HTTPS.
- Exemple:
ports
Facultatifarray
de
ou(integer
array
ofinteger
- Par exemple:
[80, 443, [1000, 1200]]
correspond à toutes les demandes sur les ports 80, 443, et dans la plage 1000-1200.
- Par exemple:
Compatibilité du navigateur
BCD tables only load in the browser
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.
Cette API est basée sur l'API Chromium chrome.events
. Cette documentation est dérivée de events.json
dans le code Chromium.
Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.