chrome.declarativeNetRequest

Beschrijving

De chrome.declarativeNetRequest API wordt gebruikt om netwerkverzoeken te blokkeren of te wijzigen door middel van declaratieve regels. Hierdoor kunnen extensies netwerkverzoeken aanpassen zonder ze te onderscheppen en de inhoud ervan te bekijken, wat zorgt voor meer privacy.

Toestemmingen

declarativeNetRequest
declarativeNetRequestWithHostAccess

declarativeNetRequestFeedback
host_permissions

Beschikbaarheid

Chrome 84+

Manifest

Naast de hierboven beschreven machtigingen vereisen bepaalde typen regelsets, met name statische regelsets, dat de manifestsleutel "declarative_net_request" wordt gedeclareerd. Deze sleutel moet een dictionary zijn met één sleutel genaamd "rule_resources" . Deze sleutel is een array die dictionaries van het type Ruleset bevat, zoals hieronder weergegeven. (Merk op dat de naam 'Ruleset' niet in de JSON van het manifest voorkomt, omdat het slechts een array is.) Statische regelsets worden later in dit document uitgelegd.

{
  "name": "My extension",
  ...

  "declarative_net_request" : {
    "rule_resources" : [{
      "id": "ruleset_1",
      "enabled": true,
      "path": "rules_1.json"
    }, {
      "id": "ruleset_2",
      "enabled": false,
      "path": "rules_2.json"
    }]
  },
  "permissions": [
    "declarativeNetRequest",
    "declarativeNetRequestFeedback",
  ],
  "host_permissions": [
    "http://www.blogger.com/*",
    "http://*.google.com/*"
  ],
  ...
}

Concepten en gebruik

Om deze API te gebruiken, moet u een of meer regelsets specificeren. Een regelset bevat een array met regels. Een enkele regel doet een van de volgende dingen:

  • Blokkeer een netwerkverzoek.
  • Wijzig het schema (http naar https).
  • Voorkom dat een verzoek wordt geblokkeerd door alle overeenkomende blokkeringsregels te negeren.
  • Een netwerkverzoek omleiden.
  • Wijzig de headers van het verzoek of het antwoord.

Er zijn drie soorten regelsets, die op enigszins verschillende manieren worden beheerd.

Dynamisch
Deze instellingen blijven behouden tijdens browsersessies en extensie-updates en worden beheerd met JavaScript zolang een extensie in gebruik is.
Sessie
De instellingen worden gewist wanneer de browser wordt afgesloten en wanneer een nieuwe versie van de extensie wordt geïnstalleerd. Sessieregels worden beheerd met behulp van JavaScript zolang een extensie in gebruik is.
Statisch
De statische regels worden verpakt, geïnstalleerd en bijgewerkt wanneer een extensie wordt geïnstalleerd of geüpgraded. Ze worden opgeslagen in JSON-bestanden en vermeld in het manifestbestand.

In de volgende paragrafen worden de verschillende soorten regelsets in detail uitgelegd.

Dynamische en sessiegebonden regelsets

Dynamische en sessieregels worden beheerd met behulp van JavaScript zolang een extensie in gebruik is.

  • Dynamische regels blijven behouden gedurende browsersessies en bij updates van extensies.
  • Sessieregels worden gewist wanneer de browser wordt afgesloten en wanneer een nieuwe versie van de extensie wordt geïnstalleerd.

Er is slechts één exemplaar van elk van deze regeltypen. Een extensie kan dynamisch regels toevoegen of verwijderen door de functies updateDynamicRules() en updateSessionRules() aan te roepen, mits de regellimieten niet worden overschreden. Zie Regellimieten voor meer informatie over regellimieten . Een voorbeeld hiervan is te vinden onder codevoorbeelden .

Statische regelsets

In tegenstelling tot dynamische en sessieregels worden statische regels verpakt, geïnstalleerd en bijgewerkt wanneer een extensie wordt geïnstalleerd of geüpgraded. Ze worden opgeslagen in regelbestanden in JSON-formaat, die aan de extensie worden doorgegeven via de sleutels "declarative_net_request" en "rule_resources" zoals hierboven beschreven , evenals een of meer Ruleset -woordenboeken. Een Ruleset -woordenboek bevat een pad naar het regelbestand, een ID voor de regelset in het bestand en of de regelset is ingeschakeld of uitgeschakeld. De laatste twee zijn belangrijk wanneer u een regelset programmatisch in- of uitschakelt.

{
  ...
  "declarative_net_request" : {
    "rule_resources" : [{
      "id": "ruleset_1",
      "enabled": true,
      "path": "rules_1.json"
    },
    ...
    ]
  }
  ...
}

Om regelbestanden te testen, laadt u uw extensie in uitgepakte toestand . Foutmeldingen en waarschuwingen over ongeldige statische regels worden alleen weergegeven voor uitgepakte extensies. Ongeldige statische regels in ingepakte extensies worden genegeerd.

Statische regels en regelsets in- en uitschakelen

Zowel individuele statische regels als complete sets statische regels kunnen tijdens de uitvoering worden in- of uitgeschakeld.

De set ingeschakelde statische regels en regelsets blijft behouden tussen browsersessies. Deze worden echter niet behouden bij updates van extensies, wat betekent dat na een update alleen de regels beschikbaar zijn die u in uw regelbestanden hebt laten staan.

Om prestatieproblemen te voorkomen, gelden er ook limieten voor het aantal regels en regelsets dat tegelijkertijd kan worden ingeschakeld. Roep getAvailableStaticRuleCount() aan om het aantal extra regels te controleren dat kan worden ingeschakeld. Zie Regellimieten voor meer informatie over regellimieten .

Om statische regels in of uit te schakelen, roept u updateStaticRules() aan. Deze methode accepteert een UpdateStaticRulesOptions object, dat arrays bevat met ID's van regels die moeten worden in- of uitgeschakeld. De ID's worden gedefinieerd met behulp van de sleutel "id" in het woordenboek Ruleset .

Om statische regelsets in of uit te schakelen, roept u updateEnabledRulesets() aan. Deze methode accepteert een UpdateRulesetOptions object, dat arrays bevat met ID's van regelsets die moeten worden in- of uitgeschakeld. De ID's worden gedefinieerd met behulp van de sleutel "id" in het Ruleset -woordenboek.

Bouwregels

Ongeacht het type, begint een regel met vier velden, zoals hieronder weergegeven. De sleutels "id" en "priority" accepteren een getal, terwijl de sleutels "action" en "condition" meerdere blokkerings- en omleidingsvoorwaarden kunnen bevatten. De volgende regel blokkeert alle scriptverzoeken afkomstig van "foo.com" naar elke URL die "abc" als substring bevat.

{
  "id" : 1,
  "priority": 1,
  "action" : { "type" : "block" },
  "condition" : {
    "urlFilter" : "abc",
    "initiatorDomains" : ["foo.com"],
    "resourceTypes" : ["script"]
  }
}

urlFilter overeenkomende tekens

De sleutel "condition" van een regel maakt een "urlFilter" -sleutel mogelijk om acties uit te voeren op URL's binnen een specifiek domein. Je maakt patronen met behulp van patroonmatching-tokens . Enkele voorbeelden worden hieronder weergegeven.

