Skip to content

Commit

Permalink
Merge branch 'gh-pages' into transient
Browse files Browse the repository at this point in the history
  • Loading branch information
@marcoscaceres
marcoscaceres committed Aug 9, 2022
2 parents 4ab0fb4 + febe56b commit da81596
Show file tree
Hide file tree
Showing 3 changed files with 104 additions and 56 deletions.
2 changes: 1 addition & 1 deletion .github/PULL_REQUEST_TEMPLATE.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -8,4 +8,4 @@ Implementation commitment:

* [ ] Chromium (https://bugs.chromium.org/p/chromium/issues/detail?id=)
* [ ] Gecko (https://bugzilla.mozilla.org/show_bug.cgi?id=)
* WebKit - not implemented.
* [ ] WebKit (https://bugs.webkit.org/show_bug.cgi?id=)
4 changes: 2 additions & 2 deletions .github/workflows/tidy.yml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,6 @@ jobs:
- run: tidy -config tidyconf.txt -o index.html index.html
- uses: peter-evans/create-pull-request@v3
with:
title: "chore(tidy): tidy up document"
commit-message: "Tidied up document using tidy-html5"
title: "Tidied up document using tidy-html5"
commit-message: "chore(tidy): tidy up document"
branch: html-tidy
154 changes: 101 additions & 53 deletions index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,12 @@
companyURL: "https://www.mozilla.org/",
w3cid: "68503"
},
{
name: "Marcos Caceres",
company: "Apple Inc.",
companyURL: "https://www.apple.com/",
w3cid: "39125"
},
{
name: "Bryan Sullivan",
company: "AT&T",
Expand Down Expand Up @@ -195,13 +201,17 @@ <h2>
subscription</a> having the new keys as |newSubscription|.
</p>
<p>
To <dfn>create a push subscription</dfn>, given an <a>PushSubscriptionOptions</a> object
of |options|, the <a>user agent</a> must run the following steps:
To <dfn>create a push subscription</dfn>, given an {{PushSubscriptionOptionsInit}}
|optionsDictionary:PushSubscriptionOptionsInit|:
</p>
<ol>
<li>Let |subscription| be a new <a>push subscription</a>.
<ol class="algorithm">
<li>Let |subscription:PushSubscription| be a new {{PushSubscription}}.
</li>
<li>Let |options:PushSubscriptionOptions| be a newly created {{PushSubscriptionOptions}}
object, initializing its attributes with the corresponding members and values of
|optionsDictionary|.
</li>
<li>Set the `options` attribute of |subscription| to be a copy of |options|.
<li>Set |subscription|'s {{PushSubscription/options}} attribute to |options|.
</li>
<li>Generate a new P-256 <a>ECDH</a> key pair [[ANSI-X9-62]]. Store the private key in an
internal slot on |subscription|; this value MUST NOT be made available to applications.
Expand All @@ -214,11 +224,21 @@ <h2>
key can be retrieved by calling the {{PushSubscription/getKey()}} method of the
{{PushSubscription}} with an argument of {{PushEncryptionKeyName/"auth"}}.
</li>
<li>Make a request to the <a>push service</a> to create a new <a>push subscription</a>.
Include the {{PushSubscriptionOptions/applicationServerKey}} attribute of |options| when
it has been set.
<li>Request a new <a>push subscription</a>. Include the
{{PushSubscriptionOptions/applicationServerKey}} attribute of |options| when it has been
set. Rethrow any [=exceptions=].
</li>
<li>When the request has completed, return |subscription|.
<li>When the <a>push subscription</a> request has completed successfully:
<ol>
<li>Set |subscription|'s {{PushSubscription/endpoint}} attribute to the [=URL=]
provided by the <a>push subscription</a>.
</li>
<li>If provided by the <a>push subscription</a>, set |subscription|'s
{{PushSubscription/expirationTime}}.
</li>
</ol>
</li>
<li>Return |subscription|.
</li>
</ol>
<section>
Expand Down Expand Up @@ -548,81 +568,109 @@ <h2>
MAY support content codings defined in previous versions of the draft for compatibility
reasons.
</p>
<h3>
`subscribe()` method
</h3>
<p>
The <dfn>subscribe</dfn> method when invoked MUST run the following steps:
The <dfn>subscribe()</dfn> method when invoked MUST run the following steps:
</p>
<ol>
<ol class="algorithm">
<li>If the [=relevant global object=] of [=this=] does not have [=transient activation=],
return [=a promise rejected with=] with a {{"NotAllowedError"}} {{DOMException}}.
</li>
<li>[=Consume user activation=] of [=this=]'s [=relevant global object=].
</li>
<li>Let |promise| be <a>a new promise</a>.
</li>
<li>Return |promise| and continue the following steps asynchronously.
<li>Let |global| be [=this=]' [=relevant global object=].
</li>
<li>If the <a>current settings object</a> is not a [=secure context=], reject |promise|
with a {{DOMException}} whose name is {{"SecurityError"}} and terminate these steps.
<li>Return |promise| and continue [=in parallel=].
<aside class="note" title="Validation order can vary across user agents">
<p>
Because of implementation-specific reasons, user agents are known to do some of the
following checks in different order (e.g., some check if
{{PushSubscriptionOptionsInit/userVisibleOnly}} is allowed after validating the
{{PushSubscriptionOptionsInit/applicationServerKey}}, and vice versa). However, we
don't believe this affects interoperability of implementations or web applications.
</p>
</aside>
</li>
<li>If the |options| argument has a {{PushSubscriptionOptionsInit/userVisibleOnly}} value
set to `false` and the user agent requires it to be `true`, [=queue a global task=] on the
[=networking task source=] using |global| to [=reject=] |promise| {{"NotAllowedError"}}
{{DOMException}}
</li>
<li>If the |options| argument does not include a non-null value for the
{{PushSubscriptionOptionsInit/applicationServerKey}} member, and the <a>push service</a>
requires one to be given, [=queue a global task=] on the [=networking task source=] using
|global| to [=reject=] |promise| with a {{"NotSupportedError"}} {{DOMException}}.
</li>
<li>If the |options| argument includes a non-null value for the
{{PushSubscriptionOptions/applicationServerKey}} attribute, run the following sub-steps:
<ol>
<li>If the |applicationServerKey| is provided as a {{DOMString}}, set its value to an
{{ArrayBuffer}} containing the sequence of octets that result from decoding
|applicationServerKey| using the base64url encoding [[RFC7515]]. If decoding fails,
reject promise with a {{DOMException}} whose name is {{"InvalidCharacterError"}} and
terminate these steps.
<li>If |options|'s {{PushSubscriptionOptionsInit/applicationServerKey}} is a
{{DOMString}}, set its value to an {{ArrayBuffer}} containing the sequence of octets
that result from decoding |options|'s
{{PushSubscriptionOptionsInit/applicationServerKey}} using the base64url encoding
[[RFC7515]].
</li>
<li>If decoding fails, [=queue a global task=] on the [=networking task source=] using
|global| to [=reject=] |promise| with an {{"InvalidCharacterError"}} {{DOMException}}
and terminate these steps.
</li>
<li>Ensure that |applicationServerKey| describes a valid point on the P-256 curve. If
the |applicationServerKey| value is invalid, reject |promise| with a {{DOMException}}
whose name is {{"InvalidAccessError"}} and terminate these steps.
<li>Ensure that |options|'s {{PushSubscriptionOptionsInit/applicationServerKey}}
describes a valid point on the P-256 curve. If its value is invalid, [=queue a global
task=] on the [=networking task source=] using |global| to [=reject=] |promise| with an
{{"InvalidAccessError"}} {{DOMException}} and terminate these steps.
</li>
</ol>
</li>
<li>If the |options| argument does not include a non-null value for the
{{PushSubscriptionOptions/applicationServerKey}} attribute, and the <a>push service</a>
requires one to be given, reject |promise| with a {{DOMException}} whose name is
{{"NotSupportedError"}} and terminate these steps.
</li>
<li>Let |registration| be the {{PushManager}}'s associated <a>service worker
<li>Let |registration:ServiceWorkerRegistration| be [=this=]'s associated <a>service worker
registration</a>.
</li>
<li>If |registration|'s [=service worker registration/active worker=] is null, reject
|promise| with a {{DOMException}} whose name is {{"InvalidStateError"}} and terminate these
steps.
<li>If |registration|'s [=service worker registration/active worker=] is null, [=queue a
global task=] on the [=networking task source=] using |global| to [=reject=] |promise| with
an {{"InvalidStateError"}} {{DOMException}} and terminate these steps.
</li>
<li>Let |sw| be |registration|'s [=service worker registration/active worker=].
</li>
<li>Let |permission| be [=request permission to use=] "push".
</li>
<li>If |permission| is "denied", reject |promise| with a {{DOMException}} whose name is
{{"NotAllowedError"}} and terminate these steps.
<li>If |permission| is {{PermissionState/"denied"}}, [=queue a global task=] on the [=user
interaction task source=] using |global| to [=reject=] |promise| with a
{{"NotAllowedError"}} {{DOMException}} and terminate these steps.
</li>
<li>If the <a>Service Worker</a> is already subscribed, run the following substeps:
<li>If |sw| is already subscribed, run the following sub-steps:
<ol>
<li>Retrieve the <a>push subscription</a> associated with the <a>Service Worker</a>.
<li>Try to retrieve the <a>push subscription</a> associated with the |sw|. If there is
an error, [=queue a global task=] on the [=networking task source=] using |global| to
[=reject=] |promise| with an {{"AbortError"}} {{DOMException}} and terminate these
steps.
</li>
<li>If there is an error, reject |promise| with a {{DOMException}} whose name is
{{"AbortError"}} and terminate these steps.
<li>Let |subscription| be the <a>push subscription</a> associated with |sw|.
</li>
<li>Let |subscription| be the retrieved subscription.
<li>Compare the |options| argument with the `options` attribute of |subscription|. The
contents of {{BufferSource}} values are compared for equality rather than
[=ECMAScript/reference record|reference=].
</li>
<li>Compare the |options| argument with the `options` attribute of |subscription|. If
any attribute on |options| contains a different value to that stored for
|subscription|, then reject |promise| with an {{InvalidStateError}} and terminate these
steps. The contents of {{BufferSource}} values are compared for equality rather than
<a href=
"https://tc39.github.io/ecma262/#sec-reference-specification-type">references</a>.
<li>If any attribute on |options| contains a different value to that stored for
|subscription|, then [=queue a global task=] on the [=networking task source=] using
|global| to [=reject=] |promise| with an {{"InvalidStateError"}} {{DOMException}} and
terminate these steps.
</li>
<li>When the request has been completed, resolve |promise| with |subscription|.
<li>When the request has been completed, [=queue a global task=] on the [=networking
task source=] using |global| to [=resolve=] |promise| with |subscription| and terminate
these steps.
</li>
</ol>
</li>
<li>Let |subscription| be the result of running the <a>create a push subscription</a> steps
given |options|.
</li>
<li>If there is an error, reject |promise| with a {{DOMException}} whose name is
{{"AbortError"}} and terminate these steps.
<li>Let |subscription| be the result of trying to [=create a push subscription=] with
|options|. If creating the subscription [=exception/throws=] an [=exception=], [=queue a
global task=] on the [=networking task source=] using |global| to [=reject=] |promise| with
a that [=exception=] and terminate these these steps.
</li>
<li>Resolve |promise| with a {{PushSubscription}} providing the details of the new
<li>Otherwise, [=queue a global task=] on the [=networking task source=] using |global| to
[=resolve=] |promise| with a {{PushSubscription}} providing the details of the new
|subscription|.
</li>
</ol>
Expand Down Expand Up @@ -939,8 +987,8 @@ <h2>
};
</pre>
<p>
<a>PushMessageData</a> objects have an associated <dfn>bytes</dfn> (a byte sequence) set on
creation, which is `null` if there was no data in the <a>push message</a>.
<a>PushMessageData</a> objects have an associated [=byte sequence=] set on creation, which
is `null` if there was no data in the <a>push message</a>.
</p>
<p>
The <dfn>arrayBuffer()</dfn> method, when invoked, MUST return an {{ArrayBuffer}} whose
Expand Down

0 comments on commit da81596

Please sign in to comment.