chrome.notifications

Açıklama

Şablonları kullanarak zengin bildirimler oluşturmak ve bu bildirimleri sistem tepsisinde kullanıcılara göstermek için chrome.notifications API'sini kullanın.

İzinler

notifications

Türler

NotificationBitmap

NotificationButton

Özellikler

  • iconUrl

    string isteğe bağlı

    Chrome 59 sürümünden itibaren kullanımdan kaldırıldı

    Düğme simgeleri Mac OS X kullanıcıları tarafından görülmez.

  • title

    dize

NotificationItem

Özellikler

  • mesaj

    dize

    Bu öğeyle ilgili ek ayrıntılar.

  • title

    dize

    Bir liste bildirimindeki tek bir öğenin başlığı.

NotificationOptions

Özellikler

  • appIconMaskUrl

    string isteğe bağlı

    Chrome 59 sürümünden itibaren kullanımdan kaldırıldı

    Uygulama simgesi maskesi, Mac OS X kullanıcıları tarafından görülemez.

    Uygulama simgesi maskesinin URL'si. URL'ler iconUrl ile aynı kısıtlamalara sahiptir.

    Resmin yalnızca alfa kanalı dikkate alınacağından uygulama simgesi maskesi alfa kanalında olmalıdır.

  • düğmeler

    NotificationButton[] isteğe bağlı

    En fazla iki bildirim işlem düğmesi için metin ve simgeler.

  • contextMessage

    string isteğe bağlı

    Düşük yazı tipine sahip alternatif bildirim içeriği.

  • eventTime

    numara isteğe bağlı

    Dönemden sonraki milisaniye cinsinden bildirimle ilişkilendirilen zaman damgası (ör. Date.now() + n).

  • iconUrl

    string isteğe bağlı

    Resim bildirimlerinde gönderenin avatar, uygulama simgesi veya küçük resmine yönlendiren bir URL.

    URL'ler bir veri URL'si, bir blob URL'si veya bu uzantının .crx dosyasındaki bir kaynağa göre URL olabilir.

    **Not:**Bu değer, notifications.create() yöntemi için gereklidir.

  • imageUrl

    string isteğe bağlı

    Chrome 59 sürümünden itibaren kullanımdan kaldırıldı

    Resim, Mac OS X kullanıcıları tarafından görülemez.

    Resim türü bildirimler için resim küçük resminin URL'si. URL'ler iconUrl ile aynı kısıtlamalara sahiptir.

  • isClickable

    boole isteğe bağlı

    Chrome 67 sürümünden itibaren kullanımdan kaldırıldı

    Bu kullanıcı arayüzü ipucu, Chrome 67 sürümünden itibaren yoksayılmaktadır

  • items

    NotificationItem[] isteğe bağlı

    Çok öğeli bildirimler için öğeler. Mac OS X kullanıcıları yalnızca ilk öğeyi görür.

  • mesaj

    string isteğe bağlı

    Ana bildirim içeriği.

    **Not:**Bu değer, notifications.create() yöntemi için gereklidir.

  • önceliği

    numara isteğe bağlı

    Öncelik, -2 ile 2 arasında değişir. -2 en düşük önceliktir. 2 en yüksek değerdir. Varsayılan değer sıfırdır. Bildirim merkezini desteklemeyen platformlarda (Windows, Linux ve Mac), -2 ve -1 değerleri hatayla sonuçlanır. Çünkü bu önceliklerdeki bildirimler hiç gösterilmez.

  • ilerleme durumu

    numara isteğe bağlı

    Mevcut ilerleme durumu 0 ile 100 arasında değişir.

  • requireInteraction

    boole isteğe bağlı

    Chrome 50 ve sonraki sürümler

    Kullanıcı bildirimi etkinleştirene veya kapatana kadar bildirimin ekranda görünür durumda kalması gerektiğini belirtir. Bu değer, varsayılan olarak false (yanlış) değerine ayarlanır.

  • sessiz

    boole isteğe bağlı

    Chrome 70 ve sonraki sürümler

    Bildirim gösterilirken hiçbir sesin veya titreşimin olmaması gerektiğini belirtir. Bu değer, varsayılan olarak false (yanlış) değerine ayarlanır.

  • title

    string isteğe bağlı

    Bildirimin başlığı (ör. e-posta için gönderenin adı).

    **Not:**Bu değer, notifications.create() yöntemi için gereklidir.

  • tür

    TemplateType isteğe bağlı

    Gösterilecek bildirim türü. notifications.create yöntemi için gereklidir.

PermissionLevel

Enum

"granted"
Kullanıcının uygulamadan veya uzantıdan gelen bildirimleri göstermeyi seçtiğini belirtir. Bu, yükleme sırasında varsayılan ayardır.

"denied"
Kullanıcının uygulamadan veya uzantıdan gelen bildirimleri göstermemeyi seçtiğini belirtir.

TemplateType

Enum

"basic"
Bir simge, başlık, ileti, genişletilmişİleti ve en fazla iki düğme içerir.

"image"
Bir simge, başlık, ileti, genişletilmişİleti, resim ve en fazla iki düğme içerir.

