chrome.notifications

Açıklama

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

İzinler

notifications

Türler

NotificationBitmap

NotificationButton

Özellikler

  • iconUrl

    dize isteğe bağlı

    Chrome 59'dan beri kullanımdan kaldırıldı

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

  • title

    dize

NotificationItem

Özellikler

  • mesaj

    dize

    Bu öğe hakkında ek bilgiler.

  • title

    dize

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

NotificationOptions

Özellikler

  • appIconMaskUrl

    dize isteğe bağlı

    Chrome 59'dan beri 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.

    Yalnızca resmin 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üğmesinin metinleri ve simgeleri.

  • contextMessage

    dize isteğe bağlı

    Daha az kalınlıkta bir yazı tipiyle alternatif bildirim içeriği.

  • eventTime

    number isteğe bağlı

    Bildirimle ilişkilendirilmiş, dönemin başlangıcından itibaren geçen milisaniye cinsinden zaman damgası (ör. Date.now() + n).

  • iconUrl

    dize isteğe bağlı

    Gönderenin avatarının, uygulama simgesinin veya resim bildirimlerinin küçük resminin URL'si.

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

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

  • imageUrl

    dize isteğe bağlı

    Chrome 59'dan beri 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

    boolean isteğe bağlı

    Chrome 67'den beri kullanımdan kaldırıldı

    Bu kullanıcı arayüzü ipucu, Chrome 67'den itibaren göz ardı edilir.

  • 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

    number isteğe bağlı

    Öncelik -2 ile 2 arasında değişir. -2 en düşük önceliği ifade eder. 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 hataya neden olur. Bu önceliklere sahip bildirimler hiç gösterilmez.

  • ilerleme durumu

    number isteğe bağlı

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

  • requireInteraction

    boolean isteğe bağlı

    Chrome 50 veya daha yeni bir sürüm

    Bildirimin, kullanıcı etkinleştirinceye veya kapatıncaya kadar ekranda görünür kalması gerektiğini belirtir. Bu ayar varsayılan olarak false değerine ayarlanır.

  • sessiz

    boolean isteğe bağlı

    Chrome 70 veya daha yeni bir sürüm

    Bildirim gösterilirken ses veya titreşim olmaması gerektiğini belirtir. Bu ayar varsayılan olarak false 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ı

    Hangi tür bildirimlerin gösterileceği. 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 zamanındaki varsayılandır.

"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, mesaj, expandedMessage ve en fazla iki düğme içerir.

"image"
Simge, başlık, mesaj, expandedMessage, resim ve en fazla iki düğme içerir.

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

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

Yöntemler

clear()

chrome.notifications.clear(
  notificationId: string,
): Promise<boolean>

Belirtilen bildirimi temizler.

Parametreler

  • notificationId

    dize

    Temizlenecek bildirimin kimliği. Bu, notifications.create yöntemiyle döndürülür.

İadeler

  • Promise<boolean>

    Chrome 116 veya daha yeni bir sürüm

create()

chrome.notifications.create(
  notificationId?: string,
  options: NotificationOptions,
): Promise<string>

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

Parametreler

  • notificationId

    dize isteğe bağlı

    Bildirimin tanımlayıcısı. Ayarlanmamışsa veya boşsa otomatik olarak bir kimlik oluşturulur. Bu yöntem, mevcut bir bildirimle eşleşirse 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.

İadeler

  • Promise<string>

    Chrome 116 veya daha yeni bir sürüm

getAll()

chrome.notifications.getAll(): Promise<object>

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

İadeler

  • Promise<object>

    Chrome 116 veya daha yeni bir sürüm

getPermissionLevel()

chrome.notifications.getPermissionLevel(): Promise<PermissionLevel>

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

İadeler

update()

chrome.notifications.update(
  notificationId: string,
  options: NotificationOptions,
): Promise<boolean>

Mevcut bir bildirimi günceller.

Parametreler

İadeler

  • Promise<boolean>

    Chrome 116 veya daha yeni bir sürüm

Etkinlikler

onButtonClicked

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

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

Parametreler

  • callback

    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

  • callback

    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şlemiyle kapatıldı.

Parametreler

  • callback

    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'den itibaren yalnızca ChromeOS'te bu etkinliği gönderen bir kullanıcı arayüzü bulunur.

Parametreler

onShowSettings

Chrome 65'ten beri 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ı bağlantısını tıkladı. Chrome 47'den itibaren yalnızca ChromeOS'te bu etkinliği gönderen bir kullanıcı arayüzü bulunur. Chrome 65'ten itibaren bu kullanıcı arayüzü ChromeOS'ten de kaldırıldı.

Parametreler

  • callback

    işlev

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

    () => void