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。

浏览器兼容性