This type contains all the data needed to:
notifications.create()
,
notifications.update()
.
Values of this type are objects. They contain the properties listed below.
The first three properties -
type
,
title
,
message
- are mandatory in
notifications.create()
, but optional in
notifications.update()
. Firefox currently: only supports the
type
,
title
,
message
,和
iconUrl
properties; and the only supported value for
type
is
'basic'
.
type
notifications.TemplateType
. The type of notification you want. Depending on your choice here, certain other properties are either mandatory or are not permitted.
message
string
. The notification's main content.
title
string
. The notification's title.
iconUrl
可选
string
. A URL pointing to an icon to display in the notification. The URL can be: a data URL, a blob URL, a http or https URL, or the
relative URL of a file within the extension.
contextMessage
可选
string
. Supplementary content to display.
priority
可选
编号
. The notification's priority: may be 0, 1, or 2. Defaults to 0 if omitted.
eventTime
可选
编号
. A timestamp for the notification in
milliseconds since the epoch
.
buttons
可选
array
of
button
. An array of up to 2 buttons to include in the notification. You can listen for button clicks using
notifications.onButtonClicked
. Each button is specified as an object with the following properties:
title
string
. Title for the button.
iconUrl
可选
string
. URL pointing to an icon for the button.
imageUrl
string
. A URL pointing to an image to use in the notification. The URL can be: a data URL, a blob URL, or the
relative URL
of a file within the extension.
This property is only permitted if
type
is
"image"
. In this case, it is mandatory if the
NotificationOptions
用于
notifications.create()
, and optional if it is used in
notifications.update()
.
项
array
of
item
. An array of items to include in the notification. Depending on the settings for the operating system's notification mechanism, some of the items you provide might not be displayed. Each item is specified as an object with the following properties:
title
string
. Title to display in the item.
message
string
. Message to display in the item.
This property is only permitted if
type
is
"list"
. In this case, it is mandatory if the
NotificationOptions
用于
notifications.create()
, and optional if it is used in
notifications.update()
.
progress
integer
. An integer between 0 and 100, used to represent the current progress in a progress indicator.
This property is only permitted if
type
is
"progress"
. In this case, it is mandatory if the
NotificationOptions
用于
notifications.create()
, and optional if it is used in
notifications.update()
.
注意,
appIconMaskUrl
and
isClickable
不支持。
BCD tables only load in the browser
注意:
This API is based on Chromium's
chrome.notifications
API。
Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.
最后修改: , 由 MDN 贡献者