urlFilter Wedstrijden Komt niet overeen
"abc" https://abcd.com
https://example.com/abcd		 https://ab.com
"abc*d" https://abcd.com
https://example.com/abcxyzd		 https://abc.com
"||a.example.com" https://a.example.com/
https://baexample.com/xyz		 https://example.com/
"|https*" https://example.com http://example.com/
http://https.com
"example*^123|" https://example.com/123
http://abc.com/example?123		 https://example.com/1234
https://abc.com/example0123

Prioritering van regels

Regels worden geactiveerd door verzoeken die vanaf webpagina's worden verzonden. Als meerdere regels overeenkomen met een bepaald verzoek, moeten de regels worden geprioriteerd. In dit gedeelte wordt uitgelegd hoe ze worden geprioriteerd. Prioritering vindt plaats in twee fasen.

  1. De prioriteit wordt bepaald voor regels binnen een extensie.
  2. Als meer dan één extensie een regel op een verzoek kan toepassen, wordt de prioriteit bepaald voor alle extensies die overeenkomen met dat specifieke verzoek.

Je kunt het matchen als volgt bekijken: welke regel een bepaalde extensie ook prioriteert, die regel zal vervolgens ook geprioriteerd worden ten opzichte van regels van andere extensies.

Prioritering van regels binnen een extensie

Binnen één enkele extensie wordt de prioriteit bepaald aan de hand van het volgende proces:

  1. De regel met de hoogste door de ontwikkelaar gedefinieerde prioriteit (oftewel het veld "priority" ) wordt geretourneerd.

  2. Als er meer dan één regel is met de hoogste door de ontwikkelaar gedefinieerde prioriteit, worden de regels geprioriteerd op basis van het veld "action" , in de volgende volgorde:

    1. allow
    2. allowAllRequests
    3. block
    4. upgradeScheme
    5. redirect

  3. Als het actietype geen block of redirect is, worden alle overeenkomende modifyHeaders -regels geëvalueerd. Houd er rekening mee dat als er regels zijn met een door de ontwikkelaar gedefinieerde prioriteit die lager is dan de prioriteit die is opgegeven voor allow en allowAllRequests , deze regels worden genegeerd.

  4. Als meerdere regels dezelfde header wijzigen, wordt de wijziging bepaald door het door de ontwikkelaar gedefinieerde veld "priority" en door de gespecificeerde bewerkingen.

    • Als een regel iets toevoegt aan een header, kunnen regels met een lagere prioriteit alleen iets toevoegen aan die header. Instellen en verwijderen zijn niet toegestaan.
    • Als een regel een koptekst instelt, kunnen regels met een lagere prioriteit alleen aan die koptekst toevoegen. Andere wijzigingen zijn niet toegestaan.
    • Als een regel een koptekst verwijdert, kunnen regels met een lagere prioriteit die koptekst niet verder wijzigen.

Prioriteitsbepaling van regels tussen extensies

Als slechts één extensie een regel heeft die overeenkomt met een verzoek, wordt die regel toegepast. Maar als meer dan één extensie overeenkomt met een verzoek, wordt de volgende procedure gebruikt:

  1. Regels worden geprioriteerd op basis van het veld "action" , in de volgende volgorde:

    1. block
    2. redirect of upgradeScheme
    3. allow ​​of alle allowAllRequests

  2. Als er meer dan één regel van toepassing is, krijgt de meest recent geïnstalleerde extensie voorrang.

Regelgrenzen

Het laden en evalueren van regels in de browser brengt prestatieverlies met zich mee, waardoor er beperkingen gelden bij het gebruik van de API. Deze beperkingen zijn afhankelijk van het type regel dat u gebruikt.

Statische regels

Statische regels zijn regels die zijn gespecificeerd in regelbestanden die zijn gedeclareerd in het manifestbestand. Een extensie kan maximaal 50 statische regelsets specificeren als onderdeel van de manifestsleutel "rule_resources" , maar slechts 10 van deze regelsets kunnen tegelijkertijd worden ingeschakeld. Dit laatste wordt de MAX_NUMBER_OF_ENABLED_STATIC_RULESETS genoemd. Gezamenlijk zijn deze regelsets gegarandeerd minimaal 30.000 regels. Dit wordt de GUARANTEED_MINIMUM_STATIC_RULES genoemd.

Het aantal beschikbare regels daarna hangt af van hoeveel regels zijn ingeschakeld door alle extensies die in de browser van de gebruiker zijn geïnstalleerd. U kunt dit aantal tijdens de uitvoering achterhalen door de functie getAvailableStaticRuleCount() aan te roepen. Een voorbeeld hiervan vindt u in de codevoorbeelden .

Dynamische en sessieregels

De limieten voor dynamische en sessieregels zijn eenvoudiger dan voor statische regels. Het totale aantal van beide mag niet meer dan 5000 bedragen. Dit wordt de MAX_NUMBER_OF_DYNAMIC_AND_SESSION_RULES genoemd.

Regels die gebruikmaken van reguliere expressies

Alle soorten regels kunnen reguliere expressies gebruiken; het totale aantal regex-regels van elk type mag echter niet meer dan 1000 bedragen. Dit wordt de MAX_NUMBER_OF_REGEX_RULES genoemd.

Bovendien moet elke regel na compilatie kleiner zijn dan 2 KB. Dit hangt ruwweg samen met de complexiteit van de regel. Als u een regel probeert te laden die deze limiet overschrijdt, krijgt u een waarschuwing zoals hieronder te zien en wordt de regel genegeerd.

rules_1.json: Rule with id 1 specified a more complext regex than allowed
as part of the "regexFilter" key.

Interacties met servicemedewerkers

Een declarativeNetRequest is alleen van toepassing op verzoeken die de netwerkstack bereiken. Dit omvat reacties uit de HTTP-cache, maar mogelijk niet reacties die via de onfetch handler van een service worker gaan. DeclarativeNetRequest heeft geen invloed op reacties die door de service worker worden gegenereerd of die uit CacheStorage worden opgehaald, maar wel op aanroepen van fetch() in een service worker.

Webtoegankelijke bronnen

Een declarativeNetRequest-regel mag geen omleiding uitvoeren van een openbare resourceaanvraag naar een resource die niet via het web toegankelijk is. Dit leidt tot een foutmelding. Dit geldt zelfs als de opgegeven, via het web toegankelijke resource eigendom is van de omleidende extensie. Om resources voor declarativeNetRequest te declareren, gebruikt u de array "web_accessible_resources" in het manifest.

Voorbeelden

Codevoorbeelden

Dynamische regels bijwerken

Het volgende voorbeeld laat zien hoe je updateDynamicRules() aanroept. De procedure voor updateSessionRules() is hetzelfde.

// Get arrays containing new and old rules
const newRules = await getNewRules();
const oldRules = await chrome.declarativeNetRequest.getDynamicRules();
const oldRuleIds = oldRules.map(rule => rule.id);

// Use the arrays to update the dynamic rules
await chrome.declarativeNetRequest.updateDynamicRules({
  removeRuleIds: oldRuleIds,
  addRules: newRules
});

Statische regelsets bijwerken

Het volgende voorbeeld laat zien hoe u regelsets kunt in- en uitschakelen, rekening houdend met het aantal beschikbare en het maximaal aantal ingeschakelde statische regelsets. Dit doet u wanneer het aantal benodigde statische regels het toegestane aantal overschrijdt. Om dit te laten werken, moeten sommige van uw regelsets geïnstalleerd zijn met een aantal uitgeschakeld (door "Enabled" op false te zetten in het manifestbestand).

