Beschreibung
Hinweis: Diese API wurde verworfen. Sehen Sie sich stattdessen die declarativeNetRequest API an. Verwenden Sie die chrome.declarativeWebRequest API, um laufende Anfragen abzufangen, zu blockieren oder zu ändern. Sie ist deutlich schneller als die chrome.webRequest API, da Sie Regeln registrieren können, die im Browser statt in der JavaScript-Engine ausgewertet werden. Dadurch werden Roundtrip-Latenzen reduziert und eine höhere Effizienz ermöglicht.
Berechtigungen
declarativeWebRequestSie müssen „declarativeWebRequest“ im Erweiterungsmanifest, um dies zu verwenden API und Hostberechtigungen.
{
  "name": "My extension",
  ...
  "permissions": [
    "declarativeWebRequest",
    "*://*/*"
  ],
  ...
}
Verfügbarkeit
Manifest
Für bestimmte Arten nicht sensibler Aktionen sind keine Hostberechtigungen erforderlich:
- CancelRequest
- IgnoreRules
- RedirectToEmptyDocument
- RedirectToTransparentImage
Die Aktion SendMessageToExtension() erfordert Hostberechtigungen für alle Hosts, deren Netzwerkanfragen
bei dem Sie eine Nachricht auslösen möchten.
Für alle anderen Aktionen sind Hostberechtigungen für alle URLs erforderlich.
Wenn beispielsweise "https://*.google.com/*" die einzige Hostberechtigung einer Erweiterung ist, hat eine solche
Erweiterung eine Regel für Folgendes einrichten:
- Anfrage an https://www.google.comoderhttps://anything.else.comabbrechen
- Beim Navigieren zu https://www.google.com, aber nicht zuhttps://something.else.comeine Nachricht senden.
Die Erweiterung kann keine Regel zum Weiterleiten von https://www.google.com zu https://mail.google.com einrichten.
Regeln
Die Declarative Web Request API entspricht den Konzepten der Declarative API. Sie können sich registrieren,
an das chrome.declarativeWebRequest.onRequest-Ereignisobjekt übergeben.
Die Declarative Web Request API unterstützt nur einen Übereinstimmungskriterientyp: RequestMatcher. Die
RequestMatcher stimmt nur dann mit Netzwerkanfragen überein, wenn alle aufgeführten Kriterien erfüllt sind. Die folgenden
RequestMatcher stimmt mit einer Netzwerkanfrage überein, wenn der Nutzer https://www.example.com in das Feld
Ominibox:
var matcher = new chrome.declarativeWebRequest.RequestMatcher({
  url: { hostSuffix: 'example.com', schemes: ['http'] },
  resourceType: ['main_frame']
});
Anfragen an https://www.example.com werden aufgrund des Schemas vom RequestMatcher abgelehnt.
Außerdem werden alle Anfragen für einen eingebetteten iFrame aufgrund des resourceType abgelehnt.
Wenn Sie alle Anfragen an „beispiel.de“ abbrechen möchten, können Sie die folgende Regel definieren:
var rule = {
  conditions: [
    new chrome.declarativeWebRequest.RequestMatcher({
      url: { hostSuffix: 'example.com' } })
  ],
  actions: [
    new chrome.declarativeWebRequest.CancelRequest()
  ]
};
Wenn Sie alle Anfragen an example.com und foobar.com abbrechen möchten, können Sie eine zweite Bedingung hinzufügen:
da jede Bedingung ausreicht, um alle angegebenen Aktionen auszulösen:
var rule2 = {
  conditions: [
    new chrome.declarativeWebRequest.RequestMatcher({
      url: { hostSuffix: 'example.com' } }),
    new chrome.declarativeWebRequest.RequestMatcher({
      url: { hostSuffix: 'foobar.com' } })
  ],
  actions: [
    new chrome.declarativeWebRequest.CancelRequest()
  ]
};
Registrieren Sie die Regeln wie folgt:
chrome.declarativeWebRequest.onRequest.addRules([rule2]);
Auswertung von Bedingungen und Maßnahmen
Die Declarative Web Request API richtet sich nach dem Lebenszyklusmodell für Webanfragen des Web- API anfordern Das bedeutet, dass Bedingungen nur in bestimmten Phasen einer Webanfrage getestet werden können Und dementsprechend können auch Aktionen nur in bestimmten Phasen ausgeführt werden. In den folgenden Tabellen sind die Anfragephasen, die mit Bedingungen und Aktionen kompatibel sind.
| Anfragephasen, in denen Bedingungsattribute verarbeitet werden können. | ||||
|---|---|---|---|---|
| Zustandsattribut | onBeforeRequest | onBeforeSendHeaders | onHeadersReceived | onAuthRequired | 
| url | ✓ | ✓ | ✓ | ✓ | 
| resourceType | ✓ | ✓ | ✓ | ✓ | 
| contentType | ✓ | |||
| excludeContentType | ✓ | |||
| responseHeaders | ✓ | |||
| excludeResponseHeaders | ✓ | |||
| requestHeaders | ✓ | |||
| excludeRequestHeaders | ✓ | |||
| thirdPartyForCookies | ✓ | ✓ | ✓ | ✓ | 
| Anfragephasen, in denen Aktionen ausgeführt werden können | ||||
| Ereignis | onBeforeRequest | onBeforeSendHeaders | onHeadersReceived | onAuthRequired | 
| AddRequestCookie | ✓ | |||
| AddResponseCookie | ✓ | |||
| AddResponseHeader | ✓ | |||
| CancelRequest | ✓ | ✓ | ✓ | ✓ | 
| EditRequestCookie | ✓ | |||
| EditResponseCookie | ✓ | |||
| IgnoreRules | ✓ | ✓ | ✓ | ✓ | 
| RedirectByRegEx | ✓ | ✓ | ||
| RedirectRequest | ✓ | ✓ | ||
| RedirectToEmptyDocument | ✓ | ✓ | ||
| RedirectToTransparentImage | ✓ | ✓ | ||
| RemoveRequestCookie | ✓ | |||
| RemoveRequestHeader | ✓ | |||
| RemoveResponseCookie | ✓ | |||
| RemoveResponseHeader | ✓ | |||
| SendMessageToExtension | ✓ | ✓ | ✓ | ✓ | 
| SetRequestHeader | ✓ | |||
Prioritäten zum Überschreiben von Regeln verwenden
Regeln können Prioritäten zugeordnet werden, wie in der Events API beschrieben. Dieser Mechanismus kann
um Ausnahmen auszudrücken. Im folgenden Beispiel werden alle Anfragen an Images mit dem Namen evil.jpg blockiert
außer auf dem Server „myserver.com“.
var rule1 = {
  priority: 100,
  conditions: [
    new chrome.declarativeWebRequest.RequestMatcher({
        url: { pathEquals: 'evil.jpg' } })
  ],
  actions: [
    new chrome.declarativeWebRequest.CancelRequest()
  ]
};
var rule2 = {
  priority: 1000,
  conditions: [
    new chrome.declarativeWebRequest.RequestMatcher({
      url: { hostSuffix: '.myserver.com' } })
  ],
  actions: [
    new chrome.declarativeWebRequest.IgnoreRules({
      lowerPriorityThan: 1000 })
  ]
};
chrome.declarativeWebRequest.onRequest.addRules([rule1, rule2]);
Die Aktion IgnoreRules wird in der Anfrage nicht beibehalten.
. Alle Bedingungen aller Regeln werden in jeder Phase einer Webanfrage ausgewertet. Wenn ein
IgnoreRules-Aktion ausgeführt wird, gilt nur für andere Aktionen, die für dieselbe
Web-Anfrage in derselben Phase.
Typen
AddRequestCookie
Fügt der Anfrage ein Cookie hinzu oder überschreibt ein Cookie für den Fall, dass bereits ein anderes Cookie mit demselben Namen vorhanden ist. Es wird empfohlen, das Cookies API zu verwenden, da dies rechenintensiv ist.
Attribute
- 
    Konstruktorvoidm Die Funktion constructorsieht so aus: <ph type="x-smartling-placeholder"></ph>(arg: AddRequestCookie) => {...} - 
    Argument
 - 
            Gibt zurück
 
