chrome.declarativeContent

Beschrijving

Rechten

Concepten en gebruik

Met de Declarative Content API kunt u de actie van uw extensie inschakelen, afhankelijk van de URL van een webpagina, of als een CSS-selector overeenkomt met een element op de pagina, zonder dat u hostrechten hoeft toe te voegen of een inhoudsscript hoeft te injecteren.

Gebruik de activeTab- machtiging om met een pagina te communiceren nadat de gebruiker op de actie van de extensie heeft geklikt.

Reglement

Regels bestaan ​​uit voorwaarden en acties. Als aan één van de voorwaarden is voldaan, worden alle acties uitgevoerd. De acties zijn setIcon() en showAction() .

De PageStateMatcher matcht webpagina's als en alleen als aan alle vermelde criteria wordt voldaan. Het kan overeenkomen met een pagina-URL , een samengestelde CSS-selector of de bladwijzerstatus van een pagina. De volgende regel schakelt de actie van de extensie op Google-pagina's in als er een wachtwoordveld aanwezig is:

let rule1 = {
  conditions: [
    new chrome.declarativeContent.PageStateMatcher({
      pageUrl: { hostSuffix: '.google.com', schemes: ['https'] },
      css: ["input[type='password']"]
    })
  ],
  actions: [ new chrome.declarativeContent.ShowAction() ]
};

Om de actie van de extensie ook in te schakelen voor Google-sites met een video, kunt u een tweede voorwaarde toevoegen, aangezien elke voorwaarde voldoende is om alle opgegeven acties te activeren:

let rule2 = {
  conditions: [
    new chrome.declarativeContent.PageStateMatcher({
      pageUrl: { hostSuffix: '.google.com', schemes: ['https'] },
      css: ["input[type='password']"]
    }),
    new chrome.declarativeContent.PageStateMatcher({
      css: ["video"]
    })
  ],
  actions: [ new chrome.declarativeContent.ShowAction() ]
};

De onPageChanged gebeurtenis test of een regel aan ten minste één voorwaarde voldoet en voert de acties uit. Regels blijven bestaan ​​tijdens browsersessies; daarom moet u tijdens de installatie van de extensie eerst removeRules gebruiken om eerder geïnstalleerde regels te wissen en vervolgens addRules gebruiken om nieuwe regels te registreren.

chrome.runtime.onInstalled.addListener(function(details) {
  chrome.declarativeContent.onPageChanged.removeRules(undefined, function() {
    chrome.declarativeContent.onPageChanged.addRules([rule2]);
  });
});

Met de activeTab- machtiging geeft uw extensie geen toestemmingswaarschuwingen weer en wanneer de gebruiker op de extensieactie klikt, wordt deze alleen op relevante pagina's uitgevoerd.

Overeenkomstige pagina-URL

De PageStateMatcher.pageurl komt overeen wanneer aan de URL-criteria is voldaan. De meest voorkomende criteria zijn een aaneenschakeling van host, pad of URL, gevolgd door Bevat, Is gelijk aan, Voorvoegsel of Achtervoegsel. De volgende tabel bevat enkele voorbeelden:

Alle criteria zijn hoofdlettergevoelig. Zie UrlFilter voor een volledige lijst met criteria.

CSS-matching

PageStateMatcher.css voorwaarden moeten samengestelde selectors zijn, wat betekent dat u geen combinators zoals witruimte of " > " in uw selectors kunt opnemen. Hierdoor kan Chrome de selectors efficiënter matchen.

CSS-voorwaarden komen alleen overeen met weergegeven elementen: als een element dat overeenkomt met uw selector display:none is of een van de bovenliggende elementen display:none is, zorgt dit er niet voor dat de voorwaarde overeenkomt. Elementen die met visibility:hidden zijn opgemaakt, buiten het scherm zijn geplaatst of door andere elementen zijn verborgen, kunnen er nog steeds voor zorgen dat uw voorwaarde overeenkomt.

Staatsmatching met bladwijzer

Met de voorwaarde PageStateMatcher.isBookmarked kan de bladwijzerstatus van de huidige URL in het gebruikersprofiel worden vergeleken. Om van deze voorwaarde gebruik te kunnen maken, moet de toestemming "bladwijzers" worden aangegeven in het extensiemanifest .