async function updateStaticRules(enableRulesetIds, disableCandidateIds) {
  // Create the options structure for the call to updateEnabledRulesets()
  let options = { enableRulesetIds: enableRulesetIds }
  // Get the number of enabled static rules
  const enabledStaticCount = await chrome.declarativeNetRequest.getEnabledRulesets();
  // Compare rule counts to determine if anything needs to be disabled so that
  // new rules can be enabled
  const proposedCount = enableRulesetIds.length;
  if (enabledStaticCount + proposedCount > chrome.declarativeNetRequest.MAX_NUMBER_OF_ENABLED_STATIC_RULESETS) {
    options.disableRulesetIds = disableCandidateIds
  }
  // Update the enabled static rules
  await chrome.declarativeNetRequest.updateEnabledRulesets(options);
}

Voorbeelden van regels

De onderstaande voorbeelden illustreren hoe Chrome prioriteit geeft aan regels in een extensie. Wanneer u deze regels bekijkt, kunt u ze het beste in een apart venster openen.

De "prioriteitssleutel"

Deze voorbeelden vereisen hosttoegang tot *://*.example.com/* .

Om de prioriteit van een bepaalde URL te bepalen, kijk je naar de (door de ontwikkelaar gedefinieerde) sleutel "priority" , de sleutel "action" en de sleutel "urlFilter" . Deze voorbeelden verwijzen naar het onderstaande voorbeeldregelbestand.

Navigatie naar https://google.com
Twee regels zijn van toepassing op deze URL: de regels met ID 1 en 4. Regel 1 is van toepassing omdat "block" -acties een hogere prioriteit hebben dan "redirect" -acties. De overige regels zijn niet van toepassing omdat ze gelden voor langere URL's.
Navigatie naar https://google.com/1234
Vanwege de langere URL komt de regel met ID 2 nu overeen met de regels met ID 1 en 4. De regel met ID 2 is van toepassing omdat "allow" een hogere prioriteit heeft dan "block" en "redirect" .
Navigatie naar https://google.com/12345
Alle vier regels komen overeen met deze URL. De regel met ID 3 is van toepassing omdat de door de ontwikkelaar gedefinieerde prioriteit de hoogste van de groep is. 
[
  {
    "id": 1,
    "priority": 1,
    "action": { "type": "block" },
    "condition": {"urlFilter": "google.com", "resourceTypes": ["main_frame"] }
  },
  {
    "id": 2,
    "priority": 1,
    "action": { "type": "allow" },
    "condition": { "urlFilter": "google.com/123", "resourceTypes": ["main_frame"] }
  },
  {
    "id": 3,
    "priority": 2,
    "action": { "type": "block" },
    "condition": { "urlFilter": "google.com/12345", "resourceTypes": ["main_frame"] }
  },
  {
    "id": 4,
    "priority": 1,
    "action": { "type": "redirect", "redirect": { "url": "https://example.com" } },
    "condition": { "urlFilter": "google.com", "resourceTypes": ["main_frame"] }
  },
]

Omleidingen

Het onderstaande voorbeeld vereist hosttoegang tot *://*.example.com/* .

Het volgende voorbeeld laat zien hoe je een verzoek van example.com kunt doorsturen naar een pagina binnen de extensie zelf. Het extensiepad /a.jpg wordt omgezet naar chrome-extension://EXTENSION_ID/a.jpg , waarbij EXTENSION_ID de ID van je extensie is. Om dit te laten werken, moet /a.jpg in het manifest als een webtoegankelijke bron worden gedeclareerd.

{
  "id": 1,
  "priority": 1,
  "action": { "type": "redirect", "redirect": { "extensionPath": "/a.jpg" } },
  "condition": {
    "urlFilter": "https://www.example.com",
    "resourceTypes": ["main_frame"]
  }
}

Het volgende voorbeeld gebruikt de sleutel "transform" om door te verwijzen naar een subdomein van example.com. Het gebruikt een domeinnaamanker ("||") om verzoeken met elk schema van example.com te onderscheppen. De sleutel "scheme" in "transform" geeft aan dat doorverwijzingen naar het subdomein altijd "https" zullen gebruiken.

{
  "id": 1,
  "priority": 1,
  "action": {
    "type": "redirect",
    "redirect": {
      "transform": { "scheme": "https", "host": "new.example.com" }
    }
  },
  "condition": {
    "urlFilter": "||example.com",
    "resourceTypes": ["main_frame"]
  }
}

Het volgende voorbeeld gebruikt reguliere expressies om door te verwijzen van https://www.abc.xyz.com/path naar https://abc.xyz.com/path . Let in de sleutel "regexFilter" op hoe punten worden ontsnapt en dat de vastleggingsgroep "abc" of "def" selecteert. De sleutel "regexSubstitution" specificeert de eerste overeenkomst van de reguliere expressie met behulp van "\1". In dit geval wordt "abc" uit de omgeleide URL gehaald en in de vervanging geplaatst. 

{
  "id": 1,
  "priority": 1,
  "action": {
    "type": "redirect",
    "redirect": {
      "regexSubstitution": "https://\\1.xyz.com/"
    }
  },
  "condition": {
    "regexFilter": "^https://www\\.(abc|def)\\.xyz\\.com/",
    "resourceTypes": [
      "main_frame"
    ]
  }
}

Kopteksten

Het volgende voorbeeld verwijdert alle cookies uit zowel een hoofdvenster als alle subvensters. 

{
  "id": 1,
  "priority": 1,
  "action": {
    "type": "modifyHeaders",
    "requestHeaders": [{ "header": "cookie", "operation": "remove" }]
  },
  "condition": { "resourceTypes": ["main_frame", "sub_frame"] }
}

Soorten

DomainType

Dit beschrijft of het verzoek afkomstig is van de eerste of derde partij van het frame waarin het is ontstaan. Een verzoek is afkomstig van de eerste partij als het hetzelfde domein (eTLD+1) heeft als het frame waarin het verzoek is ontstaan.

Enum

"firstParty"
Het netwerkverzoek is de eerste partij in het frame waarin het is ontstaan.

"derde partij"
Het netwerkverzoek is een derde partij ten opzichte van het frame waarin het is ontstaan.

ExtensionActionOptions

Chrome 88+

Eigenschappen

  • toonActieAantalAlsBadgeTekst

    boolean optioneel

    Of het aantal acties voor een pagina automatisch als badge-tekst van de extensie moet worden weergegeven. Deze voorkeur blijft behouden tussen sessies.

  • tabUpdate

    TabActionCountUpdate optioneel

    Chrome 89+

    Details over hoe het aantal acties op het tabblad moet worden aangepast.

GetDisabledRuleIdsOptions

Chrome 111+

Eigenschappen

  • regelssetId

    snaar

    De ID die overeenkomt met een statische Ruleset .

GetRulesFilter

Chrome 111+

Eigenschappen

  • regel-ID's

    nummer[] optioneel

    Indien gespecificeerd, worden alleen regels met overeenkomende ID's opgenomen.

HeaderInfo

Chrome 128+