"list"
Bir simge, başlık, ileti, öğeler ve en fazla iki düğme içerir. Mac OS X kullanıcıları yalnızca ilk öğeyi görür.

"progress"
Bir simge, başlık, ileti, ilerleme durumu ve en fazla iki düğme içerir.

Yöntemler

clear()

Söz 
chrome.notifications.clear(
  notificationId: string,
  callback?: function,
)

Belirtilen bildirimi temizler.

Parametreler

  • notificationId

    dize

    Temizlenecek bildirimin kimliği. Bu, notifications.create yöntemi tarafından döndürülür.

  • geri çağırma

    Functions (isteğe bağlı)

    callback parametresi şu şekilde görünür: 

    (wasCleared: boolean)=>void

    • wasCleared

      boolean

İlerlemeler

  • Promise<boolean>

    Chrome 116 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

create()

Söz 
chrome.notifications.create(
  notificationId?: string,
  options: NotificationOptions,
  callback?: function,
)

Bir bildirim oluşturur ve görüntüler.

Parametreler

  • notificationId

    string isteğe bağlı

    Bildirimin tanımlayıcısı. Ayarlanmazsa veya boş bırakılırsa otomatik olarak bir kimlik oluşturulur. Mevcut bir bildirimle eşleşirse bu yöntem, oluşturma işlemine devam etmeden önce ilk olarak söz konusu bildirimi siler. Tanımlayıcı 500 karakterden uzun olamaz.

    Chrome 42 sürümünden önce notificationId parametresi gereklidir.

  • seçenekler

    NotificationOptions

    Bildirimin içeriği.

  • geri çağırma

    Functions (isteğe bağlı)

    callback parametresi şu şekilde görünür: 

    (notificationId: string)=>void

    • notificationId

      dize

İlerlemeler

  • Söz<dize>

    Chrome 116 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

getAll()

Söz 
chrome.notifications.getAll(
  callback?: function,
)

Bu uygulama veya uzantının tüm bildirimlerini alır.

Parametreler

  • geri çağırma

    Functions (isteğe bağlı)

    callback parametresi şu şekilde görünür: 

    (notifications: object)=>void

    • bildirim

      nesne

İlerlemeler

  • Promise<object>

    Chrome 116 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

getPermissionLevel()

Söz 
chrome.notifications.getPermissionLevel(
  callback?: function,
)

Kullanıcının bu uygulamadan veya uzantıdan gelen bildirimleri etkinleştirip etkinleştirmediğini alır.

Parametreler

İlerlemeler

  • Promise<PermissionLevel>

    Chrome 116 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

update()

Söz 
chrome.notifications.update(
  notificationId: string,
  options: NotificationOptions,
  callback?: function,
)

Mevcut bir bildirimi günceller.

Parametreler

  • notificationId

    dize

    Güncellenecek bildirimin kimliği. Bu, notifications.create yöntemi tarafından döndürülür.

  • seçenekler

    NotificationOptions

    Güncellenecek bildirimin içeriği.

  • geri çağırma

    Functions (isteğe bağlı)

    callback parametresi şu şekilde görünür: 

    (wasUpdated: boolean)=>void

    • wasUpdated

      boolean

İlerlemeler

  • Promise<boolean>

    Chrome 116 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

Etkinlikler

onButtonClicked

chrome.notifications.onButtonClicked.addListener(
  callback: function,
)

Kullanıcı bildirimdeki bir düğmeye bastı.

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür: 

    (notificationId: string,buttonIndex: number)=>void

    • notificationId

      dize

    • buttonIndex

      sayı

onClicked

chrome.notifications.onClicked.addListener(
  callback: function,
)

Kullanıcı, bildirimin düğme olmayan bir alanını tıkladı.

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür: 

    (notificationId: string)=>void

    • notificationId

      dize

onClosed

chrome.notifications.onClosed.addListener(
  callback: function,
)

Bildirim, sistem veya kullanıcı işlemi tarafından kapatıldı.

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür: 

    (notificationId: string,byUser: boolean)=>void

    • notificationId

      dize

    • byUser

      boolean

onPermissionLevelChanged

chrome.notifications.onPermissionLevelChanged.addListener(
  callback: function,
)

Kullanıcı izin düzeyini değiştirir. Chrome 47 sürümünden itibaren yalnızca ChromeOS'te bu etkinliği gönderen kullanıcı arayüzü vardır.

Parametreler

onShowSettings

Chrome 65'ten itibaren kullanımdan kaldırıldı
chrome.notifications.onShowSettings.addListener(
  callback: function,
)

Özel bildirim ayarları düğmesi artık desteklenmiyor.

Kullanıcı, uygulamanın bildirim ayarları için bir bağlantıyı tıkladı. Chrome 47 sürümünden itibaren yalnızca ChromeOS'te bu etkinliği gönderen kullanıcı arayüzü vardır. Chrome 65'ten itibaren bu kullanıcı arayüzü ChromeOS'ten de kaldırılmıştır.

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür: 

    ()=>void