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'sını kullanın.

İzinler

notifications

Türler

NotificationBitmap

NotificationButton

Özellikler

  • iconUrl

    dize isteğe bağlı

    Chrome 59'dan bu yana desteği sonlandırıldı

    Düğme simgeleri Mac OS X kullanıcıları için görünür değil.

  • title

    dize

NotificationItem

Özellikler

  • mesaj

    dize

    Bu öğe hakkındaki ek ayrıntılar.

  • title

    dize

    Liste bildirimindeki bir öğenin başlığı.

NotificationOptions

Özellikler

  • appIconMaskUrl

    dize isteğe bağlı

    Chrome 59'dan bu yana desteği sonlandı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

    dize isteğe bağlı

    Daha düşük yazı tipiyle alternatif bildirim içeriği.

  • eventTime

    sayı isteğe bağlı

    Bildirimle ilişkili, dönemden sonra milisaniye cinsinden zaman damgası (ör. Date.now() + n).

  • iconUrl

    dize isteğe bağlı

    Resim bildirimleri için gönderenin avatarı, uygulama simgesi veya küçük resmi URL'si.

    URL'ler bir veri URL'si, 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

    dize isteğe bağlı

    Chrome 59'dan bu yana desteği sonlandırıldı

    Görsel, Mac OS X kullanıcıları tarafından görülmez.

    Resim türü bildirimleri için küçük resmin URL'si. URL'ler, iconUrl ile aynı kısıtlamalara sahiptir.

  • isClickable

    boole isteğe bağlı

    Chrome 67'den bu yana desteği sonlandırıldı

    Bu kullanıcı arayüzü ipucu, Chrome 67 sürümünden itibaren yoksayılı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

    dize isteğe bağlı

    Ana bildirim içeriği.

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

  • önceliği

    sayı isteğe bağlı

    Öncelik -2 ile 2 arasında değişir. -2 en düşük önceliklidir. 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, bu önceliklere sahip bildirimler hiç gösterilmediğinden hata verir.

  • ilerleme durumu

    sayı isteğe bağlı

    Mevcut ilerleme durumu 0-100 arasındadır.

  • requireInteraction

    boole isteğe bağlı

    Chrome 50 ve sonraki sürümler 'nı inceleyin.

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

  • sessiz

    boole isteğe bağlı

    Chrome 70 ve sonraki sürümler 'nı inceleyin.

    Bildirim gösterilirken ses veya titreşim yapılmaması gerektiğini belirtir. Bu değer varsayılan olarak yanlış değerine ayarlanır.

  • title

    dize 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 bildirimin türü. notifications.create yöntemi için gereklidir.

PermissionLevel

Enum

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

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

TemplateType

Enum

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

"image"
Bir simge, başlık, ileti, enhancedMessage, 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, mesaj, ilerleme durumu ve en fazla iki düğme içerir.

Yöntemler

clear()

Söz 'nı inceleyin.
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

    işlev isteğe bağlı

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

    (wasCleared: boolean) => void

    • wasCleared

      boolean

İadeler

  • Promise<boolean>

    Chrome 116 ve sonraki sürümler 'nı inceleyin.

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

create()

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

Bildirim oluşturur ve görüntüler.

Parametreler

  • notificationId

    dize 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 söz konusu bildirimi temizler. Tanımlayıcı 500 karakterden uzun olamaz.

    Chrome 42'den önce notificationId parametresi gereklidir.

  • seçenekler

    NotificationOptions

    Bildirimin içeriği.

  • geri çağırma

    işlev isteğe bağlı

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

    (notificationId: string) => void

    • notificationId

      dize

İadeler

  • Promise<dize>

    Chrome 116 ve sonraki sürümler 'nı inceleyin.

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

getAll()

Söz 'nı inceleyin.
chrome.notifications.getAll(
  callback?: function,
)

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

Parametreler

  • geri çağırma

    işlev isteğe bağlı

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

    (notifications: object) => void

    • bildirim

      nesne

İadeler

  • Promise&lt;object&gt;

    Chrome 116 ve sonraki sürümler 'nı inceleyin.

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

getPermissionLevel()

Söz 'nı inceleyin.
chrome.notifications.getPermissionLevel(
  callback?: function,
)

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

Parametreler

İadeler

  • Promise&lt;PermissionLevel&gt;

    Chrome 116 ve sonraki sürümler 'nı inceleyin.

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

update()

Söz 'nı inceleyin.
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

    işlev isteğe bağlı

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

    (wasUpdated: boolean) => void

    • wasUpdated

      boolean

İadeler

  • Promise&lt;boolean&gt;

    Chrome 116 ve sonraki sürümler 'nı inceleyin.

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, 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 nedeniyle 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 bu etkinliği gönderen kullanıcı arayüzü yalnızca ChromeOS'te mevcuttur.

Parametreler

onShowSettings

Chrome 65'ten bu yana desteği sonlandı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 bu etkinliği gönderen kullanıcı arayüzü yalnızca ChromeOS'te mevcuttur. Bu kullanıcı arayüzü, Chrome 65 itibarıyla ChromeOS'ten de kaldırılmıştır.

Parametreler

  • geri çağırma

    işlev

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

    () => void