notifications.NotificationOptions

型別

此型別的值是物件。它們包含以下列出的屬性。

前三個屬性 - type、title、message - 在 notifications.create() 中是必需的，但在 notifications.update() 中是可選的。Firefox 目前只支援 type、title、message 和 iconUrl 屬性；並且 type 唯一支援的值是 'basic'。

type

notifications.TemplateType。您想要的通知型別。根據您的選擇，某些其他屬性要麼是必需的，要麼是不允許的。

message

string。通知的主要內容。

title

string。通知的標題。

iconUrl 可選

string。指向要在通知中顯示的圖示的 URL。URL 可以是：資料 URL、Blob URL、http 或 https URL，或者是擴充套件程式內檔案的相對 URL。使用 SVG 影像時，請確保影像包含 height 和 width 屬性，例如 <svg width="96" height="96"…。否則，影像可能無法顯示。

contextMessage 可選

string。要顯示的補充內容。

priority 可選

number。通知的優先順序：可以是 0、1 或 2。如果省略，則預設為 0。

eventTime 可選

number。通知的時間戳，以自紀元以來的毫秒數表示。

buttons 可選

button 陣列。通知中最多可包含 2 個按鈕的陣列。您可以使用 notifications.onButtonClicked 監聽按鈕點選事件。每個按鈕都指定為具有以下屬性的物件：

title

string。按鈕的標題。

iconUrl 可選

string。指向按鈕圖示的 URL。

imageUrl

string。指向要在通知中使用的影像的 URL。URL 可以是：資料 URL、Blob URL，或者是擴充套件程式內檔案的相對 URL。使用 SVG 影像時，請確保影像包含 height 和 width 屬性，例如 <svg width="96" height="96"…。否則，影像可能無法顯示。

此屬性僅在 type 為 "image" 時允許。在這種情況下，如果 NotificationOptions 用於 notifications.create()，則此屬性是必需的；如果用於 notifications.update()，則此屬性是可選的。

items

item 陣列。通知中要包含的專案的陣列。根據作業系統的通知機制設定，您提供的一些專案可能不會顯示。每個專案都指定為具有以下屬性的物件：

title

string。要在專案中顯示的標題。

message

string。要在專案中顯示的訊息。

此屬性僅在 type 為 "list" 時允許。在這種情況下，如果 NotificationOptions 用於 notifications.create()，則此屬性是必需的；如果用於 notifications.update()，則此屬性是可選的。

progress

integer。一個介於 0 和 100 之間的整數，用於表示進度指示器中的當前進度。

此屬性僅在 type 為 "progress" 時允許。在這種情況下，如果 NotificationOptions 用於 notifications.create()，則此屬性是必需的；如果用於 notifications.update()，則此屬性是可選的。

請注意，不支援 appIconMaskUrl 和 isClickable。

瀏覽器相容性