chrome.notifications

refresh date: 2026-09-25 robots: noindex

Opis

Użyj interfejsu chrome.notifications API, 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 są niewidoczne dla użytkowników systemu Mac OS X.

  • tytuł

    tekst

NotificationItem

Właściwości

  • wiadomość

    tekst

    Dodatkowe informacje o tym produkcie.

  • tytuł

    tekst

    Tytuł jednego elementu powiadomienia w formie listy.

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.

    Adres URL maski ikony aplikacji. Adresy URL podlegają tym samym ograniczeniom co iconUrl.

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

  • przyciski

    NotificationButton[] opcjonalny

    Tekst i ikony maksymalnie 2 przycisków działania powiadomienia.

  • contextMessage

    ciąg znaków opcjonalny

    Alternatywna treść powiadomienia z czcionką o mniejszej wadze.

  • eventTime

    number opcjonalny

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

  • iconUrl

    ciąg znaków opcjonalny

    Adres URL awatara nadawcy, ikony aplikacji lub miniatury powiadomień z obrazem.

    Adresy URL mogą być adresami URL danych, adresami URL obiektów blob lub adresami URL względnymi w stosunku do zasobu 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 podlegają tym samym ograniczeniom co iconUrl.

  • isClickable

    wartość logiczna opcjonalna

    Wycofane w Chrome 67

    Ta wskazówka interfejsu jest ignorowana od Chrome 67.

  • elementy

    NotificationItem[] opcjonalny

    Elementy powiadomień dotyczących wielu produktów. 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 opcjonalny

    Priorytet może mieć wartość od -2 do 2. -2 to najniższy priorytet. 2 to najwyższa wartość. 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 opcjonalny

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

  • requireInteraction

    wartość logiczna opcjonalna

    Chrome 50 lub nowsza

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

  • cichy

    wartość logiczna opcjonalna

    Chrome w wersji 70 lub nowszej

    Wskazuje, że podczas wyświetlania powiadomienia nie należy odtwarzać dźwięków ani włączać wibracji. Domyślnie ma wartość „false”.

  • tytuł

    ciąg znaków opcjonalny

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

    ** 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 wybrał opcję wyświetlania powiadomień z aplikacji lub rozszerzenia. Jest to ustawienie domyślne w momencie instalacji.

„denied”
Określa, że użytkownik nie chce wyświetlać powiadomień z aplikacji lub rozszerzenia.

TemplateType

Typ wyliczeniowy

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

„image”
Zawiera ikonę, tytuł, wiadomość, expandedMessage, 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 do usunięcia. Jest on zwracany przez metodę notifications.create.

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (wasCleared: boolean) => void

    • wasCleared

      wartość logiczna

Zwroty

  • Promise<boolean>

    Chrome 116 lub nowsza

    Zwraca obiekt Promise, który jest rozwiązywany, aby wskazać, czy istniało pasujące powiadomienie.

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą 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 to pole nie jest skonfigurowane lub jest puste, identyfikator zostanie wygenerowany automatycznie. Jeśli pasuje do istniejącego powiadomienia, ta metoda najpierw usuwa to powiadomienie, a potem wykonuje operację tworzenia. Identyfikator nie może mieć więcej niż 500 znaków.

    Parametr notificationId jest wymagany w wersjach Chrome starszych niż 42.

  • Zawartość powiadomienia.

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (notificationId: string) => void

    • notificationId

      tekst

Zwroty

  • Promise<string>

    Chrome 116 lub nowsza

    Zwraca obiekt Promise, który jest rozwiązywany z identyfikatorem powiadomienia (dostarczonym lub wygenerowanym) reprezentującym utworzone powiadomienie.

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

getAll()

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

Pobiera wszystkie powiadomienia z tej aplikacji lub rozszerzenia.

Parametry

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (notifications: object) => void

    • powiadomienia

      obiekt

Zwroty

  • Promise<object>

    Chrome 116 lub nowsza

    Zwraca obiekt Promise, który jest rozwiązywany z zestawem identyfikatorów powiadomień znajdujących się obecnie w systemie.

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

getPermissionLevel()

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

Pobiera informację o tym, czy użytkownik włączył powiadomienia z tej aplikacji lub rozszerzenia.

Parametry

Zwroty

  • Promise<PermissionLevel>

    Chrome 116 lub nowsza

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

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą 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 on zwracany przez metodę notifications.create.

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

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (wasUpdated: boolean) => void

    • wasUpdated

      wartość logiczna

Zwroty

  • Promise<boolean>

    Chrome 116 lub nowsza

    Zwraca obiekt Promise, który jest rozwiązywany, aby wskazać, czy istniało pasujące powiadomienie.

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą 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 w wyniku działania 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 w 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 interfejs ten został usunięty również z ChromeOS.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    () => void