chrome.events

refresh date: 2026-09-25 robots: noindex

Açıklama

Event, ilginç bir şey olduğunda bildirim almanızı sağlayan bir nesnedir. Bir alarmın süresi dolduğunda bildirim almak için chrome.alarms.onAlarm etkinliğini kullanma örneği:

chrome.alarms.onAlarm.addListener(function(alarm) {
  appendToLog('alarms.onAlarm --'
              + ' name: '          + alarm.name
              + ' scheduledTime: ' + alarm.scheduledTime);
});

Örnekte gösterildiği gibi, addListener() kullanarak bildirim için kaydolursunuz. addListener() bağımsız değişkeni her zaman etkinliği işlemek için tanımladığınız bir işlevdir ancak işlevin parametreleri, işlediğiniz etkinliğe bağlıdır. alarms.onAlarm ile ilgili belgelere baktığınızda işlevin tek bir parametresi olduğunu görebilirsiniz: Süresi dolan alarm hakkında ayrıntıları içeren bir alarms.Alarm nesnesi.

Etkinlikleri kullanan API'lere örnekler: alarms, i18n, identity, runtime. Çoğu chrome API'si bu şekilde çalışır.

Bildirime Dayalı Etkinlik İşleyiciler

Bildirim temelli etkinlik işleyiciler, bildirim temelli koşullar ve işlemlerden oluşan kurallar tanımlamanın bir yolunu sunar. Koşullar, JavaScript motoru yerine tarayıcıda değerlendirilir. Bu sayede gidiş dönüş gecikmeleri azalır ve çok yüksek verimlilik elde edilir.

Bildirimsel etkinlik işleyiciler, örneğin Bildirimsel Web İsteği API'si ve Declarative Content API'nde kullanılır. Bu sayfada, tüm bildirim temelli etkinlik işleyicilerin temel kavramları açıklanmaktadır.

Kurallar

En basit kural, bir veya daha fazla koşul ve bir veya daha fazla işlemden oluşur:

var rule = {
  conditions: [ /* my conditions */ ],
  actions: [ /* my actions */ ]
};

Koşullardan herhangi biri karşılanırsa tüm işlemler yürütülür.

Koşullar ve işlemlerin yanı sıra her kurala bir tanımlayıcı verebilirsiniz. Bu sayede, önceden kaydedilmiş kuralların kaydını iptal etmek kolaylaşır. Ayrıca kurallar arasında öncelikleri tanımlamak için bir öncelik de belirleyebilirsiniz. Öncelikler yalnızca kurallar birbiriyle çelişiyorsa veya belirli bir sırada yürütülmesi gerekiyorsa dikkate alınır. İşlemler, kurallarının önceliğine göre azalan sırada yürütülür.

var rule = {
  id: "my rule",  // optional, will be generated if not set.
  priority: 100,  // optional, defaults to 100.
  conditions: [ /* my conditions */ ],
  actions: [ /* my actions */ ]
};

Etkinlik nesneleri

Etkinlik nesneleri kuralları destekleyebilir. Bu etkinlik nesneleri, etkinlikler gerçekleştiğinde bir geri çağırma işlevi çağırmaz ancak kayıtlı herhangi bir kuralın en az bir karşılanan koşulu olup olmadığını test eder ve bu kuralla ilişkili işlemleri yürütür. Bildirim temelli API'yi destekleyen etkinlik nesnelerinin üç alakalı yöntemi vardır: events.Event.addRules, events.Event.removeRules ve events.Event.getRules.

Reklam kuralları ekleme

Reklam kuralları eklemek için etkinlik nesnesinin addRules() işlevini çağırın. İlk parametre olarak bir kural örnekleri dizisi ve tamamlandığında çağrılan bir geri çağırma işlevi alır.

var rule_list = [rule1, rule2, ...];
function addRules(rule_list, function callback(details) {...});

Kurallar başarıyla eklendiyse details parametresi, iletilen rule_list ile aynı sırada görünen eklenmiş kurallardan oluşan bir dizi içerir. Bu dizide, isteğe bağlı id ve priority parametreleri oluşturulan değerlerle doldurulur. Geçersiz bir koşul veya işlem içerdiği için geçersiz olan bir kural varsa kuralların hiçbiri eklenmez ve geri çağırma işlevi çağrıldığında runtime.lastError değişkeni ayarlanır. rule_list içindeki her kural, şu anda başka bir kural tarafından kullanılmayan benzersiz bir tanımlayıcı veya boş bir tanımlayıcı içermelidir.

Kuralları kaldırma

Kuralları kaldırmak için removeRules() işlevini çağırın. İlk parametre olarak isteğe bağlı bir kural tanımlayıcı dizisi ve ikinci parametre olarak bir geri çağırma işlevi kabul eder.

var rule_ids = ["id1", "id2", ...];
function removeRules(rule_ids, function callback() {...});

