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'lerin kısıtlamaları iconUrl ile aynıdır.
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'lerin kısıtlamaları iconUrl ile aynıdır.
-
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ümlerKullanı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ümlerBildirim 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()
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ümlerVaatler, 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()
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
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ümlerVaatler, 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()
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ümlerVaatler, 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()
chrome.notifications.getPermissionLevel(
callback?: function,
)
Kullanıcının bu uygulamadan veya uzantıdan gelen bildirimleri etkinleştirip etkinleştirmediğini alır.
Parametreler
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(level: PermissionLevel) => void
-
seviye
-
İlerlemeler
-
Promise<PermissionLevel>
Chrome 116 ve sonraki sürümlerVaatler, 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()
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
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ümlerVaatler, 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
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(level: PermissionLevel) => void
-
seviye
-
onShowSettings
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