Skip to content

Iterate on activation design #434

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
martinthomson wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Iterate on activation design #434

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
41 changes: 17 additions & 24 deletions api.bs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1306,34 +1306,25 @@ temporarily makes the API available.
A number of differences distinguish this design
from [=transient activation-consuming APIs=]:

* Any [=activation triggering input event|user activation=]
makes the Attribution API available for a short period.
* The API becomes available for a short period when either:

* Additionally, when [=navigate|navigation=] is initiated
by a user
(that is, where the [=user navigation involvement=] is "browser UI"),
the Attribution API is available for a short period.
* A [=activation triggering input event|user activation event=] is received
(that is, a click, keypress, or similar action).

* The first attempt to access the API by invoking
either <a for=Attribution>saveImpression()</a>
or <a for=Attribution>measureConversion()</a>
within an [=implementation-defined=] duration of the last activation,
enables the API for that site.
* [=navigate|Navigation=] is initiated by a user
(that is, where the [=user navigation involvement=] is "browser UI").

* Each activation makes the API available to at most one site.
Similar to [=transient activation=],
where [=transient activation-consuming API|consuming the activation=]
causes other similar APIs to be unavailable
until another activation occurs,
using the API on one site makes the API unavailable to other sites.

* When the API is successfully used,
the API is enabled for use by all [=descendent navigables=]
* Invoking either <a for=Attribution>saveImpression()</a>
or <a for=Attribution>measureConversion()</a>
while the API is available
enables the API for that [=site=].
All [=descendent navigables=]
of the [=top-level traversable=]'s [=active document=]
(that is, all frames on the current page)
until the next cross-site navigation.
can access the API without further availability checks.

* Any [=navigate|navigation=] of the [=top-level traversable=]
* Each activation makes the API available to at most one site.
Any [=navigate|navigation=] of the [=top-level traversable=]
to a different [=site=] disables the API.
However, any [=activation triggering input event|activation=],
which might include the action that initiated the navigation,
Expand Down Expand Up @@ -1386,9 +1377,9 @@ do not cause the Attribution API to become inaccessible.

<p class=note>
Implementations might choose to extend the time allowed
to account for the delays involved in page loading time.
to account for the delays involved in loading page content during navigation.
A fixed value might not account for performance differences
in devices or in the network they use.
in devices or in the network.
Implementations could extend the value of [=attribution activation duration=]
based on an understanding of performance chararacteristics.
Alternatively, an implementation might suspend any timer
Expand Down Expand Up @@ -1452,6 +1443,8 @@ throwing a {{"NotAllowedError"}} {{DOMException}} on failure:
is less than the [=current high resolution time=],
throw a {{"NotAllowedError"}} {{DOMException}}.

1. Set [=attribution activation timestamp=] to the [=unix epoch=].

1. Set |top|'s [=attribution enabled flag=] to true.

</div>
Expand Down
Loading