- 
    
- 
    KeksCookie, das der Anfrage hinzugefügt werden soll. Kein Feld darf nicht definiert sein. 
AddResponseCookie
Fügt der Antwort ein Cookie hinzu oder überschreibt ein Cookie für den Fall, dass bereits ein anderes Cookie mit demselben Namen vorhanden ist. Es wird empfohlen, das Cookies API zu verwenden, da dies rechenintensiv ist.
Attribute
- 
    Konstruktorvoidm Die Funktion constructorsieht so aus: <ph type="x-smartling-placeholder"></ph>(arg: AddResponseCookie) => {...} - 
    Argument
 - 
            Gibt zurück
 
- 
    
- 
    KeksCookie, das der Antwort hinzugefügt werden soll. Der Name und der Wert müssen angegeben werden. 
AddResponseHeader
Fügt der Antwort auf diese Webanfrage den Antwortheader hinzu. Da mehrere Antwortheader unter Umständen denselben Namen haben, müssen Sie zuerst einen Antwortheader entfernen und dann einen neuen hinzufügen, um ihn zu ersetzen.
Attribute
- 
    Konstruktorvoidm Die Funktion constructorsieht so aus: <ph type="x-smartling-placeholder"></ph>(arg: AddResponseHeader) => {...} - 
    Argument
 - 
            Gibt zurück
 
