PermissionStatus

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2022.

* Some parts of this feature may have varying levels of support.

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

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} に変更されました。`,
      );
    };
  });

仕様書

Specification
Permissions
# permissionstatus-interface

ブラウザーの互換性

BCD tables only load in the browser