rule_ids, bir tanımlayıcı dizisiyse dizide listelenen tanımlayıcıları içeren tüm kurallar kaldırılır. rule_ids bilinmeyen bir tanımlayıcı listelerse bu tanımlayıcı sessizce yoksayılır. rule_ids, undefined ise bu uzantının kayıtlı tüm kuralları kaldırılır. Kurallar kaldırıldığında callback() işlevi çağrılır.

Kurallar alınıyor

Kayıtlı kuralların listesini almak için getRules() işlevini çağırın. removeRules ile aynı semantiğe sahip isteğe bağlı bir kural tanımlayıcı dizisi ve bir geri çağırma işlevi kabul eder.

var rule_ids = ["id1", "id2", ...];
function getRules(rule_ids, function callback(details) {...});

callback() işlevine iletilen details parametresi, doldurulmuş isteğe bağlı parametreler de dahil olmak üzere bir kural dizisini ifade eder.

Performans

Maksimum performans elde etmek için aşağıdaki yönergeleri göz önünde bulundurmanız gerekir.

Kuralları toplu olarak kaydetme ve kaydını iptal etme Her kayıttan veya kayıt iptalinden sonra Chrome'un dahili veri yapılarını güncellemesi gerekir. Bu güncelleme, yüksek miktarda kaynak tüketen bir işlemdir.

Şunu kullanmayın:

var rule1 = {...};
var rule2 = {...};
chrome.declarativeWebRequest.onRequest.addRules([rule1]);
chrome.declarativeWebRequest.onRequest.addRules([rule2]);

tercih:

var rule1 = {...};
var rule2 = {...};
chrome.declarativeWebRequest.onRequest.addRules([rule1, rule2]);

events.UrlFilter'da normal ifadeler yerine alt dize eşleştirmeyi tercih edin. Alt dizeye dayalı eşleştirme son derece hızlıdır.

Şunu kullanmayın:

var match = new chrome.declarativeWebRequest.RequestMatcher({
    url: {urlMatches: "example.com/[^?]*foo" } });

tercih:

var match = new chrome.declarativeWebRequest.RequestMatcher({
    url: {hostSuffix: "example.com", pathContains: "foo"} });

Aynı işlemleri paylaşan çok sayıda kural varsa kuralları tek bir kuralda birleştirin. Kurallar, tek bir koşul karşılanır karşılanmaz işlemlerini tetikler. Bu, eşleşmeyi hızlandırır ve yinelenen işlem grupları için bellek tüketimini azaltır.

Şunu kullanmayın:

var condition1 = new chrome.declarativeWebRequest.RequestMatcher({
    url: { hostSuffix: 'example.com' } });
var condition2 = new chrome.declarativeWebRequest.RequestMatcher({
    url: { hostSuffix: 'foobar.com' } });
var rule1 = { conditions: [condition1],
              actions: [new chrome.declarativeWebRequest.CancelRequest()]};
var rule2 = { conditions: [condition2],
              actions: [new chrome.declarativeWebRequest.CancelRequest()]};
chrome.declarativeWebRequest.onRequest.addRules([rule1, rule2]);

tercih:

  var rule = { conditions: [condition1, condition2],
                actions: [new chrome.declarativeWebRequest.CancelRequest()]};
  chrome.declarativeWebRequest.onRequest.addRules([rule]);

Filtrelenmiş etkinlikler

Filtrelenmiş etkinlikler, dinleyicilerin ilgilendikleri etkinliklerin bir alt kümesini belirtmesine olanak tanıyan bir mekanizmadır. Filtre kullanan bir dinleyici, filtreyi geçemeyen etkinlikler için çağrılmaz. Bu sayede dinleme kodu daha açıklayıcı ve verimli olur. Hizmet çalışanının, ilgilenmediği etkinlikleri işlemek için uyandırılması gerekmez.

Filtrelenmiş etkinlikler, aşağıdaki gibi manuel filtreleme kodundan geçiş yapılmasına olanak tanır:

chrome.webNavigation.onCommitted.addListener(function(e) {
  if (hasHostSuffix(e.url, 'google.com') ||
      hasHostSuffix(e.url, 'google.com.au')) {
    // ...
  }
});

şuna dönüştürün:

chrome.webNavigation.onCommitted.addListener(function(e) {
  // ...
}, {url: [{hostSuffix: 'google.com'},
          {hostSuffix: 'google.com.au'}]});

Etkinlikler, ilgili etkinlik için anlamlı olan belirli filtreleri destekler. Bir etkinliğin desteklediği filtrelerin listesi, ilgili etkinliğin dokümanlarındaki "filtreler" bölümünde yer alır.

URL'leri eşleştirirken (yukarıdaki örnekte olduğu gibi) etkinlik filtreleri, şema ve bağlantı noktası eşleştirme hariç olmak üzere events.UrlFilter ile ifade edilebilen URL eşleştirme özelliklerini destekler.