chrome.declarativeContent

Vernieuwingsdatum: 2026-09-25 robots: noindex

Beschrijving

Toestemmingen

Gebruik

Met de Declarative Content API kunt u de werking van uw extensie inschakelen op basis 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 contentscript hoeft te injecteren.

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

Regels

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

De PageStateMatcher komt alleen overeen met webpagina's als aan alle vermelde criteria wordt voldaan. Het kan overeenkomen met een pagina-URL , een CSS-selector of de status van een pagina als bladwijzer . De volgende regel activeert de werking van de extensie op Google-pagina's wanneer 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 extensie ook te laten werken op Google Sites met een video, kunt u een tweede voorwaarde toevoegen. Elke voorwaarde is namelijk voldoende 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 controleert of een regel ten minste één vervulde voorwaarde heeft en voert de bijbehorende acties uit. Regels blijven behouden tussen browsersessies; daarom moet u tijdens de installatie van een extensie eerst removeRules gebruiken om eerder geïnstalleerde regels te verwijderen 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 zal uw extensie geen waarschuwingen over machtigingen weergeven en zal de extensie, wanneer de gebruiker erop klikt, alleen op relevante pagina's worden uitgevoerd.

Pagina-URL-overeenkomst

De PageStateMatcher.pageurl komt overeen wanneer aan de URL-criteria wordt voldaan. De meest voorkomende criteria zijn een samenvoeging van host, pad of url, gevolgd door Contains, Equals, Prefix of Suffix. De volgende tabel bevat enkele voorbeelden:

Alle criteria zijn hoofdlettergevoelig. Voor een volledige lijst met criteria, zie UrlFilter .

CSS-matching

De voorwaarden PageStateMatcher.css moeten samengestelde selectors zijn, wat betekent dat je geen combinaties zoals spaties of " > " in je selectors mag opnemen. Dit helpt Chrome om de selectors efficiënter te matchen.

CSS-voorwaarden komen alleen overeen met weergegeven elementen: als een element dat overeenkomt met je selector display:none , of als een van de bovenliggende elementen display:none heeft, zorgt dit er niet voor dat de voorwaarde wordt voldaan. Elementen met visibility:hidden , elementen die buiten beeld zijn gepositioneerd of elementen die door andere elementen worden verborgen, kunnen er nog steeds voor zorgen dat je voorwaarde wordt voldaan.

Opgeslagen staatsovereenkomst

De voorwaarde PageStateMatcher.isBookmarked maakt het mogelijk om de status van de huidige URL als bladwijzer in het gebruikersprofiel te controleren. Om van deze voorwaarde gebruik te kunnen maken, moet de "bookmarks"-toestemming in het extensiemanifest worden gedeclareerd.