chrome.declarativeContent

Descrizione

Autorizzazioni

Concetti e utilizzo

L'API Declarative Content ti consente di attivare l'azione dell'estensione in base all'URL di una pagina web o se un selettore CSS corrisponde a un elemento della pagina, senza dover aggiungere autorizzazioni host o iniettare uno script di contenuti.

Utilizza l'autorizzazione activeTab per interagire con una pagina dopo che l'utente fa clic sull'azione dell'estensione.

Regole

Le regole sono costituite da condizioni e azioni. Se una delle condizioni è soddisfatta, tutte le azioni vengono eseguite. Le azioni sono setIcon() e showAction().

PageStateMatcher corrisponde alle pagine web se e solo se sono soddisfatti tutti i criteri elencati. Può corrispondere a un URL pagina, a un selettore composto CSS o allo stato Segnalibro di una pagina. La seguente regola attiva l'azione dell'estensione sulle pagine di Google quando è presente un campo della password:

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

Per attivare l'azione dell'estensione anche per i siti Google con un video, puoi aggiungere una seconda condizione, poiché ciascuna condizione è sufficiente per attivare tutte le azioni specificate:

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() ]
};

L'evento onPageChanged verifica se una regola ha almeno una condizione soddisfatta ed esegue le azioni. Le regole rimangono invariate nelle sessioni di navigazione. Pertanto, durante l'installazione dell'estensione, devi prima utilizzare removeRules per cancellare le regole installate in precedenza e poi addRules per registrarne di nuove.

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

Con l'autorizzazione activeTab, l'estensione non mostrerà alcun avviso di autorizzazione e, quando l'utente fa clic sull'azione dell'estensione, questa verrà eseguita solo nelle pagine pertinenti.

Corrispondenza dell'URL pagina

PageStateMatcher.pageurl corrisponde quando i criteri dell'URL sono soddisfatti. I criteri più comuni sono una concatenazione di host, percorso o URL, seguita da Contiene, È uguale a, Prefisso o Suffisso. La seguente tabella contiene alcuni esempi:

Criteri	Corrisponde a
{ hostSuffix: 'google.com' }	Tutti gli URL di Google
{ pathPrefix: '/docs/extensions' }	URL della documentazione delle estensioni
{ urlContains: 'developer.chrome.com' }	Tutti gli URL dei documenti per gli sviluppatori di Chrome

Tutti i criteri sono sensibili alle maiuscole. Per un elenco completo dei criteri, consulta UrlFilter.

Corrispondenza CSS

Le condizioni PageStateMatcher.css devono essere selettori composti, il che significa che non puoi includere combinatori come spazi o ">" nei selettori. In questo modo, Chrome abbina i selettori in modo più efficiente.

Selettori composti (OK)	Selettori complessi (non OK)
a	div p
iframe.special[src^='http']	p>span.highlight
ns|*	p + ol
#abcd:checked	p::first-line

Le condizioni CSS corrispondono solo agli elementi visualizzati: se un elemento che corrisponde al selettore è display:none o uno dei suoi elementi principali è display:none, la condizione non corrisponde. Gli elementi stilizzati con visibility:hidden, posizionati fuori dallo schermo o nascosti da altri elementi possono comunque soddisfare la condizione.

Corrispondenza dello stato dei preferiti

La condizione PageStateMatcher.isBookmarked consente di associare lo stato di salvataggio come preferito dell'URL corrente nel profilo dell'utente. Per utilizzare questa condizione, l'autorizzazione "Preferiti" deve essere dichiarata nel manifest dell'estensione.