- 
    
- 
    NameString Name des HTTP-Antwortheaders. 
- 
    WertString HTTP-Antwortheaderwert. 
CancelRequest
Deklarative Ereignisaktion, die eine Netzwerkanfrage storniert.
Attribute
- 
    Konstruktorvoidm Die Funktion constructorsieht so aus: <ph type="x-smartling-placeholder"></ph>(arg: CancelRequest) => {...} - 
    Argument
 - 
            Gibt zurück
 
- 
    
EditRequestCookie
Bearbeitet ein oder mehrere Cookies der Anfrage. Es wird empfohlen, das Cookies API zu verwenden, da dies rechenintensiv ist.
Attribute
- 
    Konstruktorvoidm Die Funktion constructorsieht so aus: <ph type="x-smartling-placeholder"></ph>(arg: EditRequestCookie) => {...} - 
    Argument
 - 
            Gibt zurück
 
- 
    
- 
    FilterFiltern Sie nach Cookies, die geändert werden. Alle leeren Einträge werden ignoriert. 
- 
    modificationAttribute, die in den Cookies, auf denen der Filter basiert, überschrieben werden sollen. Attribute, für die ein leerer String festgelegt ist, werden entfernt. 
EditResponseCookie
Bearbeitet ein oder mehrere Cookies der Antwort. Es wird empfohlen, das Cookies API zu verwenden, da dies rechenintensiv ist.
Attribute
- 
    Konstruktorvoidm Die Funktion constructorsieht so aus: <ph type="x-smartling-placeholder"></ph>(arg: EditResponseCookie) => {...} - 
    Argument
 - 
            Gibt zurück
 
- 
    
- 
    FilterFiltern Sie nach Cookies, die geändert werden. Alle leeren Einträge werden ignoriert. 
- 
    modificationAttribute, die in den Cookies, auf denen der Filter basiert, überschrieben werden sollen. Attribute, für die ein leerer String festgelegt ist, werden entfernt. 
FilterResponseCookie
Filter eines Cookies in HTTP-Antworten.
Attribute
- 
    ageLowerBoundZahl optional Einschließende Untergrenze für die Cookie-Lebensdauer (angegeben in Sekunden nach der aktuellen Zeit). Nur Cookies, deren Ablaufdatum und -uhrzeit auf „jetzt + ageLowerBound“ gesetzt sind oder später dieses Kriterium erfüllen. Sitzungscookies erfüllen die Kriterien dieses Filters nicht. Die Cookie-Lebensdauer wird entweder anhand von "max-age" oder „läuft ab“ Cookie-Attributen. Wenn beide angegeben sind, gilt „max-age“. wird die Lebensdauer von Cookies berechnet. 
