Intent to Remove: PushSubscription.subscriptionId and "gcm_user_visible_only" in the Manifest

358 views
Skip to first unread message

Peter Beverloo

unread,
May 27, 2015, 11:48:49 AM5/27/15
to blink-dev
Primary eng (and PM) emails

Link to “Intent to Deprecate” thread

Summary
- Removes support for PushSubscription.subscriptionId. This is now included in PushSubscription.endpoint.
- Removes support for the "gcm_user_visible_only" Manifest key. This can now be set using PushSubscriptionOptions.

Both deprecations and intended removal timelines were included in these Intents.

Motivation
- Separate subscriptionId and endpoints are not well compatible with the IETF Web Push protocol. Mozilla will only ship the endpoint.
- The "gcm_user_visible_only" was a proprietary manifest extension, which can now be satisfied using the PushSubscriptionOptions dictionary in calls to subscribe() and checkPermission().

Usage information from UseCounter
There is a PushSubscriptionId deprecation UMA, added in Chrome 44, but the number of samples is too insignificant to draw conclusions from (it shows up as 0%).

Entry on the feature dashboard

I will update the entries to include the removal once this Intent has been approved.

Compatibility Risk
Medium. Consumers of the Push API will have to update their implementation.

Prior to Chrome 44, implementations had to use subscriptionId and the "gcm_user_visible_only" manifest key.

In Chrome 44, implementations should only be using the endpoint, but the subscriptionId was still exposed. Both the "gcm_user_visible_only" and PushSubscriptionOptions mechanisms are supported.

In Chrome 45, we intent to only support the endpoint and PushSubscriptionOptions dictionary.

The canonical article on Push Messaging on HTML5Rocks has already been updated accordingly:

Chris Harrelson

unread,
May 27, 2015, 5:15:00 PM5/27/15
to Peter Beverloo, blink-dev
LGTM

To unsubscribe from this group and stop receiving emails from it, send an email to blink-dev+...@chromium.org.

Philip Jägenstedt

unread,
May 27, 2015, 6:08:06 PM5/27/15
to Chris Harrelson, Peter Beverloo, blink-dev
LGTM2

TAMURA, Kent

unread,
May 29, 2015, 4:44:44 AM5/29/15
to Philip Jägenstedt, Chris Harrelson, Peter Beverloo, blink-dev
LGTM3

--
TAMURA Kent
Software Engineer, Google


Reply all
Reply to author
Forward
0 new messages