Eigenschappen

  • uitgesloten waarden

    string[] optioneel

    Indien gespecificeerd, wordt aan deze voorwaarde niet voldaan als de koptekst bestaat, maar de waarde ervan ten minste één element uit deze lijst bevat. Hierbij wordt dezelfde syntaxis voor het matchpatroon gebruikt als values .

  • koptekst

    snaar

    De naam van de header. Deze voorwaarde komt alleen overeen met de naam als zowel values als excludedValues niet zijn gespecificeerd.

  • waarden

    string[] optioneel

    Indien gespecificeerd, komt deze voorwaarde overeen als de waarde van de header overeenkomt met ten minste één patroon in deze lijst. Dit ondersteunt hoofdletterongevoelige vergelijking van headerwaarden plus de volgende constructies:

    '*' : Komt overeen met een willekeurig aantal tekens.

    '?' : Komt overeen met nul of één teken(s).

    '*' en '?' kunnen worden ontsnapt met een backslash, bijvoorbeeld '\*' en '\?'

HeaderOperation

Chrome 86+

Dit beschrijft de mogelijke bewerkingen voor een "modifyHeaders"-regel.

Enum

"toevoegen"
Voegt een nieuwe vermelding toe voor de opgegeven header. Bij het wijzigen van de headers van een verzoek wordt deze bewerking alleen ondersteund voor specifieke headers .

"set"
Stelt een nieuwe waarde in voor de opgegeven header en verwijdert alle bestaande headers met dezelfde naam.

"verwijderen"
Verwijdert alle vermeldingen voor de opgegeven koptekst.

IsRegexSupportedResult

Chrome 87+

Eigenschappen

  • wordt ondersteund

    booleaans

  • reden

    UnsupportedRegexReason (optioneel )

    Geeft de reden aan waarom de reguliere expressie niet wordt ondersteund. Wordt alleen weergegeven als isSupported onwaar is.

MatchedRule

Eigenschappen

  • regel-ID

    nummer

    De ID van een overeenkomende regel.

  • regelssetId

    snaar

    De ID van de Ruleset waartoe deze regel behoort. Voor een regel afkomstig uit de set dynamische regels is dit gelijk aan DYNAMIC_RULESET_ID .

MatchedRuleInfo

Eigenschappen

  • regel

    MatchedRule

  • tabId

    nummer

    De tab-ID van het tabblad van waaruit het verzoek afkomstig is, indien het tabblad nog actief is. Anders -1.

  • tijdstempel

    nummer

    Het tijdstip waarop de regel werd gevonden. Tijdstempels komen overeen met de JavaScript-conventie voor tijden, oftewel het aantal milliseconden sinds de epoch.

MatchedRuleInfoDebug

Eigenschappen

MatchedRulesFilter

Eigenschappen

  • minTijdstempel

    nummer optioneel

    Indien gespecificeerd, worden alleen regels na het opgegeven tijdstempel gematcht.

  • tabId

    nummer optioneel

    Indien gespecificeerd, worden alleen regels voor het betreffende tabblad gematcht. Regels die niet aan een actief tabblad zijn gekoppeld, worden ook gematcht als de waarde -1 is ingesteld.

ModifyHeaderInfo

Chrome 86+

Eigenschappen

  • koptekst

    snaar

    De naam van de header die moet worden gewijzigd.

  • De handeling die op een header moet worden uitgevoerd.

  • waarde

    string optioneel

    De nieuwe waarde voor de header. Moet worden opgegeven voor append en set .

QueryKeyValue

Eigenschappen

  • sleutel

    snaar

  • alleen vervangen

    boolean optioneel

    Chrome 94+

    Indien waar, wordt de zoeksleutel alleen vervangen als deze al aanwezig is. Anders wordt de sleutel ook toegevoegd als deze ontbreekt. De standaardwaarde is onwaar.

  • waarde

    snaar

QueryTransform

Eigenschappen

  • addOrReplaceParams

    QueryKeyValue [] optioneel

    De lijst met sleutel-waardeparen die moeten worden toegevoegd of vervangen.

  • verwijderParams

    string[] optioneel

    De lijst met zoektermen die verwijderd moeten worden.

Redirect

Eigenschappen

  • uitbreidingspad

    string optioneel

    Pad relatief ten opzichte van de extensiemap. Moet beginnen met '/'.

  • regexSubstitution

    string optioneel

    Vervangingspatroon voor regels die een regexFilter specificeren. De eerste overeenkomst van regexFilter in de URL wordt vervangen door dit patroon. Binnen regexSubstitution kunnen backslash-escaped cijfers (\1 tot \9) worden gebruikt om de overeenkomstige vastleggingsgroepen in te voegen. \0 verwijst naar de volledige overeenkomende tekst.

  • transformeren

    URLTransform optioneel

    Uit te voeren URL-transformaties.

  • URL

    string optioneel

    De redirect-URL. Omleidingen naar JavaScript-URL's zijn niet toegestaan.

RegexOptions

Chrome 87+

Eigenschappen

  • isCaseSensitive

    boolean optioneel

    Of de opgegeven regex expressie hoofdlettergevoelig is. Standaard is dit waar.

  • reguliere expressie

    snaar

    De reguliere expressie om te controleren.

  • vereisen Vastleggen

    boolean optioneel

    Of de opgegeven regex vastlegging vereist. Vastlegging is alleen vereist voor omleidingsregels die een regexSubstition -actie specificeren. De standaardwaarde is false.

RequestDetails

Eigenschappen

  • documentId

    string optioneel

    Chrome 106+

    De unieke identificatiecode voor het document van het frame, indien dit verzoek betrekking heeft op een frame.

  • documentLevenscyclus

    DocumentLifecycle optioneel

    Chrome 106+

    De levenscyclus van het framedocument, indien dit verzoek betrekking heeft op een frame.

  • frameId

    nummer

    De waarde 0 geeft aan dat het verzoek plaatsvindt in het hoofdvenster; een positieve waarde geeft de ID aan van een subvenster waarin het verzoek plaatsvindt. Als het document van een (sub)venster wordt geladen ( type is main_frame of sub_frame ), geeft frameId de ID van dit venster aan, niet de ID van het buitenste venster. Venster-ID's zijn uniek binnen een tabblad.

  • frameType

    FrameType optioneel

    Chrome 106+

    Het type frame, indien dit verzoek om een ​​frame gaat.

  • initiatiefnemer

    string optioneel

    De oorsprong waar het verzoek vandaan kwam. Deze verandert niet door omleidingen. Als dit een ondoorzichtige oorsprong is, wordt de tekenreeks 'null' gebruikt.

  • methode

    snaar

    Standaard HTTP-methode.

  • parentDocumentId

    string optioneel

    Chrome 106+

    De unieke identificatiecode voor het bovenliggende document van het frame, indien dit verzoek betrekking heeft op een frame en een bovenliggend document heeft.

  • parentFrameId

    nummer

    ID van het frame dat het frame omsluit dat het verzoek heeft verzonden. Stel in op -1 als er geen ouderframe bestaat.

  • verzoek-ID

    snaar

    Het ID van het verzoek. Verzoek-ID's zijn uniek binnen een browsersessie.

  • tabId

    nummer

    De ID van het tabblad waarop het verzoek plaatsvindt. Stel deze in op -1 als het verzoek niet aan een tabblad is gekoppeld.

  • Het resourcetype van het verzoek.

  • URL

    snaar

    De URL van het verzoek.

