PushManager: permissionState() method

Baseline 2023

Newly available

Since March 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

Note: This feature is available in Web Workers.

The permissionState() method of the PushManager interface returns a Promise that resolves to a string indicating the permission state of the push manager. Possible values are 'prompt', 'denied', or 'granted'.

Note: As of Firefox 44, the permissions for Notifications and Push have been merged. If permission is granted for notifications, push will also be enabled.

Syntax

js
permissionState()
permissionState(options)

Parameters

options Optional

An object containing optional configuration parameters. It can have the following properties:

userVisibleOnly

A boolean indicating that the returned push subscription will only be used for messages whose effect is made visible to the user.

applicationServerKey

A public key your push server will use to send messages to client apps via a push server. This value is part of a signing key pair generated by your application server and usable with elliptic curve digital signature (ECDSA) over the P-256 curve.

Return value

A Promise that resolves to a string with a value of 'prompt', 'denied', or 'granted'.

Specifications

Specification
Push API
# dom-pushmanager-permissionstate

Browser compatibility

BCD tables only load in the browser