chrome.declarativeContent

Interfejs Declarative Content API umożliwia włączenie działania rozszerzenia w zależności od adresu URL strony internetowej lub gdy selektor CSS pasuje do elementu na stronie, bez konieczności dodawania uprawnień hosta ani wstrzykiwania skryptu treści.

Użyj uprawnienia activeTab, aby wchodzić w interakcję ze stroną po kliknięciu przez użytkownika działania rozszerzenia.

Reguły

Reguły składają się z warunków i działań. Jeśli którykolwiek z warunków zostanie spełniony, wszystkie działania zostaną wykonane. Działania to setIcon() i showAction().

PageStateMatcher pasuje do stron internetowych tylko wtedy, gdy są spełnione wszystkie wymienione kryteria. Może ona pasować do adresu URL strony, elementu złożonego CSS lub stanu strony z zakładką. Poniższa reguła umożliwia działanie rozszerzenia na stronach Google, gdy jest obecne pole hasła:

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

Aby umożliwić działanie rozszerzenia w przypadku witryn Google z filmem, możesz dodać drugi warunek, ponieważ każdy warunek wystarczy do wywołania wszystkich określonych działań:

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

Zdarzenie onPageChanged sprawdza, czy którakolwiek reguła ma co najmniej 1 spełniony warunek, i wykonuje działania. Reguły są zachowywane w trakcie sesji przeglądania, dlatego podczas instalacji rozszerzenia najpierw użyj removeRules, aby wyczyścić wcześniej zainstalowane reguły, a potem użyj addRules, aby zarejestrować nowe.

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

Dzięki uprawnieniu activeTab rozszerzenie nie będzie wyświetlać żadnych ostrzeżeń dotyczących uprawnień, a gdy użytkownik kliknie działanie rozszerzenia, będzie ono działać tylko na odpowiednich stronach.

Dopasowywanie adresów URL stron

PageStateMatcher.pageurl pasuje, gdy są spełnione kryteria adresu URL. Najczęstsze kryteria to konkatenacja hosta, ścieżki lub adresu URL, po której następuje zawiera, równa się, prefiks lub sufiks. W tabeli poniżej znajdziesz kilka przykładów:

W przypadku wszystkich kryteriów wielkość liter ma znaczenie. Pełną listę wymagań znajdziesz w sekcji UrlFilter.

Dopasowywanie w usłudze porównywania cen

Warunki PageStateMatcher.css muszą być elementami złożonymi, co oznacza, że w elementach selektora nie można uwzględniać elementów łączących, takich jak odstępy czy „>”. Pomaga to Chrome w skuteczniejszym dopasowywaniu selektorów.

Warunki CSS pasują tylko do wyświetlanych elementów: jeśli element pasujący do Twojego selektora ma wartość display:none lub jeden z jego elementów nadrzędnych ma wartość display:none, warunek nie będzie pasować. Elementy stylizowane za pomocą visibility:hidden, umieszczone poza ekranem lub ukryte przez inne elementy mogą nadal pasować do warunku.

Dopasowywanie stanu dodanego do zakładek

Warunek PageStateMatcher.isBookmarked umożliwia dopasowanie stanu bieżącego adresu URL w profilu użytkownika do stanu zakładki. Aby można było korzystać z tego warunku, w manifest rozszerzenia musi być zadeklarowane uprawnienie „zakładki”.