このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

PermissionStatus

Baseline 広く利用可能 *

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2022年9月以降、すべてのブラウザーで利用可能です。

* この機能の一部は、対応レベルが異なる場合があります。

メモ: この機能はウェブワーカー内で利用可能です。

PermissionStatus権限 API のインターフェイスで、オブジェクトの状態と、その状態の変化を監視するためのイベントハンドラーを提供します。

EventTarget PermissionStatus

インスタンスプロパティ

PermissionStatus.name 読取専用

要求された権限の名前を返します。Permissions.query に渡された name と同じです。

PermissionStatus.state 読取専用

要求された権限の状態を返します。 'granted'(許可)、'denied'(拒否)、'prompt'(プロンプト)のいずれかです。

イベントハンドラー

change

PermissionStatus.state 変化するたびに発行されるイベントです。

js
navigator.permissions
  .query({ name: "geolocation" })
  .then((permissionStatus) => {
    console.log(`位置情報の権限の状態は ${permissionStatus.state} です。`);
    permissionStatus.onchange = () => {
      console.log(
        `位置情報の権限の状態が ${permissionStatus.state} に変更されました。`,
      );
    };
  });

仕様書

仕様書
Permissions
# permissionstatus-interface

ブラウザーの互換性