Skip to content

Commit 4f76aa2

Browse files
jalonthomasgithub-actions[bot]
jalonthomas
and
github-actions[bot]
committed
Use embeddedOrigin instead of topLevelOrigin (#469)
SHA: 054e127 Reason: push, by miketaylr Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
1 parent 665f1bf commit 4f76aa2

File tree

1 file changed

+19
-19
lines changed

1 file changed

+19
-19
lines changed

‎index.html‎

Lines changed: 19 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -168,7 +168,7 @@
168168
.mdn .samsunginternet_android::before{background-image:url(https://www.w3.org/assets/logos/browser-logos/samsung-internet/samsung-internet.svg)}
169169
.mdn .webview_android::before{background-image:url(https://www.w3.org/assets/logos/browser-logos/android-webview/android-webview.png)}
170170
</style>
171-
<meta name="revision" content="a867a0e98ff599bfcf5204b944596a56b2044f11">
171+
<meta name="revision" content="054e127f899d25153f3f273091965c434575ddde">
172172
<meta name="description" content="This specification defines common infrastructure that other specifications can use to
173173
interact with browser permissions. These permissions represent a user's choice to allow or
174174
deny access to &quot;powerful features&quot; of the platform. For developers, the specification
@@ -262,9 +262,9 @@
262262
]
263263
},
264264
"caniuse": "permissions-api",
265-
"gitRevision": "a867a0e98ff599bfcf5204b944596a56b2044f11",
266-
"publishISODate": "2025-09-26T00:00:00.000Z",
267-
"generatedSubtitle": "W3C Editor's Draft 26 September 2025"
265+
"gitRevision": "054e127f899d25153f3f273091965c434575ddde",
266+
"publishISODate": "2025-10-03T00:00:00.000Z",
267+
"generatedSubtitle": "W3C Editor's Draft 03 October 2025"
268268
}</script>
269269
<link rel="stylesheet" href="https://www.w3.org/StyleSheets/TR/2021/W3C-ED"></head>
270270
<body class="h-entry" data-cite="WEBIDL permissions-policy w3c-process HTML INFRA URL WEBIDL DOM FETCH"><div class="head">
@@ -273,7 +273,7 @@
273273
<h1 id="title" class="title">Permissions</h1> <h2 id="subtitle" class="subtitle">
274274
Interacting with Permissions for Powerful Features
275275
</h2>
276-
<p id="w3c-state"><a href="https://www.w3.org/standards/types#ED">W3C Editor's Draft</a> <time class="dt-published" datetime="2025-09-26">26 September 2025</time></p>
276+
<p id="w3c-state"><a href="https://www.w3.org/standards/types#ED">W3C Editor's Draft</a> <time class="dt-published" datetime="2025-10-03">03 October 2025</time></p>
277277
<details open="">
278278
<summary>More details about this document</summary>
279279
<dl>
@@ -1025,16 +1025,16 @@ <h1 id="title" class="title">Permissions</h1> <h2 id="subtitle" class="subtitle"
10251025
</dt>
10261026
<dd>
10271027
<p>
1028-
Takes an <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/browsers.html#concept-origin">origin</a> <var>origin</var> and an <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/browsers.html#concept-origin">origin</a> <var>top level origin</var>, and returns a new
1028+
Takes an <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/browsers.html#concept-origin">origin</a> <var>origin</var> and an <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/browsers.html#concept-origin">origin</a> <var>embedded origin</var>, and returns a new
10291029
<a data-link-type="dfn|abstract-op" href="#dfn-permission-key" class="internalDFN" id="ref-for-dfn-permission-key-8">permission key</a>. If unspecified, this defaults to the <a data-link-type="dfn|abstract-op" href="#dfn-default-permission-key-generation-algorithm" class="internalDFN" id="ref-for-dfn-default-permission-key-generation-algorithm-1">default permission key generation algorithm</a>. A feature that specifies a custom <a data-link-type="dfn|abstract-op" href="#dfn-permission-key-generation-algorithm" class="internalDFN" id="ref-for-dfn-permission-key-generation-algorithm-2">permission key generation algorithm</a> <em class="rfc2119">MUST</em> also specify a <a data-link-type="dfn|abstract-op" href="#dfn-permission-key-comparison-algorithm" class="internalDFN" id="ref-for-dfn-permission-key-comparison-algorithm-2">permission key comparison algorithm</a>.
10301030
</p>
10311031
<div class="algorithm">
10321032
<p>
10331033
The <dfn class="export" data-export="" id="dfn-default-permission-key-generation-algorithm" tabindex="0" aria-haspopup="dialog" data-dfn-type="dfn">default permission key generation algorithm</dfn>, given an
1034-
<a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/browsers.html#concept-origin">origin</a> <var>origin</var> and an <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/browsers.html#concept-origin">origin</a> <var>top level origin</var>, runs the following steps:
1034+
<a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/browsers.html#concept-origin">origin</a> <var>origin</var> and an <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/browsers.html#concept-origin">origin</a> <var>embedded origin</var>, runs the following steps:
10351035
</p>
10361036
<ol>
1037-
<li>Return <var>top level origin</var>.
1037+
<li>Return <var>origin</var>.
10381038
</li>
10391039
</ol>
10401040
</div>
@@ -1191,8 +1191,8 @@ <h1 id="title" class="title">Permissions</h1> <h2 id="subtitle" class="subtitle"
11911191
</ol>
11921192
</li>
11931193
<li>Let <var>key</var> be the result of <a data-link-type="dfn|abstract-op" data-lt="permission key generation algorithm" href="#dfn-permission-key-generation-algorithm" class="internalDFN" id="ref-for-dfn-permission-key-generation-algorithm-3">generating a permission key</a> for <var data-type="PermissionDescriptor">descriptor</var> with <var>settings</var>'s
1194-
<a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/webappapis.html#concept-settings-object-origin">origin</a> and <var>settings</var>'s
1195-
<a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/webappapis.html#concept-environment-top-level-origin">top-level origin</a>.
1194+
<a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/webappapis.html#concept-environment-top-level-origin">top-level origin</a> and <var>settings</var>'s
1195+
<a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/webappapis.html#concept-settings-object-origin">origin</a>.
11961196
</li>
11971197
<li>Let <var>entry</var> be the result of <a data-link-type="dfn|abstract-op" data-lt="get a permission store entry" href="#dfn-get-a-permission-store-entry" class="internalDFN" id="ref-for-dfn-get-a-permission-store-entry-1">getting a permission store entry</a> with <var data-type="PermissionDescriptor">descriptor</var> and <var>key</var>.
11981198
</li>
@@ -1243,7 +1243,7 @@ <h1 id="title" class="title">Permissions</h1> <h2 id="subtitle" class="subtitle"
12431243
<li>Let <var>settings</var> be the <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/webappapis.html#current-settings-object">current settings object</a>.
12441244
</li>
12451245
<li>Let <var>key</var> be the result of <a data-link-type="dfn|abstract-op" data-lt="permission key generation algorithm" href="#dfn-permission-key-generation-algorithm" class="internalDFN" id="ref-for-dfn-permission-key-generation-algorithm-4">generating a permission key</a> for <var data-type="PermissionDescriptor">descriptor</var> with <var>settings</var>'s
1246-
<a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/webappapis.html#concept-settings-object-origin">origin</a> and <var>settings</var>'s <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/webappapis.html#concept-environment-top-level-origin">top-level origin</a>.
1246+
<a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/webappapis.html#concept-environment-top-level-origin">top-level origin</a> and <var>settings</var>'s <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/webappapis.html#concept-settings-object-origin">origin</a>.
12471247
</li>
12481248
<li><a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/webappapis.html#queue-a-task">Queue a task</a> on the <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/webappapis.html#current-settings-object">current settings object</a>'s <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/webappapis.html#responsible-event-loop">responsible event loop</a> to <a data-link-type="dfn|abstract-op" href="#dfn-set-a-permission-store-entry" class="internalDFN" id="ref-for-dfn-set-a-permission-store-entry-1">set a permission store entry</a> with <var data-type="PermissionDescriptor">descriptor</var>,
12491249
<var>key</var>, and <var>current state</var>.
@@ -1954,8 +1954,8 @@ <h1 id="title" class="title">Permissions</h1> <h2 id="subtitle" class="subtitle"
19541954
optional <a data-link-type="dfn|abstract-op" href="#dfn-permission-key" class="internalDFN" id="ref-for-dfn-permission-key-12">permission key</a> <var>key</var>, and an optional <var>user agent</var>:
19551955
</p>
19561956
<ol>
1957-
<li>Let <var>target key</var> be the result of <a data-link-type="dfn|abstract-op" data-lt="permission key generation algorithm" href="#dfn-permission-key-generation-algorithm" class="internalDFN" id="ref-for-dfn-permission-key-generation-algorithm-5">generating a permission key</a> for <var data-type="PermissionDescriptor">descriptor</var> with <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/webappapis.html#current-settings-object">current settings object</a>'s <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/webappapis.html#concept-settings-object-origin">origin</a> and <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/webappapis.html#current-settings-object">current settings object</a>'s
1958-
<a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/webappapis.html#concept-environment-top-level-origin">top-level origin</a> if <var>key</var> is null, or <var>key</var> otherwise.
1957+
<li>Let <var>target key</var> be the result of <a data-link-type="dfn|abstract-op" data-lt="permission key generation algorithm" href="#dfn-permission-key-generation-algorithm" class="internalDFN" id="ref-for-dfn-permission-key-generation-algorithm-5">generating a permission key</a> for <var data-type="PermissionDescriptor">descriptor</var> with <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/webappapis.html#current-settings-object">current settings object</a>'s <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/webappapis.html#concept-environment-top-level-origin">top-level origin</a> and <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/webappapis.html#current-settings-object">current settings object</a>'s
1958+
<a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/webappapis.html#concept-settings-object-origin">origin</a> if <var>key</var> is null, or <var>key</var> otherwise.
19591959
</li>
19601960
<li>Let <var>settings list</var> be a <a data-link-type="dfn" href="https://infra.spec.whatwg.org/#list">list</a> containing all <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/webappapis.html#environment-settings-object">environment settings objects</a>
19611961
which belong to the <var>user agent</var> if provided, or all user agents otherwise.
@@ -1965,7 +1965,7 @@ <h1 id="title" class="title">Permissions</h1> <h2 id="subtitle" class="subtitle"
19651965
<li><a data-link-type="dfn" href="https://infra.spec.whatwg.org/#list-iterate">For each</a> <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/webappapis.html#environment-settings-object">environment settings object</a> <var>settings</var> in <var>settings list</var>:
19661966
<ol>
19671967
<li>Let <var>settings key</var> be be the result of <a data-link-type="dfn|abstract-op" data-lt="permission key generation algorithm" href="#dfn-permission-key-generation-algorithm" class="internalDFN" id="ref-for-dfn-permission-key-generation-algorithm-6">generating a permission key</a> for <var data-type="PermissionDescriptor">descriptor</var> with <var>settings</var>'s
1968-
<a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/webappapis.html#concept-settings-object-origin">origin</a> and <var>settings</var>'s <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/webappapis.html#concept-environment-top-level-origin">top-level origin</a>.
1968+
<a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/webappapis.html#concept-environment-top-level-origin">top-level origin</a> and <var>settings</var>'s <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/webappapis.html#concept-settings-object-origin">origin</a>.
19691969
</li>
19701970
<li>Let <var>matches</var> be the result of running the <a data-link-type="dfn|abstract-op" href="#dfn-permission-key-comparison-algorithm" class="internalDFN" id="ref-for-dfn-permission-key-comparison-algorithm-3">permission key comparison algorithm</a> for <var data-type="PermissionDescriptor">descriptor</var>, given <var>settings key</var> and <var>key</var>.
19711971
</li>
@@ -2153,7 +2153,7 @@ <h1 id="title" class="title">Permissions</h1> <h2 id="subtitle" class="subtitle"
21532153
descriptor: permissions.PermissionDescriptor,
21542154
state: permissions.PermissionState,
21552155
origin: text,
2156-
? topLevelOrigin: text,
2156+
? embeddedOrigin: text,
21572157
? userContext: text,
21582158
}</code></pre>
21592159
</dd>
@@ -2189,11 +2189,11 @@ <h1 id="title" class="title">Permissions</h1> <h2 id="subtitle" class="subtitle"
21892189
</li>
21902190
<li>Let <var>origin</var> be the value of the <code>origin</code> field of <var>command parameters</var>.
21912191
</li>
2192-
<li>Let <var>top level origin</var> be the value of the <code>topLevelOrigin</code> field of
2192+
<li>Let <var>embedded origin</var> be the value of the <code>embeddedOrigin</code> field of
21932193
<var>command parameters</var>, if present, and <var>origin</var> otherwise.
21942194
</li>
21952195
<li>Let <var>key</var> be the result of <a data-link-type="dfn|abstract-op" data-lt="permission key generation algorithm" href="#dfn-permission-key-generation-algorithm" class="internalDFN" id="ref-for-dfn-permission-key-generation-algorithm-7">generating a permission key</a> for <var>descriptor</var> with <var>origin</var> and
2196-
<var>top level origin</var>.
2196+
<var>embedded origin</var>.
21972197
</li>
21982198
<li>Let <var>user agent</var> be the <a data-link-type="dfn" href="https://infra.spec.whatwg.org/#user-agent">user agent</a> that represents the <a data-link-type="dfn" href="https://www.w3.org/TR/webdriver-bidi/#user-context">user context</a>
21992199
with the id <var>user context id</var>.
@@ -2642,7 +2642,7 @@ <h1 id="title" class="title">Permissions</h1> <h2 id="subtitle" class="subtitle"
26422642
</dd><dt id="bib-webdriver">[WebDriver]</dt><dd>
26432643
<a href="https://www.w3.org/TR/webdriver1/"><cite>WebDriver</cite></a>. Simon Stewart; David Burns. W3C. 5 June 2018. W3C Recommendation. URL: <a href="https://www.w3.org/TR/webdriver1/">https://www.w3.org/TR/webdriver1/</a>
26442644
</dd><dt id="bib-webdriver-bidi">[WebDriver-BiDi]</dt><dd>
2645-
<a href="https://www.w3.org/TR/webdriver-bidi/"><cite>WebDriver BiDi</cite></a>. James Graham; Alex Rudenko; Maksim Sadym. W3C. 26 September 2025. W3C Working Draft. URL: <a href="https://www.w3.org/TR/webdriver-bidi/">https://www.w3.org/TR/webdriver-bidi/</a>
2645+
<a href="https://www.w3.org/TR/webdriver-bidi/"><cite>WebDriver BiDi</cite></a>. James Graham; Alex Rudenko; Maksim Sadym. W3C. 1 October 2025. W3C Working Draft. URL: <a href="https://www.w3.org/TR/webdriver-bidi/">https://www.w3.org/TR/webdriver-bidi/</a>
26462646
</dd><dt id="bib-webdriver2">[webdriver2]</dt><dd>
26472647
<a href="https://www.w3.org/TR/webdriver2/"><cite>WebDriver</cite></a>. Simon Stewart; David Burns. W3C. 8 September 2025. W3C Working Draft. URL: <a href="https://www.w3.org/TR/webdriver2/">https://www.w3.org/TR/webdriver2/</a>
26482648
</dd><dt id="bib-webidl">[WEBIDL]</dt><dd>
@@ -2661,7 +2661,7 @@ <h1 id="title" class="title">Permissions</h1> <h2 id="subtitle" class="subtitle"
26612661
</dd><dt id="bib-orientation-event">[orientation-event]</dt><dd>
26622662
<a href="https://www.w3.org/TR/orientation-event/"><cite>Device Orientation and Motion</cite></a>. Reilly Grant; Marcos Caceres. W3C. 12 February 2025. CRD. URL: <a href="https://www.w3.org/TR/orientation-event/">https://www.w3.org/TR/orientation-event/</a>
26632663
</dd><dt id="bib-permissions">[Permissions]</dt><dd>
2664-
<a href="https://www.w3.org/TR/permissions/"><cite>Permissions</cite></a>. Marcos Caceres; Mike Taylor. W3C. 24 June 2025. W3C Working Draft. URL: <a href="https://www.w3.org/TR/permissions/">https://www.w3.org/TR/permissions/</a>
2664+
<a href="https://www.w3.org/TR/permissions/"><cite>Permissions</cite></a>. Marcos Caceres; Mike Taylor. W3C. 26 September 2025. W3C Working Draft. URL: <a href="https://www.w3.org/TR/permissions/">https://www.w3.org/TR/permissions/</a>
26652665
</dd><dt id="bib-push-api">[push-api]</dt><dd>
26662666
<a href="https://www.w3.org/TR/push-api/"><cite>Push API</cite></a>. Marcos Caceres; Kagami Rosylight. W3C. 25 September 2025. W3C Working Draft. URL: <a href="https://www.w3.org/TR/push-api/">https://www.w3.org/TR/push-api/</a>
26672667
</dd><dt id="bib-w3c-process">[w3c-process]</dt><dd>

0 commit comments

Comments
 (0)