Notification.permission

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Note : Cette fonctionnalité est disponible via les Web Workers.

Contexte sécurisé: Cette fonctionnalité est uniquement disponible dans des contextes sécurisés (HTTPS), pour certains navigateurs qui la prennent en charge.

La propriété en lecture seule permission de l'interface Notification indique l'autorisation actuelle accordée par l'utilisateur à l'origine actuelle pour afficher des notifications.

Syntaxe

js
Notification.permission;

Valeur

Une DOMString représentant l'autorisation actuelle. La valeur peut être:

  • granted: L'utilisateur a explicitement accordé l'autorisation à l'origine actuelle d'afficher les notifications système.
  • denied: L'utilisateur a explicitement refusé l'autorisation pour l'origine actuelle d'afficher les notifications système.
  • default: La décision de l'utilisateur est inconnue; dans ce cas, l'application agira comme si l'autorisation était denied.

Exemples

L'extrait suivant peut être utilisé si vous souhaitez d'abord vérifier si les notifications sont prises en charge, puis vérifier si l'autorisation a été accordée pour l'origine actuelle pour envoyer des notifications, puis demander l'autorisation si nécessaire, avant d'envoyer une notification.

js
function notifyMe() {
  // Let's check if the browser supports notifications
  if (!("Notification" in window)) {
    console.log("This browser does not support desktop notification");
  }

  // Let's check whether notification permissions have alredy been granted
  else if (Notification.permission === "granted") {
    // If it's okay let's create a notification
    const notification = new Notification("Hi there!");
  }

  // Otherwise, we need to ask the user for permission
  else if (
    Notification.permission !== "denied" ||
    Notification.permission === "default"
  ) {
    Notification.requestPermission((permission) => {
      // If the user accepts, let's create a notification
      if (permission === "granted") {
        const notification = new Notification("Hi there!");
      }
    });
  }

  // At last, if the user has denied notifications, and you
  // want to be respectful there is no need to bother them any more.
}

Spécifications

Specification
Notifications API
# dom-notification-permission

Compatibilité des navigateurs

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
permission static property

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
No support
No support
See implementation notes.

Voir aussi