|
7 | 7 | <link href="https://www.w3.org/StyleSheets/TR/2021/cg-draft" rel="stylesheet"> |
8 | 8 | <meta content="Bikeshed version 60c422380, updated Thu Feb 20 19:11:22 2025 -0800" name="generator"> |
9 | 9 | <link href="https://w3c.github.io/webextensions/specification/window.browser.html" rel="canonical"> |
10 | | - <meta content="57765ac301a137f01ffcd6dfc71ccd4f330fce54" name="revision"> |
| 10 | + <meta content="e393c3faa6f458da2f9506641c568d632e1c0496" name="revision"> |
11 | 11 | <meta content="dark light" name="color-scheme"> |
12 | 12 | <link href="https://www.w3.org/StyleSheets/TR/2021/dark.css" media="(prefers-color-scheme: dark)" rel="stylesheet" type="text/css"> |
13 | 13 | <style>/* Boilerplate: style-autolinks */ |
|
695 | 695 | <div class="head"> |
696 | 696 | <p data-fill-with="logo"><a class="logo" href="https://www.w3.org/"> <img alt="W3C" height="48" src="https://www.w3.org/StyleSheets/TR/2021/logos/W3C" width="72"> </a> </p> |
697 | 697 | <h1 class="p-name no-ref" id="title">window.browser</h1> |
698 | | - <p id="w3c-state"><a href="https://www.w3.org/standards/types/#CG-DRAFT">Draft Community Group Report</a>, <time class="dt-updated" datetime="2025-02-21">21 February 2025</time></p> |
| 698 | + <p id="w3c-state"><a href="https://www.w3.org/standards/types/#CG-DRAFT">Draft Community Group Report</a>, <time class="dt-updated" datetime="2025-02-27">27 February 2025</time></p> |
699 | 699 | <details open> |
700 | 700 | <summary>More details about this document</summary> |
701 | 701 | <div data-fill-with="spec-metadata"> |
@@ -771,17 +771,17 @@ <h3 class="heading settled" id="introduction"><span class="content">Introduction |
771 | 771 | </section> |
772 | 772 | <section> |
773 | 773 | <h3 class="heading settled" id="window-interface"><span class="content"> <a class="idl-code" data-link-type="attribute" href="#dom-serviceworkerglobalscope-browser" id="ref-for-dom-serviceworkerglobalscope-browser"><code>window.browser</code></a> API </span></h3> |
774 | | - <p><code class="idl"><a data-link-type="idl" href="#dom-serviceworkerglobalscope-browser" id="ref-for-dom-serviceworkerglobalscope-browser①">browser</a></code> is UA defined attribute exposed on <code class="idl"><a data-link-type="idl" href="https://html.spec.whatwg.org/multipage/nav-history-apis.html#dom-window" id="ref-for-dom-window">window</a></code>. When implemented, |
| 774 | + <p><code class="idl"><a data-link-type="idl" href="#dom-window-browser" id="ref-for-dom-window-browser">browser</a></code> is UA defined attribute exposed on <code class="idl"><a data-link-type="idl" href="https://html.spec.whatwg.org/multipage/nav-history-apis.html#dom-window" id="ref-for-dom-window">window</a></code>. When implemented, |
775 | 775 | it MUST be used only for WebExtension related functionality.</p> |
776 | 776 | </section> |
777 | 777 | <section> |
778 | 778 | For backwards compatibility with older versions of WebExtensions that used <code>chrome</code> as a global identifier for WebExtension related methods, |
779 | 779 | a UA MAY define a global <code>chrome</code> object that includes all |
780 | | - properties of <code class="idl"><a data-link-type="idl" href="#dom-window-browser" id="ref-for-dom-window-browser">browser</a></code>. <code class="idl"><a data-link-type="idl" href="#dom-serviceworkerglobalscope-browser" id="ref-for-dom-serviceworkerglobalscope-browser②">browser</a></code> and <code>chrome</code> MAY be direct aliases of each other. |
781 | | - When <code class="idl"><a data-link-type="idl" href="#dom-window-browser" id="ref-for-dom-window-browser①">browser</a></code> and <code>chrome</code> are distinct objects, each initial |
782 | | - property of <code class="idl"><a data-link-type="idl" href="#dom-serviceworkerglobalscope-browser" id="ref-for-dom-serviceworkerglobalscope-browser③">browser</a></code> SHOULD be defined on the <code>chrome</code> object, |
| 780 | + properties of <code class="idl"><a data-link-type="idl" href="#dom-window-browser" id="ref-for-dom-window-browser①">browser</a></code>. <code class="idl"><a data-link-type="idl" href="#dom-window-browser" id="ref-for-dom-window-browser②">browser</a></code> and <code>chrome</code> MAY be direct aliases of each other. |
| 781 | + When <code class="idl"><a data-link-type="idl" href="#dom-serviceworkerglobalscope-browser" id="ref-for-dom-serviceworkerglobalscope-browser①">browser</a></code> and <code>chrome</code> are distinct objects, each initial |
| 782 | + property of <code class="idl"><a data-link-type="idl" href="#dom-serviceworkerglobalscope-browser" id="ref-for-dom-serviceworkerglobalscope-browser②">browser</a></code> SHOULD be defined on the <code>chrome</code> object, |
783 | 783 | and each property descriptor on the <code>chrome</code> object SHOULD return |
784 | | - the same value as the corresponding property on the <code class="idl"><a data-link-type="idl" href="#dom-window-browser" id="ref-for-dom-window-browser②">browser</a></code> object. |
| 784 | + the same value as the corresponding property on the <code class="idl"><a data-link-type="idl" href="#dom-serviceworkerglobalscope-browser" id="ref-for-dom-serviceworkerglobalscope-browser③">browser</a></code> object. |
785 | 785 | <div class="example" id="example-1"> |
786 | 786 | <a class="self-link" href="#example-1"></a> Here’s an example of the expected alias behavior |
787 | 787 | <pre><code class="lang-js highlight"><c- c1>// When `chrome` and `browser` are not direct aliases,</c-> |
@@ -809,7 +809,7 @@ <h3 class="heading settled" id="window-interface"><span class="content"> <a clas |
809 | 809 | <section> |
810 | 810 | <h3 class="heading settled" id="worker-interface"><span class="content"> Worker API </span></h3> |
811 | 811 | <p>When <code class="idl"><a data-link-type="idl" href="#dom-serviceworkerglobalscope-browser" id="ref-for-dom-serviceworkerglobalscope-browser④">browser</a></code> is defined on <code class="idl"><a data-link-type="idl" href="https://html.spec.whatwg.org/multipage/nav-history-apis.html#dom-window" id="ref-for-dom-window①">window</a></code>, it SHOULD also be exposed on <code class="idl"><a data-link-type="idl" href="https://w3c.github.io/ServiceWorker/#serviceworkerglobalscope" id="ref-for-serviceworkerglobalscope">ServiceWorkerGlobalScope</a></code> of origins associated with WebExtensions. |
812 | | - It MUST be used exclusively for WebExtension purposes, however the contents of each instance of <code class="idl"><a data-link-type="idl" href="#dom-window-browser" id="ref-for-dom-window-browser③">browser</a></code> is UA defined.</p> |
| 812 | + It MUST be used exclusively for WebExtension purposes, however the contents of each instance of <code class="idl"><a data-link-type="idl" href="#dom-serviceworkerglobalscope-browser" id="ref-for-dom-serviceworkerglobalscope-browser⑤">browser</a></code> is UA defined.</p> |
813 | 813 | </section> |
814 | 814 | <pre class="idl highlight def"><c- b>partial</c-> <c- b>interface</c-> <a class="idl-code" data-link-type="interface" href="https://w3c.github.io/ServiceWorker/#serviceworkerglobalscope" id="ref-for-serviceworkerglobalscope①"><c- g>ServiceWorkerGlobalScope</c-></a> { |
815 | 815 | <c- b>attribute</c-> <a class="idl-code" data-link-type="interface" href="https://webidl.spec.whatwg.org/#idl-object" id="ref-for-idl-object①"><c- b>object</c-></a> <dfn class="dfn-paneled idl-code" data-dfn-for="ServiceWorkerGlobalScope" data-dfn-type="attribute" data-export data-type="object" id="dom-serviceworkerglobalscope-browser"><code><c- g>browser</c-></code></dfn>; |
@@ -1099,8 +1099,8 @@ <h2 class="no-num no-ref heading settled" id="idl-index"><span class="content">I |
1099 | 1099 | "5d7209e9": {"dfnID":"5d7209e9","dfnText":"Window","external":true,"refSections":[{"refs":[{"id":"ref-for-window"}],"title":"Unnumbered Section"}],"url":"https://html.spec.whatwg.org/multipage/nav-history-apis.html#window"}, |
1100 | 1100 | "86d2a717": {"dfnID":"86d2a717","dfnText":"ServiceWorkerGlobalScope","external":true,"refSections":[{"refs":[{"id":"ref-for-serviceworkerglobalscope"}],"title":"\n Worker API\n "},{"refs":[{"id":"ref-for-serviceworkerglobalscope\u2460"}],"title":"Unnumbered Section"}],"url":"https://w3c.github.io/ServiceWorker/#serviceworkerglobalscope"}, |
1101 | 1101 | "9f156e6b": {"dfnID":"9f156e6b","dfnText":"window","external":true,"refSections":[{"refs":[{"id":"ref-for-dom-window"}],"title":"\n window.browser API\n "},{"refs":[{"id":"ref-for-dom-window\u2460"}],"title":"\n Worker API\n "}],"url":"https://html.spec.whatwg.org/multipage/nav-history-apis.html#dom-window"}, |
1102 | | -"dom-serviceworkerglobalscope-browser": {"dfnID":"dom-serviceworkerglobalscope-browser","dfnText":"browser","external":false,"refSections":[{"refs":[{"id":"ref-for-dom-serviceworkerglobalscope-browser"},{"id":"ref-for-dom-serviceworkerglobalscope-browser\u2460"}],"title":"\n window.browser API\n "},{"refs":[{"id":"ref-for-dom-serviceworkerglobalscope-browser\u2463"}],"title":"\n Worker API\n "}],"url":"#dom-serviceworkerglobalscope-browser"}, |
1103 | | -"dom-window-browser": {"dfnID":"dom-window-browser","dfnText":"browser","external":false,"refSections":[{"refs":[{"id":"ref-for-dom-window-browser\u2462"}],"title":"\n Worker API\n "}],"url":"#dom-window-browser"}, |
| 1102 | +"dom-serviceworkerglobalscope-browser": {"dfnID":"dom-serviceworkerglobalscope-browser","dfnText":"browser","external":false,"refSections":[{"refs":[{"id":"ref-for-dom-serviceworkerglobalscope-browser"}],"title":"\n window.browser API\n "},{"refs":[{"id":"ref-for-dom-serviceworkerglobalscope-browser\u2463"},{"id":"ref-for-dom-serviceworkerglobalscope-browser\u2464"}],"title":"\n Worker API\n "}],"url":"#dom-serviceworkerglobalscope-browser"}, |
| 1103 | +"dom-window-browser": {"dfnID":"dom-window-browser","dfnText":"browser","external":false,"refSections":[{"refs":[{"id":"ref-for-dom-window-browser"}],"title":"\n window.browser API\n "}],"url":"#dom-window-browser"}, |
1104 | 1104 | "efd1ec5d": {"dfnID":"efd1ec5d","dfnText":"object","external":true,"refSections":[{"refs":[{"id":"ref-for-idl-object"},{"id":"ref-for-idl-object\u2460"}],"title":"Unnumbered Section"}],"url":"https://webidl.spec.whatwg.org/#idl-object"}, |
1105 | 1105 | }; |
1106 | 1106 |
|
|
0 commit comments