chrome.notifications

refresh date: 2026-09-25 robots: noindex

Opis

Użyj interfejsu API chrome.notifications, aby tworzyć rozbudowane powiadomienia za pomocą szablonów i wyświetlać je użytkownikom w obszarze powiadomień.

Uprawnienia

notifications

Typy

NotificationBitmap

NotificationButton

Właściwości

  • iconUrl

    ciąg znaków opcjonalny

    Wycofane w Chrome 59

    Ikony przycisków nie są widoczne dla użytkowników systemu Mac OS X.

  • tytuł

    tekst

NotificationItem

Właściwości

  • wiadomość

    tekst

    Dodatkowe informacje o tym elemencie.

  • tytuł

    tekst

    Tytuł jednego elementu powiadomienia z listą.

NotificationOptions

Właściwości

  • appIconMaskUrl

    ciąg znaków opcjonalny

    Wycofane w Chrome 59

    Maska ikony aplikacji nie jest widoczna dla użytkowników systemu Mac OS X.

    URL maski ikony aplikacji. Adresy URL mają takie same ograniczenia jak iconUrl.

    Maska ikony aplikacji powinna być w kanale alfa, ponieważ tylko kanał alfa obrazu będzie brany pod uwagę.

  • przyciski

    NotificationButton[] opcjonalny

    Tekst i ikony maksymalnie 2 przycisków polecenia powiadomienia.

  • contextMessage

    ciąg znaków opcjonalny

    Treść powiadomienia o alternatywnym działaniu z użyciem czcionki o mniejszej grubości.

  • eventTime

    number optional

    Sygnatura czasowa powiązana z powiadomieniem, w milisekundach od początku epoki (np. Date.now() + n).

  • iconUrl

    ciąg znaków opcjonalny

    URL awatara nadawcy, ikony aplikacji lub miniatury powiadomień o obrazach.

    Adresy URL mogą być adresami URL danych, adresami URL obiektów blob lub adresami URL powiązanymi z zasobem w pliku .crx tego rozszerzenia

    **Uwaga:**ta wartość jest wymagana w przypadku metody notifications.create().

  • imageUrl

    ciąg znaków opcjonalny

    Wycofane w Chrome 59

    Obraz nie jest widoczny dla użytkowników systemu Mac OS X.

    Adres URL miniatury obrazu w przypadku powiadomień typu obraz. Adresy URL mają takie same ograniczenia jak iconUrl.

  • isClickable

    boolean opcjonalne

    Wycofane od Chrome 67

    Ta wskazówka dotycząca interfejsu jest ignorowana od wersji Chrome 67

  • elementy

    NotificationItem[] opcjonalny

    Elementy powiadomień o wielu produktach. Użytkownicy systemu Mac OS X widzą tylko pierwszy element.

  • wiadomość

    ciąg znaków opcjonalny

    Główna treść powiadomienia.

    **Uwaga:**ta wartość jest wymagana w przypadku metody notifications.create().

  • kampanii

    number optional

    Priorytet może mieć wartość od -2 do 2. -2 to najniższy priorytet. 2 to najwyższy priorytet. Wartość domyślna to 0. Na platformach, które nie obsługują centrum powiadomień (Windows, Linux i Mac), wartości -2 i -1 powodują błąd, ponieważ powiadomienia o tych priorytetach nie będą w ogóle wyświetlane.

  • postęp

    number optional

    Bieżący postęp może wynosić od 0 do 100.

  • requireInteraction

    boolean opcjonalne

    Chrome 50 lub nowsza wersja

    Wskazuje, że powiadomienie powinno pozostać widoczne na ekranie, dopóki użytkownik go nie aktywuje lub nie zamknie. Domyślnie to ustawienie ma wartość „false”.

  • cichy

    boolean opcjonalne

    Chrome 70 lub nowsza wersja

    Wskazuje, że podczas wyświetlania powiadomienia nie powinny być odtwarzane żadne dźwięki ani wibracje. Domyślnie to ustawienie ma wartość „false”.

  • tytuł

    ciąg znaków opcjonalny

    Tytuł powiadomienia (np. nazwa nadawcy w e-mailu).

    **Uwaga:**ta wartość jest wymagana w przypadku metody notifications.create().

  • typ

    TemplateType opcjonalny

    Typ powiadomienia, które ma się wyświetlać. Wymagane w przypadku metody notifications.create.

PermissionLevel

Typ wyliczeniowy

"granted"
Określa, że użytkownik zdecydował się na wyświetlanie powiadomień z aplikacji lub rozszerzenia. Jest to ustawienie domyślne podczas instalacji.

"denied"
Określa, że użytkownik nie chce, aby aplikacja lub rozszerzenie wyświetlały powiadomienia.

TemplateType

