chrome.declarativeContent

дата обновления: 2026-09-25 robots: noindex

Описание

Разрешения

Использование

Декларативный API контента позволяет включать действие вашего расширения в зависимости от URL-адреса веб-страницы или от того, соответствует ли CSS-селектор элементу на странице, без необходимости добавления разрешений хоста или внедрения скрипта контента .

Используйте разрешение activeTab для взаимодействия со страницей после того, как пользователь нажмет на действие расширения.

Правила

Правила состоят из условий и действий. Если выполняется хотя бы одно из условий, выполняются все действия. Действиями являются setIcon и showAction .

PageStateMatcher соответствует веб-страницам только в том случае, если выполняются все перечисленные критерии. Он может соответствовать URL-адресу страницы , составному CSS-селектору или состоянию закладки страницы. Следующее правило включает действие расширения на страницах Google, если присутствует поле для ввода пароля:

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

Чтобы также включить действие расширения для сайтов Google с видео, можно добавить второе условие, поскольку каждого условия достаточно для запуска всех указанных действий:

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

Событие onPageChanged проверяет, выполняется ли хотя бы одно условие для какого-либо правила, и выполняет соответствующие действия. Правила сохраняются между сеансами просмотра; поэтому во время установки расширения сначала следует использовать removeRules для удаления ранее установленных правил, а затем addRules для регистрации новых.

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

При наличии разрешения activeTab ваше расширение не будет отображать никаких предупреждений о разрешениях, и когда пользователь нажимает на действие расширения, оно будет запускаться только на соответствующих страницах.

Сопоставление URL-адресов страниц

Объект PageStateMatcher.pageurl срабатывает, когда выполняются критерии URL. Наиболее распространенные критерии — это конкатенация хоста, пути или URL, за которой следуют Contains, Equals, Prefix или Suffix. В следующей таблице приведены несколько примеров:

Все критерии чувствительны к регистру. Полный список критериев см. в разделе UrlFilter .

Сопоставление CSS

Условия в PageStateMatcher.css должны быть составными селекторами , то есть вы не можете включать в селекторы такие комбинаторы, как пробелы или " > ". Это помогает Chrome более эффективно сопоставлять селекторы.

Условия CSS применяются только к отображаемым элементам: если элемент, соответствующий вашему селектору, имеет display:none или один из его родительских элементов имеет display:none , это не приведет к выполнению условия. Элементы, стилизованные с помощью visibility:hidden , расположенные за пределами экрана или скрытые другими элементами, все еще могут привести к выполнению условия.

Сопоставление штатов с закладками

Условие PageStateMatcher.isBookmarked позволяет сопоставлять состояние закладок текущего URL-адреса в профиле пользователя. Для использования этого условия необходимо указать разрешение "закладки" в манифесте расширения.