chrome.declarativeContent

Açıklama

İzinler

Kavramlar ve kullanım

Declarative Content API, bir web sayfasının URL'sine bağlı olarak veya bir CSS seçici sayfadaki bir öğeyle eşleştiğinde ana makine izinleri ya da içerik komut dosyası eklemeye gerek kalmadan uzantınızın işlemini etkinleştirmenize olanak tanır.

Kullanıcı, uzantının işlemini tıkladıktan sonra sayfayla etkileşimde bulunmak için activeTab iznini kullanın.

Kurallar

Kurallar koşullar ve işlemlerden oluşur. Koşullardan biri yerine getirilirse tüm işlemler yürütülür. İşlemler: setIcon() ve showAction().

PageStateMatcher, yalnızca listelenen tüm ölçütler karşılanırsa web sayfalarıyla eşleşir. Bir sayfa URL'si, css bileşik seçici veya sayfanın yer işareti eklenmiş durumu ile eşleşebilir. Aşağıdaki kural, bir şifre alanı olduğunda uzantının Google sayfalarında işlem yapmasını etkinleştirir:

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

Uzantının video içeren Google sitelerinde de işlemi etkinleştirmek için ikinci bir koşul ekleyebilirsiniz. Her koşul, belirtilen tüm işlemleri tetiklemek için yeterlidir:

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 etkinliği, herhangi bir kuralın en az bir yerine getirilmiş koşulu olup olmadığını test eder ve işlemleri yürütür. Kurallar, göz atma oturumları genelinde geçerliliğini korur. Bu nedenle, uzantı yükleme süresi boyunca önceden yüklenmiş kuralları temizlemek için önce removeRules, ardından yenilerini kaydetmek için addRules kullanmanız gerekir.

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

activeTab izniyle uzantınız herhangi bir izin uyarısı görüntülemez ve kullanıcı uzantı işlemini tıkladığında yalnızca alakalı sayfalarda çalışır.

Sayfa URL'si eşleşmesi

URL ölçütleri karşılandığında PageStateMatcher.pageurl eşleşir. En yaygın ölçütler, ana makine, yol veya URL'nin birleştirilmesi ve ardından İçerir, Eşittir, Önek veya Sonek seçeneklerinin eklenmesidir. Aşağıdaki tabloda birkaç örnek verilmiştir:

Ölçütler	Şununla eşleşiyor:
{ hostSuffix: 'google.com' }	Tüm Google URL'leri
{ pathPrefix: '/docs/extensions' }	Uzantı dokümanları URL'leri
{ urlContains: 'developer.chrome.com' }	Tüm Chrome geliştiricileri dokümanlarının URL'leri

Tüm ölçütler büyük/küçük harfe duyarlıdır. Ölçütlerin tam listesi için UrlFilter konusuna bakın.

CSS Eşleştirme

PageStateMatcher.css koşullarının bileşik seçici olması gerekir. Yani seçicilerinize boşluk veya ">" gibi birleştiriciler ekleyemezsiniz. Bu, Chrome'un seçicileri daha verimli bir şekilde eşleştirmesine yardımcı olur.

Bileşik Seçiciler (Tamam)	Karmaşık Seçiciler (Uygun Değil)
a	div p
iframe.special[src^='http']	p>span.highlight
ns|*	p + ol
#abcd:checked	p::first-line

CSS koşulları yalnızca görüntülenen öğelerle eşleşir: Seçicinizle eşleşen bir öğe display:none veya üst öğelerinden biri display:none ise koşulun eşleşmesine neden olmaz. Stili visibility:hidden ile belirlenmiş, ekran dışında konumlandırılmış veya başka öğeler tarafından gizlenmiş öğeler, koşulunuzu yine de eşleştirebilir.

Yer işareti koyma durumu eşleşmesi

PageStateMatcher.isBookmarked koşulu, kullanıcının profilindeki mevcut URL'nin yer işareti koyulma durumunun eşleştirilmesini sağlar. Bu koşuldan yararlanmak için "yer işaretleri" izninin uzantı manifest öğesinde beyan edilmesi gerekir.