Notification.permission

Notificationインターフェースのpermission読み取り専用プロパティは、現在のオリジンに対してWeb通知を表示してよいか、ユーザーによって与えれた許可を表します。

構文

var permission = Notification.permission;

値

現在の許可を表すDOMStringです。以下の値が可能です。

• granted: ユーザーは現在のオリジンがシステム通知を表示することを明示的な許可を与えている。
• denied: ユーザーは現在のオリジンがシステム通知を表示することを明示的に拒否している。
• default: ユーザーの決定は分からない。この場合、アプリケーションは許可が拒否されたかのように実行するだろう。

例

次の冗長で完全なコードセットでは、はじめに通知がサポートされているかチェックした後、現在のオリジンが通知を送る許可が与えられているか確認し、その後通知を送る前に必要ならば、許可を要求します。

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
    var notification = new Notification("Hi there!");
  }

  // Otherwise, we need to ask the user for permission
  else if (Notification.permission !== 'denied') {
    Notification.requestPermission(function (permission) {
      // If the user accepts, let's create a notification
      if (permission === "granted") {
        var 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.
}

仕様

ブラウザ実装状況

Firefox OS notes

Chrome notes

Safari notes

関連項目

• Using the Notifications API
• Permissions API