- 
    ageUpperBoundZahl optional Inklusive Obergrenze für die Cookie-Lebensdauer (angegeben in Sekunden nach der aktuellen Zeit). Nur Cookies, deren Ablaufdatum und -uhrzeit im Intervall [now, now + ageUpperBound] liegen, erfüllen dieses Kriterium. Sitzungscookies und Cookies, deren Ablaufdatum und -uhrzeit in der Vergangenheit liegt, erfüllen die Kriterien dieses Filters nicht. Die Cookie-Lebensdauer wird entweder anhand von "max-age" oder „läuft ab“ Cookie-Attributen. Wenn beide angegeben sind, gilt „max-age“. wird die Lebensdauer von Cookies berechnet. 
- 
    DomainString optional Wert des Attributs „Domain-Cookie“. 
- 
    Gültig bisString optional Wert des Attributs „Läuft ab am Cookie“ 
- 
    httpOnlyString optional Vorhandensein des HttpOnly-Cookie-Attributs. 
- 
    maxAgeZahl optional Wert des Attributs „Max-Age-Cookie“ 
- 
    NameString optional Name eines Cookies. 
- 
    PfadString optional Wert des Pfad-Cookie-Attributs. 
- 
    sicherString optional Vorhandensein des Attributs „Sicheres Cookie“. 
- 
    sessionCookieBoolescher Wert optional Sitzungscookies werden gefiltert. Für Sitzungscookies ist keine Lebensdauer in „max-age“ angegeben. oder „läuft ab“ Attribute. 
- 
    WertString optional Wert eines Cookies, kann in doppelte Anführungszeichen aufgefüllt werden. 
HeaderFilter
Filtert Anfrageheader nach verschiedenen Kriterien. Mehrere Kriterien werden als Kombination ausgewertet.
Attribute
- 
    nameContainsstring | string[] optional Stimmt überein, wenn der Headername alle angegebenen Strings enthält. 
- 
    nameEqualsString optional Stimmt überein, wenn der Headername dem angegebenen String entspricht. 
- 
    namePrefixString optional Stimmt überein, wenn der Headername mit dem angegebenen String beginnt. 
- 
    nameSuffixString optional Stimmt überein, wenn der Headername mit dem angegebenen String endet. 
- 
    valueContainsstring | string[] optional Stimmt überein, wenn der Headerwert alle angegebenen Strings enthält. 
- 
    valueEqualsString optional Stimmt überein, wenn der Headerwert dem angegebenen String entspricht. 
- 
    valuePrefixString optional Stimmt überein, wenn der Headerwert mit dem angegebenen String beginnt. 
- 
    valueSuffixString optional Stimmt überein, wenn der Headerwert mit dem angegebenen String endet. 
IgnoreRules
Maskiert alle Regeln, die den angegebenen Kriterien entsprechen.
Attribute
- 
    Konstruktorvoidm Die Funktion constructorsieht so aus: <ph type="x-smartling-placeholder"></ph>(arg: IgnoreRules) => {...} - 
    Argument
 - 
            Gibt zurück
 
- 
    
- 
    hasTagString optional Wenn diese Option festgelegt ist, werden Regeln mit dem angegebenen Tag ignoriert. Dieses Ignorieren wird nicht beibehalten, sondern wirkt sich nur auf Regeln und deren Aktionen in derselben Netzwerkanfragephase aus. Die Regeln werden in absteigender Reihenfolge nach ihrer Priorität ausgeführt. Diese Aktion wirkt sich auf Regeln aus, die eine niedrigere Priorität haben als die aktuelle Regel. Regeln mit derselben Priorität können ignoriert werden oder nicht. 
- 
    lowerPriorityThanZahl optional Wenn diese Richtlinie konfiguriert ist, werden Regeln mit einer niedrigeren Priorität als dem angegebenen Wert ignoriert. Diese Begrenzung bleibt nicht bestehen. Sie wirkt sich nur auf Regeln und ihre Aktionen in derselben Netzwerkanfragephase aus. 
RedirectByRegEx
Leitet eine Anfrage weiter, indem ein regulärer Ausdruck auf die URL angewendet wird. Für reguläre Ausdrücke wird die RE2-Syntax verwendet.
Attribute
- 
    Konstruktorvoidm Die Funktion constructorsieht so aus: <ph type="x-smartling-placeholder"></ph>(arg: RedirectByRegEx) => {...} - 
    Argument
 - 
            Gibt zurück
 
- 
    
