electron/docs/api/notification.md

Notification

Create OS desktop notifications

Process: Main

Using in the renderer process

If you want to use Notifications in a renderer process you should use the HTML5 Notification API

Class: Notification

Create OS desktop notifications

Process: Main

Notification is an EventEmitter.

It creates a new Notification with native properties as set by the options.

new Notification([options]) Experimental

• options Object
  • title String - A title for the notification, which will be shown at the top of the notification window when it is shown
  • body String - The body text of the notification, which will be displayed below the title
  • silent Boolean - (Optional) Whether or not to emit an OS notification noise when showing the notification
  • icon NativeImage - (Optional) An icon to use in the notification
  • hasReply Boolean - (Optional) Whether or not to add an inline reply option to the notification. macOS
  • replyPlaceholder String - (Optional) The placeholder to write in the inline reply input field. macOS

Instance Events

Objects created with new Notification emit the following events:

Note: Some events are only available on specific operating systems and are labeled as such.

Event: 'click'

Returns:

• event Event

Emitted when the document changed its title, calling event.preventDefault() will prevent the native window's title from changing.

Event: 'close'

Returns:

• event Event

Emitted when the notification is shown to the user, note this could be fired multiple times as a notification can be shown multiple times through the show() method.

Event: 'click'

Returns:

• event Event

Emitted when the notification is clicked by the user.

Event: 'reply' macOS

Returns:

• event Event
• reply String - The string the user entered into the inline reply field

Emitted when the user clicks the "Reply" button on a notification with hasReply: true.

Instance Methods

Objects created with new Notification have the following instance methods:

notification.show()

Immediately shows the notification to the user, please note this means unlike the HTML5 Notification implementation, simply instantiating a new Notification does not immediately show it to the user, you need to call this method before the OS will display it.