chrome.notifications

refresh date: 2026-09-25 robots: noindex

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'dan itibaren desteği sonlandırıldı

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

  • title

    dize

NotificationItem

Özellikler

  • mesaj

    dize

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

  • title

    dize

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

NotificationOptions

Özellikler

  • appIconMaskUrl

    string isteğe bağlı

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

    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üğmesi için metin ve simgeler.

  • contextMessage

    string isteğe bağlı

    Daha ince bir yazı tipiyle alternatif bildirim içeriği.

  • eventTime

    number isteğe bağlı

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

  • iconUrl

    string isteğe bağlı

    Gönderenin avatarının, uygulama simgesinin veya resim bildirimleri için küçük resmin URL'si.

    URL'ler bir veri URL'si, blob URL'si veya bu uzantının .crx dosyasındaki bir kaynakla ilgili URL olabilir.

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

  • imageUrl

    string isteğe bağlı

    Chrome 59'dan itibaren desteği sonlandı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'den itibaren desteği sonlandırıldı

    Bu kullanıcı arayüzü ipucu, Chrome 67'den 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

    string 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 önceliktir. 2 en yüksek önceliği ifade eder. 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

    boole isteğe bağlı

    Chrome 50+

    Bildirimin, kullanıcı tarafından etkinleştirilene veya kapatılana kadar ekranda görünür kalması gerektiğini belirtir. Bu ayar varsayılan olarak "false" (yanlış) değerine ayarlıdır.

  • sessiz

    boole isteğe bağlı

    Chrome 70+

    Bildirim gösterilirken ses veya titreşim olmaması gerektiğini belirtir. Bu ayar varsayılan olarak "false" (yanlış) değerine ayarlıdı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, uygulama veya uzantıdan bildirim göstermeyi seçtiğini belirtir. Bu, yükleme sırasındaki varsayılan ayardır.

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

TemplateType

Enum

"basic"
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()

Taahhüt 
chrome.notifications.clear(
  notificationId: string,
  callback?: function,
): Promise<boolean>

Belirtilen bildirimi temizler.

Parametreler

  • notificationId

    dize

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

  • callback

    function isteğe bağlı

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

    (wasCleared: boolean) => void

    • wasCleared

      boole

İadeler

  • Promise<boolean>

    Chrome 116+

    Eşleşen bir bildirimin mevcut olup olmadığını belirten bir Promise döndürür.

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

create()

Taahhüt 
chrome.notifications.create(
  notificationId?: string,
  options: NotificationOptions,
  callback?: function,
): Promise<string>

Bildirim oluşturur ve gösterir.

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 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.

  • callback

    function isteğe bağlı

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

    (notificationId: string) => void

    • notificationId

      dize

İadeler

  • Promise<string>

    Chrome 116+

    Oluşturulan bildirimi temsil eden bildirim kimliğiyle (sağlanan veya oluşturulan) çözümlenen bir Promise döndürür.

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

getAll()

Taahhüt 
chrome.notifications.getAll(
  callback?: function,
): Promise<object>

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

Parametreler

  • callback

    function isteğe bağlı

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

    (notifications: object) => void

    • bildirim

      nesne

İadeler

  • Promise<object>

    Chrome 116+

    Sistemde bulunan notification_id'leri döndüren bir Promise döndürür.

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

getPermissionLevel()

Taahhüt 
chrome.notifications.getPermissionLevel(
  callback?: function,
): Promise<PermissionLevel>

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

Parametreler

İadeler

  • Promise<PermissionLevel>

    Chrome 116+

    Mevcut izin seviyesiyle çözümlenen bir Promise döndürür.

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

update()

Taahhüt 
chrome.notifications.update(
  notificationId: string,
  options: NotificationOptions,
  callback?: function,
): Promise<boolean>

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

    Bildirimin güncellenecek içeriği.

  • callback

    function isteğe bağlı

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

    (wasUpdated: boolean) => void

    • wasUpdated

      boole

İadeler

  • Promise<boolean>

    Chrome 116+

    Eşleşen bir bildirimin mevcut olup olmadığını belirten bir Promise döndürür.

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

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

      boole

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ü vardır.

Parametreler

onShowSettings

Chrome 65'ten itibaren 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ıyla ilgili bir bağlantıyı tıkladı. Chrome 47'den itibaren, yalnızca ChromeOS'te bu etkinliği gönderen bir kullanıcı arayüzü vardır. 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