- 
    vonString Ein Übereinstimmungsmuster, das Erfassungsgruppen enthalten kann. Auf Erfassungsgruppen wird in der Perl-Syntax ($1, $2, ...) anstelle der RE2-Syntax (\1, \2, ...) verwiesen, um näher an regulären JavaScript-Ausdrücken zu sein. 
- 
    zuString Zielmuster. 
RedirectRequest
Deklarative Ereignisaktion, die eine Netzwerkanfrage weiterleitet.
Attribute
- 
    Konstruktorvoidm Die Funktion constructorsieht so aus: <ph type="x-smartling-placeholder"></ph>(arg: RedirectRequest) => {...} - 
    Argument
 - 
            Gibt zurück
 
- 
    
- 
    redirectUrlString Ziel, an das die Anfrage weitergeleitet wird. 
RedirectToEmptyDocument
Deklarative Ereignisaktion, die eine Netzwerkanfrage an ein leeres Dokument weiterleitet.
Attribute
- 
    Konstruktorvoidm Die Funktion constructorsieht so aus: <ph type="x-smartling-placeholder"></ph>(arg: RedirectToEmptyDocument) => {...} - 
    Argument
 - 
            Gibt zurück
 
- 
    
RedirectToTransparentImage
Deklarative Ereignisaktion, die eine Netzwerkanfrage an ein transparentes Bild weiterleitet.
Attribute
- 
    Konstruktorvoidm Die Funktion constructorsieht so aus: <ph type="x-smartling-placeholder"></ph>(arg: RedirectToTransparentImage) => {...} - 
    Argument
 - 
            Gibt zurück
 
- 
    
RemoveRequestCookie
Entfernt ein oder mehrere Anfrage-Cookies. Es wird empfohlen, das Cookies API zu verwenden, da dies rechenintensiv ist.
Attribute
- 
    Konstruktorvoidm Die Funktion constructorsieht so aus: <ph type="x-smartling-placeholder"></ph>(arg: RemoveRequestCookie) => {...} - 
    Argument
 - 
            Gibt zurück
 
- 
    
- 
    FilterFiltern Sie nach Cookies, die entfernt werden. Alle leeren Einträge werden ignoriert. 
RemoveRequestHeader
Entfernt den Anfrageheader des angegebenen Namens. Verwenden Sie „SetRequestHeader“ und „RemoveRequestHeader“ nicht mit demselben Header-Namen für dieselbe Anfrage. Jeder Anfrageheadername kommt in jeder Anfrage nur einmal vor.
Attribute
- 
    Konstruktorvoidm Die Funktion constructorsieht so aus: <ph type="x-smartling-placeholder"></ph>(arg: RemoveRequestHeader) => {...} - 
    Argument
 - 
            Gibt zurück
 
- 
    
- 
    NameString Name des HTTP-Anfrageheaders (Groß-/Kleinschreibung nicht berücksichtigend) 
RemoveResponseCookie
Entfernt ein oder mehrere Cookies der Antwort. Es wird empfohlen, das Cookies API zu verwenden, da dies rechenintensiv ist.
Attribute
- 
    Konstruktorvoidm Die Funktion constructorsieht so aus: <ph type="x-smartling-placeholder"></ph>(arg: RemoveResponseCookie) => {...} - 
    Argument
 - 
            Gibt zurück
 
- 
    
- 
    FilterFiltern Sie nach Cookies, die entfernt werden. Alle leeren Einträge werden ignoriert. 
RemoveResponseHeader
Entfernt alle Antwortheader der angegebenen Namen und Werte.
Attribute
- 
    Konstruktorvoidm Die Funktion constructorsieht so aus: <ph type="x-smartling-placeholder"></ph>(arg: RemoveResponseHeader) => {...} - 
    Argument
 - 
            Gibt zurück
 
- 
    
- 
    NameString Name des HTTP-Anfrageheaders (Groß-/Kleinschreibung nicht berücksichtigend) 
- 
    WertString optional HTTP-Anfrageheaderwert (Groß-/Kleinschreibung nicht berücksichtigend) 
RequestCookie
Ein Filter oder eine Spezifikation eines Cookies in HTTP-Anfragen.
Attribute
- 
    NameString optional Name eines Cookies. 