RequestMethod

Chrome 91+

Dit beschrijft de HTTP-verzoekmethode van een netwerkverzoek.

Enum

"verbinden"

"verwijderen"

"krijgen"

"hoofd"

"opties"

"lapje"

"na"

"neerzetten"

"ander"

ResourceType

Dit beschrijft het type bron van het netwerkverzoek.

Enum

"hoofdframe"

"sub_frame"

"stijlpagina"

"script"

"afbeelding"

"lettertype"

"voorwerp"

"xmlhttprequest"

"ping"

"csp_rapport"

"media"

"websocket"

"webtransport"

"webbundel"

"ander"

Rule

Eigenschappen

  • actie

    RegelActie

    De actie die moet worden ondernomen als aan deze regel wordt voldaan.

  • voorwaarde

    RegelVoorwaarde

    De voorwaarde waaronder deze regel van toepassing is.

  • id

    nummer

    Een ID die een regel uniek identificeert. Verplicht en moet >= 1 zijn.

  • prioriteit

    nummer optioneel

    Prioriteit van de regel. Standaardwaarde is 1. Indien gespecificeerd, moet deze waarde >= 1 zijn.

RuleAction

Eigenschappen

  • omleiding

    Doorverwijzing optioneel

    Beschrijft hoe de omleiding moet worden uitgevoerd. Alleen geldig voor omleidingsregels.

  • verzoekHeaders

    ModifyHeaderInfo [] optioneel

    Chrome 86+

    De aanvraagheaders die voor de aanvraag moeten worden gewijzigd. Alleen geldig als RuleActionType "modifyHeaders" is.

  • antwoordHeaders

    ModifyHeaderInfo [] optioneel

    Chrome 86+

    De responseheaders die voor het verzoek moeten worden aangepast. Alleen geldig als RuleActionType "modifyHeaders" is.

  • Het type actie dat moet worden uitgevoerd.

RuleActionType

Beschrijft het soort actie dat moet worden ondernomen als een bepaalde regelvoorwaarde overeenkomt.

Enum

"blok"
Blokkeer het netwerkverzoek.

"doorverwijzen"
Leid het netwerkverzoek om.

"toestaan"
Sta het netwerkverzoek toe. Het verzoek wordt niet onderschept als er een toegangsregel is die ermee overeenkomt.

"upgradeSchema"
Wijzig het schema van de netwerkverzoek-URL naar https als het verzoek http of ftp is.

"modifyHeaders"
Wijzig de request/response-headers van het netwerkverzoek.

"alle verzoeken toestaan"
Sta alle verzoeken binnen een framehiërarchie toe, inclusief het frameverzoek zelf.

RuleCondition

