chrome.notifications

Properties

• iconUrl

  string optional
  Deprecated 59+

  Button icons not visible for Mac OS X users.

• title

  string

Properties

• message

  string

  Additional details about this item.

• title

  string

  Title of one item of a list notification.

Properties

• appIconMaskUrl

  string optional
  Deprecated 59+

  The app icon mask is not visible for Mac OS X users.

  A URL to the app icon mask. URLs have the same restrictions as iconUrl.

  The app icon mask should be in alpha channel, as only the alpha channel of the image will be considered.

• buttons

  NotificationButton[] optional

  Text and icons for up to two notification action buttons.

• contextMessage

  string optional

  Alternate notification content with a lower-weight font.

• eventTime

  number optional

  A timestamp associated with the notification, in milliseconds past the epoch (e.g. Date.now() + n).

• iconUrl

  string optional

  A URL to the sender's avatar, app icon, or a thumbnail for image notifications.

  URLs can be a data URL, a blob URL, or a URL relative to a resource within this extension's .crx file Required for notifications.create method.

• imageUrl

  string optional
  Deprecated 59+

  The image is not visible for Mac OS X users.

  A URL to the image thumbnail for image-type notifications. URLs have the same restrictions as iconUrl.

• isClickable

  boolean optional
  Deprecated 67+

  This UI hint is ignored as of Chrome 67

• items

  NotificationItem[] optional

  Items for multi-item notifications. Users on Mac OS X only see the first item.

• message

  string optional

  Main notification content. Required for notifications.create method.

• priority

  number optional

  Priority ranges from -2 to 2. -2 is lowest priority. 2 is highest. Zero is default. On platforms that don't support a notification center (Windows, Linux & Mac), -2 and -1 result in an error as notifications with those priorities will not be shown at all.

• progress

  number optional

  Current progress ranges from 0 to 100.

• requireInteraction

  boolean optional

  Indicates that the notification should remain visible on screen until the user activates or dismisses the notification. This defaults to false.

• silent

  boolean optional
  Chrome 70+

  Indicates that no sounds or vibrations should be made when the notification is being shown. This defaults to false.

• title

  string optional

  Title of the notification (e.g. sender name for email). Required for notifications.create method.

• type

  TemplateType optional

  Which type of notification to display. Required for notifications.create method.

Enum

Enum

Parameters

• notificationId

  string

  The id of the notification to be cleared. This is returned by notifications.create method.

• callback

  function optional

  Called to indicate whether a matching notification existed.

  The callback is required before Chrome 42.

  If you specify the parameter, it should be a function that looks like this:

  (wasCleared: boolean) => {...}
  • wasCleared

    boolean

Parameters

• notificationId

  string optional

  Identifier of the notification. If not set or empty, an ID will automatically be generated. If it matches an existing notification, this method first clears that notification before proceeding with the create operation. The identifier may not be longer than 500 characters.

  The notificationId parameter is required before Chrome 42.

• options

  NotificationOptions

  Contents of the notification.

• callback

  function optional

  Returns the notification id (either supplied or generated) that represents the created notification.

  The callback is required before Chrome 42.

  If you specify the parameter, it should be a function that looks like this:

  (notificationId: string) => {...}
  • notificationId

    string

Parameters

• callback

  function

  Returns the set of notification_ids currently in the system.

  The parameter should be a function that looks like this:

  (notifications: object) => {...}
  • notifications

    object

Parameters

• callback

  function

  Returns the current permission level.

  The parameter should be a function that looks like this:

  (level: PermissionLevel) => {...}
  • level

    PermissionLevel

Parameters

• notificationId

  string

  The id of the notification to be updated. This is returned by notifications.create method.

• options

  NotificationOptions

  Contents of the notification to update to.

• callback

  function optional

  Called to indicate whether a matching notification existed.

  The callback is required before Chrome 42.

  If you specify the parameter, it should be a function that looks like this:

  (wasUpdated: boolean) => {...}
  • wasUpdated

    boolean

Event

• listener

  function

  The listener parameter should be a function that looks like this:

  (notificationId: string, buttonIndex: number) => {...}
  • notificationId

    string
  • buttonIndex

    number

Event

• listener

  function

  The listener parameter should be a function that looks like this:

  (notificationId: string) => {...}
  • notificationId

    string

Event

• listener

  function

  The listener parameter should be a function that looks like this:

  (notificationId: string, byUser: boolean) => {...}
  • notificationId

    string
  • byUser

    boolean

Event

• listener

  function

  The listener parameter should be a function that looks like this:

  (level: PermissionLevel) => {...}
  • level

    PermissionLevel

Event

• listener

  function

  The listener parameter should be a function that looks like this:

  () => {...}