- 
    WertString optional Wert eines Cookies, kann in doppelte Anführungszeichen aufgefüllt werden. 
RequestMatcher
Gleicht Netzwerkereignisse anhand verschiedener Kriterien ab.
Attribute
- 
    Konstruktorvoidm Die Funktion constructorsieht so aus: <ph type="x-smartling-placeholder"></ph>(arg: RequestMatcher) => {...} - 
    Argument
 - 
            Gibt zurück
 
- 
    
- 
    contentTypestring[] optional Stimmt überein, wenn der MIME-Medientyp einer Antwort (aus dem HTTP Content-Type-Header) in der Liste enthalten ist. 
- 
    excludeContentTypestring[] optional Stimmt überein, wenn der MIME-Medientyp einer Antwort (aus dem HTTP Content-Type-Header) nicht in der Liste enthalten ist. 
- 
    excludeRequestHeadersHeaderFilter[] optional Stimmt überein, wenn keiner der Anfrageheader mit einem der HeaderFilters übereinstimmt. 
- 
    excludeResponseHeadersHeaderFilter[] optional Stimmt überein, wenn keiner der Antwortheader mit einem der HeaderFilters übereinstimmt. 
- 
    firstPartyForCookiesUrlUrlFilter optional <ph type="x-smartling-placeholder"></ph> EingestelltIgnoriert seit Version 82. Übereinstimmung mit der Bedingung, dass die Bedingungen des UrlFilter für die Erstanbieterfunktion erfüllt sind URL des Antrags. Erstanbieter Die URL eines Ersuchens, sofern vorhanden, kann sich von der Ziel-URL des Ersuchens unterscheiden und beschreibt, was als eigene URL angesehen wird damit Drittanbieter auf Cookies überprüfen können. 
- 
    requestHeadersHeaderFilter[] optional Stimmt überein, wenn einige Anfrageheader mit einem der HeaderFilters übereinstimmen. 
- 
    resourceTypeResourceType[] optional Stimmt überein, wenn der Anfragetyp einer Anfrage in der Liste enthalten ist. Anfragen, die mit keinem der Typen übereinstimmen, werden herausgefiltert. 
- 
    responseHeadersHeaderFilter[] optional Stimmt überein, wenn einige der Antwortheader mit einem der HeaderFilters übereinstimmen. 
- 
    BühnenPhase[] optional Enthält eine Liste von Strings, die Phasen beschreiben. Zulässige Werte sind „onBeforeRequest“, „onBeforeSendHeaders“, „onHeadersReceived“ und „onAuthRequired“. Wenn dieses Attribut vorhanden ist, werden die anwendbaren Phasen auf die aufgeführten begrenzt. Die gesamte Bedingung ist nur in Phasen anwendbar, die mit allen Attributen kompatibel sind. 
- 
    thirdPartyForCookiesBoolescher Wert optional <ph type="x-smartling-placeholder"></ph> EingestelltIgnoriert seit Version 87. Wenn die Richtlinie auf „true“ gesetzt ist, werden Anfragen abgeglichen, die den Richtlinien für Drittanbieter-Cookies unterliegen. Wird auf „false“ gesetzt, erfolgt eine Übereinstimmung mit allen anderen Anfragen. 
- 
    URLUrlFilter optional Stimmt überein, wenn die Bedingungen des UrlFilter für die URL der Anfrage erfüllt sind. 
ResponseCookie
Eine Spezifikation eines Cookies in HTTP-Antworten.
Attribute
- 
    DomainString optional Wert des Attributs „Domain-Cookie“. 
- 
    Gültig bisString optional Wert des Attributs „Läuft ab am Cookie“ 
- 
    httpOnlyString optional Vorhandensein des HttpOnly-Cookie-Attributs. 
- 
    maxAgeZahl optional Wert des Attributs „Max-Age-Cookie“ 
- 
    NameString optional Name eines Cookies. 
- 
    PfadString optional Wert des Pfad-Cookie-Attributs. 
- 
    sicherString optional Vorhandensein des Attributs „Sicheres Cookie“. 
- 
    WertString optional Wert eines Cookies, kann in doppelte Anführungszeichen aufgefüllt werden. 
