Deprecated
This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.
The registrations
method is used to ask the system about existing push endpoint registrations.
Syntax
var request = navigator.push.registrations();
Return
A DOMRequest
object to handle the success or failure of the method call.
If the method call is successful, the request's result
will be an array of PushRegistration objects.
PushRegistration
Those objects are anonymous JavaScript objects with the following properties:
pushEndpoint
- A string representing the URL of the endpoint.
version
- The current version that the push endpoint is at.
Example
var req = navigator.push.registrations(); req.onsuccess = function(e) { if (req.result.length > 0) { for (var i = 0, l = req.result.length; i < l; i++) { console.log("Existing registration", req.result[i].pushEndpoint, req.result[i].version); } // Reuse existing endpoints. } else { // Register for a new endpoint. var register = navigator.push.register(); register.onsuccess = function(e) { console.log("Registered new endpoint", register.result); } } }
Specification
Specification | Status | Comment |
---|---|---|
Push API | Working Draft | Defines the PushManager interface. |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
registrations | Chrome Full support 42 | Edge
Full support
16
| Firefox
Full support
44
| IE No support No | Opera Full support 29 | Safari No support No | WebView Android No support No | Chrome Android Full support 42 | Firefox Android
Full support
48
| Opera Android Full support 29 | Safari iOS No support No | Samsung Internet Android Full support 4.0 |
Legend
- Full support
- Full support
- No support
- No support
- Experimental. Expect behavior to change in the future.
- Experimental. Expect behavior to change in the future.
- See implementation notes.
- See implementation notes.
- User must explicitly enable this feature.
- User must explicitly enable this feature.