stelcheck / electron-notifications Goto Github PK

A node module for sending notifications in electron applications.

const notifier = require('electron-notifications')

// Just title
notifier.notify('Calendar')

// Full Options
notifier.notify('Calendar', {
  message: 'Event begins in 10 minutes',
  icon: 'http://cl.ly/J49B/3951818241085781941.png',
  buttons: ['Dismiss', 'Snooze'],
})

npm install --save electron-notifications

When you create a new notification, your notification is queued, since we only display one at a time. Each notification is a BrowserWindow instance, so it's completely cross platform.

All options are optional.

• message: A message to display under the title.
• icon: The absolute URL of a icon displayed to the left of the text.
• buttons: One or two buttons to display on the right of the notification.

In addition to the events provided by electron you also have access to the following 3 additional events.

When the notification was clicked, but not dragged. This usually does the default action, or closes the notification.

const notification = notifier.notify('Calendar')

notification.on('clicked', () => {
  notification.close()
})

When the notification has been swiped to the right. This usually indiciated the user wants to dismiss the notification.

const notification = notifier.notify('Calendar')

notification.on('swipedRight', () => {
  notification.close()
})

When any one of the buttons are clicked, it'll trigger a buttonClicked event, and pass the text that was clicked to the handler.

const notification = notifier.notify('Calendar', {
  buttons: ['Dismiss', 'Snooze'],
})

notification.on('buttonClicked', (text) => {
  if (text === 'Snooze') {
    // Snooze!
  }
  notification.close()
})