Typ wyliczeniowy

"basic"
Zawiera ikonę, tytuł, wiadomość, wiadomość rozwiniętą i maksymalnie 2 przyciski.

"image"
Zawiera ikonę, tytuł, wiadomość, rozwiniętą wiadomość, obraz i maksymalnie 2 przyciski.

"list"
Zawiera ikonę, tytuł, wiadomość, elementy i maksymalnie 2 przyciski. Użytkownicy systemu Mac OS X widzą tylko pierwszy element.

"progress"
Zawiera ikonę, tytuł, wiadomość, postęp i maksymalnie 2 przyciski.

Metody

clear()

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

Usuwa określone powiadomienie.

Parametry

  • notificationId

    tekst

    Identyfikator powiadomienia, które ma zostać usunięte. Jest zwracany przez metodę notifications.create.

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    (wasCleared: boolean) => void

    • wasCleared

      wartość logiczna

Zwroty

  • Promise<boolean>

    Chrome 116 lub nowsza wersja

    Zwraca obiekt Promise, który wskazuje, czy istnieje pasujące powiadomienie.

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

create()

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

Tworzy i wyświetla powiadomienie.

Parametry

  • notificationId

    ciąg znaków opcjonalny

    Identyfikator powiadomienia. Jeśli nie zostanie ustawiony lub będzie pusty, identyfikator zostanie wygenerowany automatycznie. Jeśli pasuje do istniejącego powiadomienia, ta metoda najpierw usuwa to powiadomienie, a następnie przechodzi do operacji tworzenia. Identyfikator nie może mieć więcej niż 500 znaków.

    Parametr notificationId jest wymagany w przypadku wersji Chrome starszych niż 42.

  • Treść powiadomienia.

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    (notificationId: string) => void

    • notificationId

      tekst

Zwroty

  • Promise<string>

    Chrome 116 lub nowsza wersja

    Zwraca obiekt Promise, który jest rozwiązywany za pomocą identyfikatora powiadomienia (podanego lub wygenerowanego) reprezentującego utworzone powiadomienie.

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

getAll()

Obietnica 
chrome.notifications.getAll(
  callback?: function,
): Promise<object>

Pobiera wszystkie powiadomienia dotyczące tej aplikacji lub rozszerzenia.

Parametry

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    (notifications: object) => void

    • powiadomienia

      obiekt

Zwroty

  • Promise<object>

    Chrome 116 lub nowsza wersja

    Zwraca obiekt Promise, który rozwiązuje się z zestawem notification_ids obecnie w systemie.

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

getPermissionLevel()

Obietnica 
chrome.notifications.getPermissionLevel(
  callback?: function,
): Promise<PermissionLevel>

Sprawdza, czy użytkownik włączył powiadomienia z tej aplikacji lub rozszerzenia.

Parametry

Zwroty

  • Promise<PermissionLevel>

    Chrome 116 lub nowsza wersja

    Zwraca obiekt Promise, który jest rozwiązywany z bieżącym poziomem uprawnień.

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

update()

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

Aktualizuje istniejące powiadomienie.

Parametry

  • notificationId

    tekst

    Identyfikator powiadomienia, które ma zostać zaktualizowane. Jest zwracany przez metodę notifications.create.

  • Treść powiadomienia, które ma zostać zaktualizowane.

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    (wasUpdated: boolean) => void

    • wasUpdated

      wartość logiczna

Zwroty

  • Promise<boolean>

    Chrome 116 lub nowsza wersja

    Zwraca obiekt Promise, który wskazuje, czy istnieje pasujące powiadomienie.

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

Wydarzenia

onButtonClicked

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

Użytkownik nacisnął przycisk w powiadomieniu.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

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

    • notificationId

      tekst

    • buttonIndex

      liczba

onClicked

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

Użytkownik kliknął obszar powiadomienia, który nie jest przyciskiem.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (notificationId: string) => void

    • notificationId

      tekst

onClosed

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

Powiadomienie zostało zamknięte przez system lub użytkownika.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

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

    • notificationId

      tekst

    • byUser

      wartość logiczna

onPermissionLevelChanged

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

Użytkownik zmienia poziom uprawnień. Od wersji Chrome 47 tylko ChromeOS ma interfejs, który wysyła to zdarzenie.

Parametry

onShowSettings

Wycofane od Chrome 65
chrome.notifications.onShowSettings.addListener(
  callback: function,
)

Przycisk niestandardowych ustawień powiadomień nie jest już obsługiwany.

Użytkownik kliknął link do ustawień powiadomień aplikacji. Od wersji Chrome 47 tylko ChromeOS ma interfejs, który wysyła to zdarzenie. W Chrome 65 ten interfejs został usunięty również z ChromeOS.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    () => void