Skip to content

Commit c5b38d2

Browse files
christianliebelmarcoscaceresdmurph
authored
Clarify applying manifest to an existing browsing context (#1202)
When a UA applies a manifest to an existing top-level browsing context (e.g. immediately after installation), the spec now normatively covers both cases: in-scope (context becomes an application context) and out-of-scope (behavior is implementation-defined). Closes #784 --------- Co-authored-by: Marcos Caceres <caceres_m@apple.com> Co-authored-by: Marcos Cáceres <marcos@marcosc.com> Co-authored-by: Daniel Murphy <294026+dmurph@users.noreply.github.com>
1 parent 6731c8c commit c5b38d2

1 file changed

Lines changed: 19 additions & 0 deletions

File tree

index.html

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1811,6 +1811,25 @@ <h3 id="applying">
18111811
[=top-level browsing context=] is created, the user agent MAY
18121812
[=apply=] a manifest to it before [=navigate|navigation=] begins.
18131813
</p>
1814+
<p>
1815+
A user agent MAY also [=apply=] a manifest to an existing [=top-level
1816+
browsing context=]. If the [=navigable/active document=]'s
1817+
[=Document/URL=] is [=manifest/within scope=] of the manifest, the
1818+
existing [=top-level browsing context=] becomes an [=application
1819+
context=]. If the [=Document/URL=] is not [=manifest/within scope=],
1820+
the resulting behavior is implementation-defined.
1821+
</p>
1822+
<aside class="note">
1823+
<p>
1824+
Some user agents might [=apply=] a manifest to the existing
1825+
[=top-level browsing context=] from which installation was
1826+
initiated. If the [=navigable/active document=]'s [=Document/URL=]
1827+
is not [=manifest/within scope=] of the manifest's
1828+
[=manifest/navigation scope=], one possible behavior is that the
1829+
[=application context=] initially exists at an out-of-scope
1830+
[=Document/URL=].
1831+
</p>
1832+
</aside>
18141833
<aside class="note">
18151834
Whether to [=apply=] a manifest, and which manifest to apply, is at
18161835
the discretion of the user agent, based on the user's actions. For

0 commit comments

Comments
 (0)