2.5 KiB
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])
options
Objecttitle
String - A title for the notification, which will be shown at the top of the notification window when it is shownbody
String - The body text of the notification, which will be displayed below the titlesilent
Boolean - (Optional) Whether or not to emit an OS notification noise when showing the notificationicon
NativeImage - (Optional) An icon to use in the notificationhasReply
Boolean - (Optional) Whether or not to add an inline reply option to the notification. macOSreplyPlaceholder
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
Eventreply
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.