W3cubDocs

/Web APIs

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

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

	Desktop					Mobile
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet	WebView Android	WebView on iOS
`permissionState`	44	17	44	31	16 Notifications are supported on macOS Ventura and later.	44	48	32	16.4 Notifications are supported in web apps saved to the home screen.	4.0	No	No Notifications are supported in web apps saved to the home screen.

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/PushManager/permissionState