Eigenschappen

  • domeinType

    Domeintype optioneel

    Geeft aan of het netwerkverzoek afkomstig is van de eerste partij (first-party) of van een derde partij (third-party) ten opzichte van het domein waar het vandaan komt. Indien dit veld wordt weggelaten, worden alle verzoeken geaccepteerd.

  • domeinen

    string[] optioneel

    Verouderd sinds Chrome 101

    Gebruik in plaats daarvan initiatorDomains

    De regel komt alleen overeen met netwerkverzoeken afkomstig van de lijst met domains .

  • uitgesloten domeinen

    string[] optioneel

    Verouderd sinds Chrome 101

    Gebruik in plaats daarvan excludedInitiatorDomains

    De regel zal geen netwerkverzoeken matchen die afkomstig zijn van de lijst met excludedDomains .

  • uitgeslotenInitiatorDomains

    string[] optioneel

    Chrome 101+

    De regel zal geen netwerkverzoeken matchen die afkomstig zijn van de lijst met excludedInitiatorDomains . Als de lijst leeg is of ontbreekt, worden er geen domeinen uitgesloten. Dit heeft voorrang op initiatorDomains .

    Opmerkingen:

    • Subdomeinen zoals "a.example.com" zijn ook toegestaan.
    • De invoer mag uitsluitend uit ASCII-tekens bestaan.
    • Gebruik punycode-codering voor geïnternationaliseerde domeinen.
    • Dit wordt vergeleken met de initiatiefnemer van het verzoek en niet met de URL van het verzoek.
    • Subdomeinen van de vermelde domeinen zijn eveneens uitgesloten.
  • uitgesloten aanvraagdomeinen

    string[] optioneel

    Chrome 101+

    De regel zal geen netwerkverzoeken matchen wanneer de domeinen overeenkomen met een van de domeinen in de lijst excludedRequestDomains . Als de lijst leeg is of ontbreekt, worden er geen domeinen uitgesloten. Dit heeft voorrang op requestDomains .

    Opmerkingen:

    • Subdomeinen zoals "a.example.com" zijn ook toegestaan.
    • De invoer mag uitsluitend uit ASCII-tekens bestaan.
    • Gebruik punycode-codering voor geïnternationaliseerde domeinen.
    • Subdomeinen van de vermelde domeinen zijn eveneens uitgesloten.
  • uitgesloten aanvraagmethoden

    RequestMethod [] optioneel

    Chrome 91+

    Lijst met aanvraagmethoden die niet door de regel worden herkend. Slechts één van de twee opties, requestMethods of excludedRequestMethods moet worden opgegeven. Als geen van beide is opgegeven, worden alle aanvraagmethoden herkend.

  • uitgeslotenBrontypen

    ResourceType [] optioneel

    Lijst met resourcetypen die niet door de regel worden herkend. Slechts één van de resourceTypes en excludedResourceTypes mag worden opgegeven. Indien geen van beide is opgegeven, worden alle resourcetypen behalve "main_frame" geblokkeerd.

  • uitgeslotenResponseHeaders

    HeaderInfo [] optioneel

    Chrome 128+

    De regel is niet van toepassing als het verzoek overeenkomt met een van de voorwaarden in de antwoordheaders in deze lijst (indien gespecificeerd). Als zowel excludedResponseHeaders als responseHeaders zijn gespecificeerd, heeft de eigenschap excludedResponseHeaders voorrang.

  • uitgeslotenTabIds

    nummer[] optioneel

    Chrome 92+

    Lijst met tabs.Tab.id die niet door de regel mogen worden herkend. Een ID van tabs.TAB_ID_NONE sluit verzoeken uit die niet afkomstig zijn van een tabblad. Alleen ondersteund voor sessiegebonden regels.

  • uitgeslotenTopDomains

    string[] optioneel

    In behandeling

    De regel zal geen netwerkverzoeken matchen wanneer het domein van het bijbehorende top-level frame overeenkomt met een domein uit de lijst excludedTopDomains . Als de lijst leeg is of ontbreekt, worden er geen domeinen uitgesloten. Deze regel heeft voorrang op topDomains .

    Opmerkingen:

    • Subdomeinen zoals "a.example.com" zijn ook toegestaan.
    • De invoer mag uitsluitend uit ASCII-tekens bestaan.
    • Gebruik punycode-codering voor geïnternationaliseerde domeinen.
    • Subdomeinen van de vermelde domeinen zijn eveneens uitgesloten.
    • Voor verzoeken zonder bijbehorend topniveau-frame (bijvoorbeeld verzoeken geïnitieerd door ServiceWorker), wordt in plaats daarvan het domein van de verzoekinitiator gebruikt.
  • initiatorDomains

    string[] optioneel

    Chrome 101+

    De regel is alleen van toepassing op netwerkverzoeken afkomstig van de lijst met initiatorDomains . Als de lijst ontbreekt, is de regel van toepassing op verzoeken van alle domeinen. Een lege lijst is niet toegestaan.

    Opmerkingen:

    • Subdomeinen zoals "a.example.com" zijn ook toegestaan.
    • De invoer mag uitsluitend uit ASCII-tekens bestaan.
    • Gebruik punycode-codering voor geïnternationaliseerde domeinen.
    • Dit wordt vergeleken met de initiatiefnemer van het verzoek en niet met de URL van het verzoek.
    • Subdomeinen van de vermelde domeinen worden ook vergeleken.
  • isUrlFilterCaseSensitive

    boolean optioneel

    Of de urlFilter of regexFilter (afhankelijk van welke is opgegeven) hoofdlettergevoelig is. De standaardwaarde is false.

  • regexFilter

    string optioneel

    Reguliere expressie om te matchen met de URL van het netwerkverzoek. Deze volgt de RE2-syntaxis .

    Let op: slechts één van de twee, urlFilter of regexFilter kan worden opgegeven.

    Opmerking: Het regexFilter mag alleen uit ASCII-tekens bestaan. Dit wordt vergeleken met een URL waarbij de host is gecodeerd in het punycode-formaat (in het geval van geïnternationaliseerde domeinen) en alle andere niet-ASCII-tekens zijn URL-gecodeerd in UTF-8.

  • verzoekdomeinen

    string[] optioneel

    Chrome 101+

    De regel is alleen van toepassing op netwerkverzoeken wanneer het domein overeenkomt met een van de domeinen in de lijst ` requestDomains . Als de lijst ontbreekt, is de regel van toepassing op verzoeken van alle domeinen. Een lege lijst is niet toegestaan.

    Opmerkingen:

    • Subdomeinen zoals "a.example.com" zijn ook toegestaan.
    • De invoer mag uitsluitend uit ASCII-tekens bestaan.
    • Gebruik punycode-codering voor geïnternationaliseerde domeinen.
    • Subdomeinen van de vermelde domeinen worden ook vergeleken.
  • verzoekmethoden

    RequestMethod [] optioneel

    Chrome 91+

    Lijst met HTTP-verzoekmethoden die aan de regel kunnen voldoen. Een lege lijst is niet toegestaan.

    Opmerking: Het specificeren van een requestMethods -regelvoorwaarde sluit ook niet-HTTP(s)-verzoeken uit, terwijl het specificeren excludedRequestMethods dit niet doet.

  • resourceTypes

    ResourceType [] optioneel

    Lijst met resourcetypen die door de regel kunnen worden gematcht. Een lege lijst is niet toegestaan.

    Let op: dit moet worden gespecificeerd voor allowAllRequests regels en mag alleen de resourcetypen sub_frame en main_frame omvatten.

  • antwoordHeaders

    HeaderInfo [] optioneel

    Chrome 128+

    De regel is van toepassing als het verzoek overeenkomt met een van de voorwaarden in de antwoordheader in deze lijst (indien gespecificeerd).

  • tabIds

    nummer[] optioneel

    Chrome 92+

    Lijst met tabs.Tab.id waarop de regel moet overeenkomen. Een ID van tabs.TAB_ID_NONE komt overeen met verzoeken die niet afkomstig zijn van een tabblad. Een lege lijst is niet toegestaan. Alleen ondersteund voor regels met een sessiebereik.

  • topdomeinen

    string[] optioneel

    In behandeling

    De regel is alleen van toepassing op netwerkverzoeken wanneer het domein van het bijbehorende top-level frame overeenkomt met een domein in de lijst topDomains . Als de lijst ontbreekt, wordt de regel toegepast op verzoeken die zijn gekoppeld aan alle top-level frame-domeinen. Een lege lijst is niet toegestaan.

    Opmerkingen:

    • Subdomeinen zoals "a.example.com" zijn ook toegestaan.
    • De invoer mag uitsluitend uit ASCII-tekens bestaan.
    • Gebruik punycode-codering voor geïnternationaliseerde domeinen.
    • Subdomeinen van de vermelde domeinen worden ook vergeleken.
    • Voor verzoeken zonder bijbehorend topniveau-frame (bijvoorbeeld verzoeken geïnitieerd door ServiceWorker), wordt in plaats daarvan het domein van de verzoekinitiator gebruikt.
  • urlFilter

    string optioneel

    Het patroon dat wordt vergeleken met de URL van het netwerkverzoek. Ondersteunde constructies:

    '*' : Jokerteken: Komt overeen met een willekeurig aantal tekens.

    '|' : Linker/rechter anker: Indien gebruikt aan een van beide uiteinden van het patroon, specificeert het respectievelijk het begin/einde van de URL.

    '||' : Anker voor domeinnaam: Indien gebruikt aan het begin van het patroon, specificeert dit het begin van een (sub)domein van de URL.

    '^' : Scheidingsteken: Dit komt overeen met alles behalve een letter, een cijfer of een van de volgende tekens: _ , - , . , of % . Dit komt ook overeen met het einde van de URL.

    Daarom is urlFilter opgebouwd uit de volgende onderdelen: (optioneel linker-/domeinnaamanker) + patroon + (optioneel rechteranker).

    Indien weggelaten, worden alle URL's vergeleken. Een lege tekenreeks is niet toegestaan.

    Een patroon dat begint met ||* is niet toegestaan. Gebruik in plaats daarvan * .

    Let op: slechts één van de twee, urlFilter of regexFilter kan worden opgegeven.

    Opmerking: De urlFilter mag alleen uit ASCII-tekens bestaan. Deze wordt vergeleken met een URL waarbij de host is gecodeerd in het punycode-formaat (in het geval van geïnternationaliseerde domeinen) en alle andere niet-ASCII-tekens zijn URL-gecodeerd in UTF-8. Als de aanvraag-URL bijvoorbeeld http://abc.рф?q=ф is, wordt de urlFilter vergeleken met de URL http://abc.xn--p1ai/?q=%D1%84.

RuleConditionKeys

In behandeling

Enum

"urlFilter"

"regexFilter"

"isUrlFilterCaseSensitive"

"initiatorDomains"

"uitgeslotenInitiatorDomains"

"verzoekdomeinen"

"uitgesloten aanvraagdomeinen"

"topDomains"

"uitgeslotenTopDomains"

"domeinen"

"uitgesloten domeinen"

"resourceTypes"

"uitgeslotenBrontypen"

"requestMethods"

"excludedRequestMethods"

"domeintype"

"tabIds"

"uitgeslotenTabIds"

"responseHeaders"

"excludedResponseHeaders"

Ruleset

Eigenschappen

  • ingeschakeld

    booleaans

    Of de regelset standaard is ingeschakeld.

  • id

    snaar

    Een niet-lege tekenreeks die de regelset uniek identificeert. ID's die beginnen met '_' zijn gereserveerd voor intern gebruik.

  • pad

    snaar

    Het pad van de JSON-regelset ten opzichte van de extensiemap.

RulesMatchedDetails

Eigenschappen

  • regelsOvereenkomendeInfo

    MatchedRuleInfo []

    Regels die overeenkomen met het opgegeven filter.

TabActionCountUpdate

Chrome 89+

Eigenschappen

  • verhoging

    nummer

    Het bedrag waarmee de actieteller van het tabblad wordt verhoogd. Negatieve waarden verlagen de teller.

  • tabId

    nummer

    Het tabblad waarvoor het aantal acties moet worden bijgewerkt.

TestMatchOutcomeResult

Chrome 103+

Eigenschappen

  • matchedRules

    MatchedRule []

    De regels (indien van toepassing) die overeenkomen met het hypothetische verzoek.

TestMatchRequestDetails

Chrome 103+

Eigenschappen

  • initiatiefnemer

    string optioneel

    De URL van de initiator (indien aanwezig) voor het hypothetische verzoek.

  • methode

    RequestMethod (optioneel)

    De standaard HTTP-methode van het hypothetische verzoek. Standaard is dit "get" voor HTTP-verzoeken en wordt het genegeerd voor niet-HTTP-verzoeken.

  • antwoordHeaders

    object optioneel

    Chrome 129+

    De headers die een hypothetische respons zou bevatten als het verzoek niet wordt geblokkeerd of omgeleid voordat het wordt verzonden. Deze headers worden weergegeven als een object dat een headernaam koppelt aan een lijst met tekenreekswaarden. Indien niet gespecificeerd, zou de hypothetische respons lege responsheaders retourneren, die kunnen overeenkomen met regels die matchen op het ontbreken van headers. Bijvoorbeeld {"content-type": ["text/html; charset=utf-8", "multipart/form-data"]}

  • tabId

    nummer optioneel

    De ID van het tabblad waarin het hypothetische verzoek plaatsvindt. Deze hoeft niet overeen te komen met een echte tabblad-ID. De standaardwaarde is -1, wat betekent dat het verzoek niet aan een tabblad is gekoppeld.

  • topUrl

    string optioneel

    In behandeling

    The associated top-level frame URL (if any) for the request.

  • The resource type of the hypothetical request.

  • URL

    snaar

    The URL of the hypothetical request.

UnsupportedRegexReason

Chrome 87+

Describes the reason why a given regular expression isn't supported.

Enum

"syntaxError"
The regular expression is syntactically incorrect, or uses features not available in the RE2 syntax .

"memoryLimitExceeded"
The regular expression exceeds the memory limit.

UpdateRuleOptions

Chrome 87+

Eigenschappen

  • addRules

    Rule [] optional

    Rules to add.

  • removeRuleIds

    number[] optional

    IDs of the rules to remove. Any invalid IDs will be ignored.

UpdateRulesetOptions

Chrome 87+

Eigenschappen

  • disableRulesetIds

    string[] optional

    The set of ids corresponding to a static Ruleset that should be disabled.

  • enableRulesetIds

    string[] optional

    The set of ids corresponding to a static Ruleset that should be enabled.

UpdateStaticRulesOptions

Chrome 111+

Eigenschappen

  • disableRuleIds

    number[] optional

    Set of ids corresponding to rules in the Ruleset to disable.

  • enableRuleIds

    number[] optional

    Set of ids corresponding to rules in the Ruleset to enable.

  • rulesetId

    snaar

    The id corresponding to a static Ruleset .

URLTransform

Eigenschappen

  • fragment

    string optional

    The new fragment for the request. Should be either empty, in which case the existing fragment is cleared; or should begin with '#'.

  • gastheer

    string optional

    The new host for the request.

  • wachtwoord

    string optional

    The new password for the request.

  • pad

    string optional

    The new path for the request. If empty, the existing path is cleared.

  • haven

    string optional

    The new port for the request. If empty, the existing port is cleared.

  • vraag

    string optional

    The new query for the request. Should be either empty, in which case the existing query is cleared; or should begin with '?'.

  • queryTransform

    QueryTransform optional

    Add, remove or replace query key-value pairs.

  • schema

    string optional

    The new scheme for the request. Allowed values are "http", "https", "ftp" and "chrome-extension".

  • gebruikersnaam

    string optional

    The new username for the request.

Eigenschappen

DYNAMIC_RULESET_ID

Ruleset ID for the dynamic rules added by the extension.

Waarde

"_dynamisch"

GETMATCHEDRULES_QUOTA_INTERVAL

Time interval within which MAX_GETMATCHEDRULES_CALLS_PER_INTERVAL getMatchedRules calls can be made, specified in minutes. Additional calls will fail immediately and set runtime.lastError . Note: getMatchedRules calls associated with a user gesture are exempt from the quota.

Waarde

10

GUARANTEED_MINIMUM_STATIC_RULES

Chrome 89+

The minimum number of static rules guaranteed to an extension across its enabled static rulesets. Any rules above this limit will count towards the global static rule limit .

Waarde

30000

MAX_GETMATCHEDRULES_CALLS_PER_INTERVAL

The number of times getMatchedRules can be called within a period of GETMATCHEDRULES_QUOTA_INTERVAL .

Waarde

20

MAX_NUMBER_OF_DYNAMIC_RULES

The maximum number of dynamic rules that an extension can add.

Waarde

30000

MAX_NUMBER_OF_ENABLED_STATIC_RULESETS

Chrome 94+

The maximum number of static Rulesets an extension can enable at any one time.

Waarde

50

MAX_NUMBER_OF_REGEX_RULES

The maximum number of regular expression rules that an extension can add. This limit is evaluated separately for the set of dynamic rules and those specified in the rule resources file.

Waarde

1000

MAX_NUMBER_OF_SESSION_RULES

Chrome 120+

The maximum number of session scoped rules that an extension can add.

Waarde

5000

MAX_NUMBER_OF_STATIC_RULESETS

The maximum number of static Rulesets an extension can specify as part of the "rule_resources" manifest key.

Waarde

100

MAX_NUMBER_OF_UNSAFE_DYNAMIC_RULES

Chrome 120+

The maximum number of "unsafe" dynamic rules that an extension can add.

Waarde

5000

MAX_NUMBER_OF_UNSAFE_SESSION_RULES

Chrome 120+

The maximum number of "unsafe" session scoped rules that an extension can add.

Waarde

5000

SESSION_RULESET_ID

Chrome 90+

Ruleset ID for the session-scoped rules added by the extension.

Waarde

"_sessie"

Methoden

getAvailableStaticRuleCount()

PromiseChrome 89+
chrome.declarativeNetRequest.getAvailableStaticRuleCount(
  callback?: function,
): Promise<number>

Returns the number of static rules an extension can enable before the global static rule limit is reached.

Parameters

  • terugbelverzoek

    function optional

    The callback parameter looks like: 

    (count: number) => void

    • graaf

      nummer

Retourneert

  • Promise<number>

    Chrome 91+

    Promises are only supported for Manifest V3 and later, other platforms need to use callbacks.

getDisabledRuleIds()

PromiseChrome 111+
chrome.declarativeNetRequest.getDisabledRuleIds(
  options: GetDisabledRuleIdsOptions,
  callback?: function,
): Promise<number[]>

Returns the list of static rules in the given Ruleset that are currently disabled.

Parameters

  • Specifies the ruleset to query.

  • terugbelverzoek

    function optional

    The callback parameter looks like: 

    (disabledRuleIds: number[]) => void

    • disabledRuleIds

      nummer[]

Retourneert

  • Promise<number[]>

    Promises are only supported for Manifest V3 and later, other platforms need to use callbacks.

getDynamicRules()

Belofte
chrome.declarativeNetRequest.getDynamicRules(
  filter?: GetRulesFilter,
  callback?: function,
): Promise<Rule[]>

Returns the current set of dynamic rules for the extension. Callers can optionally filter the list of fetched rules by specifying a filter .

Parameters

  • filter

    GetRulesFilter optional

    Chrome 111+

    An object to filter the list of fetched rules.

  • terugbelverzoek

    function optional

    The callback parameter looks like: 

    (rules: Rule[]) => void

Retourneert

  • Promise< Rule []>

    Chrome 91+

    Promises are only supported for Manifest V3 and later, other platforms need to use callbacks.

getEnabledRulesets()

Belofte
chrome.declarativeNetRequest.getEnabledRulesets(
  callback?: function,
): Promise<string[]>

Returns the ids for the current set of enabled static rulesets.

Parameters

  • terugbelverzoek

    function optional

    The callback parameter looks like: 

    (rulesetIds: string[]) => void

    • rulesetIds

      snaar[]

Retourneert

  • Promise<string[]>

    Chrome 91+

    Promises are only supported for Manifest V3 and later, other platforms need to use callbacks.

getMatchedRules()

Belofte
chrome.declarativeNetRequest.getMatchedRules(
  filter?: MatchedRulesFilter,
  callback?: function,
): Promise<RulesMatchedDetails>

Returns all rules matched for the extension. Callers can optionally filter the list of matched rules by specifying a filter . This method is only available to extensions with the "declarativeNetRequestFeedback" permission or having the "activeTab" permission granted for the tabId specified in filter . Note: Rules not associated with an active document that were matched more than five minutes ago will not be returned.

Parameters

Retourneert

  • Chrome 91+

    Promises are only supported for Manifest V3 and later, other platforms need to use callbacks.

getSessionRules()

PromiseChrome 90+
chrome.declarativeNetRequest.getSessionRules(
  filter?: GetRulesFilter,
  callback?: function,
): Promise<Rule[]>

Returns the current set of session scoped rules for the extension. Callers can optionally filter the list of fetched rules by specifying a filter .

Parameters

  • filter

    GetRulesFilter optional

    Chrome 111+

    An object to filter the list of fetched rules.

  • terugbelverzoek

    function optional

    The callback parameter looks like: 

    (rules: Rule[]) => void

Retourneert

  • Promise< Rule []>

    Chrome 91+

    Promises are only supported for Manifest V3 and later, other platforms need to use callbacks.

isRegexSupported()

PromiseChrome 87+
chrome.declarativeNetRequest.isRegexSupported(
  regexOptions: RegexOptions,
  callback?: function,
): Promise<IsRegexSupportedResult>

Checks if the given regular expression will be supported as a regexFilter rule condition.

Parameters

Retourneert

  • Chrome 91+

    Promises are only supported for Manifest V3 and later, other platforms need to use callbacks.

setExtensionActionOptions()

PromiseChrome 88+
chrome.declarativeNetRequest.setExtensionActionOptions(
  options: ExtensionActionOptions,
  callback?: function,
): Promise<void>

Configures if the action count for tabs should be displayed as the extension action's badge text and provides a way for that action count to be incremented.

Parameters

  • terugbelverzoek

    function optional

    Chrome 89+

    The callback parameter looks like: 

    () => void

Retourneert

  • Promise<void>

    Chrome 91+

    Promises are only supported for Manifest V3 and later, other platforms need to use callbacks.

testMatchOutcome()

PromiseChrome 103+
chrome.declarativeNetRequest.testMatchOutcome(
  request: TestMatchRequestDetails,
  callback?: function,
): Promise<TestMatchOutcomeResult>

Checks if any of the extension's declarativeNetRequest rules would match a hypothetical request. Note: Only available for unpacked extensions as this is only intended to be used during extension development.

Parameters

Retourneert

  • Promises are only supported for Manifest V3 and later, other platforms need to use callbacks.

updateDynamicRules()

Belofte
chrome.declarativeNetRequest.updateDynamicRules(
  options: UpdateRuleOptions,
  callback?: function,
): Promise<void>

Modifies the current set of dynamic rules for the extension. The rules with IDs listed in options.removeRuleIds are first removed, and then the rules given in options.addRules are added. Notes:

  • This update happens as a single atomic operation: either all specified rules are added and removed, or an error is returned.
  • These rules are persisted across browser sessions and across extension updates.
  • Static rules specified as part of the extension package can not be removed using this function.
  • MAX_NUMBER_OF_DYNAMIC_RULES is the maximum number of dynamic rules an extension can add. The number of unsafe rules must not exceed MAX_NUMBER_OF_UNSAFE_DYNAMIC_RULES .

Parameters

  • Chrome 87+
  • terugbelverzoek

    function optional

    The callback parameter looks like: 

    () => void

Retourneert

  • Promise<void>

    Chrome 91+

    Promises are only supported for Manifest V3 and later, other platforms need to use callbacks.

updateEnabledRulesets()

Belofte
chrome.declarativeNetRequest.updateEnabledRulesets(
  options: UpdateRulesetOptions,
  callback?: function,
): Promise<void>

Updates the set of enabled static rulesets for the extension. The rulesets with IDs listed in options.disableRulesetIds are first removed, and then the rulesets listed in options.enableRulesetIds are added. Note that the set of enabled static rulesets is persisted across sessions but not across extension updates, ie the rule_resources manifest key will determine the set of enabled static rulesets on each extension update.

Parameters

  • Chrome 87+
  • terugbelverzoek

    function optional

    The callback parameter looks like: 

    () => void

Retourneert

  • Promise<void>

    Chrome 91+

    Promises are only supported for Manifest V3 and later, other platforms need to use callbacks.

updateSessionRules()

PromiseChrome 90+
chrome.declarativeNetRequest.updateSessionRules(
  options: UpdateRuleOptions,
  callback?: function,
): Promise<void>

Modifies the current set of session scoped rules for the extension. The rules with IDs listed in options.removeRuleIds are first removed, and then the rules given in options.addRules are added. Notes:

  • This update happens as a single atomic operation: either all specified rules are added and removed, or an error is returned.
  • These rules are not persisted across sessions and are backed in memory.
  • MAX_NUMBER_OF_SESSION_RULES is the maximum number of session rules an extension can add.

Parameters

  • terugbelverzoek

    function optional

    The callback parameter looks like: 

    () => void

Retourneert

  • Promise<void>

    Chrome 91+

    Promises are only supported for Manifest V3 and later, other platforms need to use callbacks.

updateStaticRules()

PromiseChrome 111+
chrome.declarativeNetRequest.updateStaticRules(
  options: UpdateStaticRulesOptions,
  callback?: function,
): Promise<void>

Disables and enables individual static rules in a Ruleset . Changes to rules belonging to a disabled Ruleset will take effect the next time that it becomes enabled.

Parameters

Retourneert

  • Promise<void>

    Promises are only supported for Manifest V3 and later, other platforms need to use callbacks.

Evenementen

onRuleMatchedDebug

chrome.declarativeNetRequest.onRuleMatchedDebug.addListener(
  callback: function,
)

Fired when a rule is matched with a request. Only available for unpacked extensions with the "declarativeNetRequestFeedback" permission as this is intended to be used for debugging purposes only.

Parameters