SendMessageToExtension
Löst das Ereignis declarativeWebRequest.onMessage aus.
Attribute
- 
    Konstruktorvoidm Die Funktion constructorsieht so aus: <ph type="x-smartling-placeholder"></ph>(arg: SendMessageToExtension) => {...} - 
    Argument
 - 
            Gibt zurück
 
- 
    
- 
    NachrichtString Der Wert, der im Attribut messagedes Wörterbuchs übergeben wird, das an den Event-Handler übergeben wird.
SetRequestHeader
Legt den Anfrageheader des angegebenen Namens auf den angegebenen Wert fest. Wenn noch kein Header mit dem angegebenen Namen vorhanden ist, wird ein neuer erstellt. Beim Headernamenvergleich wird immer die Groß-/Kleinschreibung nicht berücksichtigt. Jeder Anfrageheadername kommt in jeder Anfrage nur einmal vor.
Attribute
- 
    Konstruktorvoidm Die Funktion constructorsieht so aus: <ph type="x-smartling-placeholder"></ph>(arg: SetRequestHeader) => {...} - 
    Argument
 - 
            Gibt zurück
 
- 
    
- 
    NameString Name des HTTP-Anfrageheaders. 
- 
    WertString Wert für den HTTP-Anfrageheader. 
Stage
Enum
"onBeforeRequest" 
 
"onBeforeSendHeaders" 
 
"onHeadersReceived" 
 
"onAuthRequired" 
 
Ereignisse
onMessage
chrome.declarativeWebRequest.onMessage.addListener(
callback: function,
)
Wird ausgelöst, wenn über declarativeWebRequest.SendMessageToExtension eine Nachricht von einer Aktion der deklarativen Webanfrage-API gesendet wird
Parameter
- 
    callbackFunktion Der Parameter callbacksieht so aus: <ph type="x-smartling-placeholder"></ph>(details: object) => void - 
    DetailsObjekt - 
    documentIdString optional Eine UUID des Dokuments, von dem die Anfrage stammt. 
- 
    documentLifecycleDer Lebenszyklus, in dem sich das Dokument befindet. 
- 
    frameIdZahl Der Wert 0 gibt an, dass die Anfrage im Hauptframe erfolgt. Ein positiver Wert gibt die ID eines Subframes an, in dem die Anfrage erfolgt. Wenn das Dokument eines (Sub-)Frames geladen wird ( typeistmain_frameodersub_frame), gibtframeIddie ID dieses Frames an, nicht die ID des äußeren Frames. Frame-IDs sind innerhalb eines Tabs eindeutig.
- 
    frameTypeDer Frame-Typ, in dem die Navigation erfolgte. 
- 
    NachrichtString Die vom Anrufskript gesendete Nachricht. 
- 
    methodString Standard-HTTP-Methode. 
- 
    parentDocumentIdString optional Eine UUID des übergeordneten Dokuments, zu dem dieser Frame gehört. Dieser Wert wird nicht festgelegt, wenn kein übergeordnetes Element vorhanden ist. 
- 
    parentFrameIdZahl ID des Frames, der den Frame umschließt, der die Anfrage gesendet hat. Legen Sie diesen Wert auf -1 fest, wenn kein übergeordneter Frame vorhanden ist. 
- 
    requestIdString Die ID der Anfrage. Anfrage-IDs sind innerhalb einer Browsersitzung eindeutig. Daher können sie verwendet werden, um verschiedene Ereignisse derselben Anfrage zuzuordnen. 
- 
    PhaseDie Phase der Netzwerkanfrage, in der das Ereignis ausgelöst wurde. 
- 
    tabIdZahl Die ID des Tabs, auf dem die Anfrage ausgeführt wird. Legen Sie den Wert auf -1 fest, wenn sich die Anfrage nicht auf einen Tab bezieht. 
- 
    timeStampZahl Die Zeit, zu der dieses Signal ausgelöst wird, in Millisekunden seit der Epoche. 
- 
    Wie die angeforderte Ressource verwendet wird. 
- 
    URLString 
 
- 
    
 
- 
    
onRequest
        Stellt die Declarative Event API bereit, die aus addRules, removeRules und getRules besteht.
      
Bedingungen
Aktionen