Skip to main content

notifications

Request permission and show desktop notifications via the Notifications API.

Import: @rtorcato/browser-common/notifications

📖 MDN: Notifications API · 📊 caniuse: notifications

Needs a secure context and user permission (requestNotificationPermission).

Example​

import { isNotificationAvailable, notifyIfPermitted } from '@rtorcato/browser-common/notifications'

button.addEventListener('click', async () => {
  if (isNotificationAvailable()) {
    await notifyIfPermitted('Done', { body: 'Upload complete' })
  }
})

Exports​

  • isNotificationAvailable() — feature check
  • requestNotificationPermission() — asks the user for notification permission
  • showNotification(title, options?) — shows a notification if permission is already granted
  • notifyIfPermitted(title, options?) — requests permission if needed, then shows a notification

See the API reference for full signatures.