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 图像时，请确保图像包含高度和宽度属性，例如 <svg width="96" height="96"…。否则，图像可能不会显示。

contextMessage 可选

string。要显示的补充内容。

priority 可选

number。通知的优先级：可以是 0、1 或 2。如果省略，则默认为 0。

eventTime 可选

number。通知的时间戳，以 自纪元以来的毫秒数 表示。

buttons 可选

array of button。要包含在通知中的最多 2 个按钮的数组。您可以使用 notifications.onButtonClicked 监听按钮点击事件。每个按钮都指定为一个具有以下属性的对象

title

string。按钮的标题。

iconUrl 可选

string。指向按钮图标的 URL。

imageUrl

string。指向要用于通知的图像的 URL。该 URL 可以是：数据 URL、Blob URL，或 相对 URL 指向扩展程序中的文件。使用 SVG 图像时，请确保图像包含高度和宽度属性，例如 <svg width="96" height="96"…。否则，图像可能不会显示。

此属性仅在 type 为 "image" 时才允许。在这种情况下，如果 NotificationOptions 用于 notifications.create()，则它是必需的；如果它用于 notifications.update()，则它是可选的。

items

array of 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 不受支持。