Skip to content

Commit 89bf0f9

Browse files
authored
Editorial: self-referential changes
These changes are an editorial suggestion, I encourage the editor(s) to implement whichever ones they feel are appropriate.
1 parent 0abdde6 commit 89bf0f9

File tree

1 file changed

+11
-11
lines changed

1 file changed

+11
-11
lines changed

index.bs

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ There is a wide base of JavaScript runtime environments being used beyond web br
2121

2222
But since code running in web browsers makes up the vast majority of JavaScript code, this is helped along if such runtimes support the same APIs as web browsers. So, unsurprisingly, more and more runtime environments have started supporting web platform APIs. However, the increase in such environments, as well as the different choices of web platform APIs, resulted in poor interoperability across such environments.
2323

24-
As such, this Ecma Standard defines the Minimum Common Web API specification, which lists a curated minimum subset of web platform APIs for server-side and edge runtimes to implement if they aim to be web-interoperable. This is the first edition of the standard, corresponding to the 2025 snapshot, and an additional snapshot will be published every year.
24+
As such, this Ecma Standard defines the Minimum Common Web API specification, which lists a curated minimum subset of web platform APIs for server-side and edge runtimes to implement if they aim to be web-interoperable. This is the first edition of the standard, corresponding to the 2025 snapshot. An additional snapshot is intended to be published annually.
2525

2626
Scope {#scope}
2727
==============
@@ -31,11 +31,11 @@ This Standard defines the 2025 snapshot of the Minimum Common Web Platform API,
3131
Conformance {#conformance}
3232
==========================
3333

34-
A conforming implementation of the Minimum Common Web Platform API shall conform to ECMA-262, and additionally shall provide the interfaces and properties listed in this specification, according to their definition in the corresponding W3C or WHATWG standard.
34+
A conforming implementation of the Minimum Common Web Platform API shall conform to ECMA-262, and additionally shall provide the interfaces and properties listed in the present document, according to their definition in the corresponding W3C or WHATWG standard.
3535

3636
Runtime-specific extensions to any Web Platform API may be implemented by conforming runtimes. Such extensions shall be defined so that their use neither contradicts, nor causes the non-conformance of, normative functionality of any Web Platform API. It is important to carefully consider use of such extensions, as it reduces interoperability and portability of code across runtimes.
3737

38-
This specification does not prohibit implementing additional Web Platform APIs beyond those listed here.
38+
The present dsocument does not prohibit implementing additional Web Platform APIs beyond those listed here.
3939

4040
Note: For example, the {{Performance}} API could be extended with additional methods or properties beyond those defined in the [[HR-TIME]] specifications, such as those defined in the [[PERFORMANCE-TIMELINE]] or [[USER-TIMING]] specifications.
4141

@@ -57,16 +57,16 @@ The Web Platform is the combination of technology standards defined by organizat
5757
<dfn>Web-interoperable Runtime</dfn> {#term-web-interoperable-runtime}
5858
----------------------------------------------------------------------
5959

60-
Any ECMAScript-based application runtime environment that implements the subset of Web Platform APIs outlined in this specification.
60+
Any ECMAScript-based application runtime environment that implements the subset of Web Platform APIs outlined in the present document.
6161

6262
While this term is intentionally broad to also encompass Web Browsers, the primary focus here is on outlining expectations for non-browser runtimes.
6363

6464
Common API Index {#api-index}
6565
=========================
6666

67-
All <a>Web-interoperable Runtimes</a> conforming to this specification shall implement each of the following Web Platform APIs. These should be implemented in accordance with their normative requirements except where modified here. Where any conforming runtime environment chooses (either by necessity or otherwise) to diverge from a normative requirement of the specification, clear explanations of such divergence shall be made clearly and readily available in the documentation.
67+
All <a>Web-interoperable Runtimes</a> conforming to the Minimum common web API shall implement each of the following Web Platform APIs. These should be implemented in accordance with their normative requirements except where modified here. Where any conforming runtime environment chooses (either by necessity or otherwise) to diverge from a normative requirement of the specification, clear explanations of such divergence shall be made clearly and readily available in the documentation.
6868

69-
All of the following interfaces shall be exposed on the global object accessible through `globalThis`, unless otherwise specified in this specification:
69+
All of the following interfaces shall be exposed on the global object accessible through `globalThis`, unless otherwise specified in the present document:
7070

7171
* {{AbortController}} [[!DOM]]
7272
* {{AbortSignal}} [[!DOM]]
@@ -122,7 +122,7 @@ All of the following interfaces shall be exposed on the global object accessible
122122
* {{WritableStreamDefaultController}} [[!STREAMS]]
123123
* {{WritableStreamDefaultWriter}} [[!STREAMS]]
124124

125-
All of the following methods and properties shall be exposed on the global object accessible through `globalThis`, unless otherwise specified in this specification:
125+
All of the following methods and properties shall be exposed on the global object accessible through `globalThis`, unless otherwise specified in the present document:
126126

127127
* {{globalThis}} [[!ECMASCRIPT]]
128128
* `globalThis.`{{atob()}} [[!HTML]]
@@ -152,15 +152,15 @@ All of the following methods and properties shall be exposed on the global objec
152152

153153
Web-interoperable runtimes that support workers shall also expose {{WorkerGlobalScope/onerror}},
154154
{{WorkerGlobalScope/onunhandledrejection}}, {{WorkerGlobalScope/onrejectionhandled}} and
155-
{{WorkerGlobalScope/self}} on the worker's `globalThis`,
156-
unless otherwise specified in this specification. [[!HTML]]
155+
{{WorkerGlobalScope/self}} on the worker's `globalThis`,
156+
unless otherwise specified in the current document. [[!HTML]]
157157

158158
The Global Scope {#global-scope}
159159
================================
160160

161-
The exact type of the global scope (`globalThis`) can vary across runtimes. Most Web Platform APIs are defined in terms that assume Web Browser environments that specifically expose types like {{Window}}, {{WorkerGlobalScope}}, and so forth. To simplify conformance, all interfaces, methods, and properties defined by this specification shall be exposed on the runtime's relevant global scope (e.g., `globalThis.crypto`, `globalThis.ReadableStream`, etc).
161+
The exact type of the global scope (`globalThis`) can vary across runtimes. Most Web Platform APIs are defined in terms that assume Web Browser environments that specifically expose types like {{Window}}, {{WorkerGlobalScope}}, and so forth. To simplify conformance, all interfaces, methods, and properties defined by the present document shall be exposed on the runtime's relevant global scope (e.g., `globalThis.crypto`, `globalThis.ReadableStream`, etc).
162162

163-
With many runtimes, adding a new global-scoped property can introduce breaking changes when the new global conflicts with existing application code. Many Web Platform APIs define global properties using [=read only|the `readonly` attribute=]. [[!WEBIDL]] To avoid introducing breaking changes, runtimes conforming to this specification may choose to ignore the `readonly` attribute for properties being added to the global scope. This allows users of these runtimes to delete or overwrite these properties if they conflict with existing application code.
163+
With many runtimes, adding a new global-scoped property can introduce breaking changes when the new global conflicts with existing application code. Many Web Platform APIs define global properties using [=read only|the `readonly` attribute=]. [[!WEBIDL]] To avoid introducing breaking changes, runtimes conforming to the Minimum commone web API standard may choose to ignore the `readonly` attribute for properties being added to the global scope. This allows users of these runtimes to delete or overwrite these properties if they conflict with existing application code.
164164

165165
The global object on {{Window}}-like and worker environments should always be an instance of {{EventTarget}}. Web-interoperable runtimes should follow the <a>report an exception</a> algorithm, and the JavaScript <a href="https://tc39.es/ecma262/#sec-host-promise-rejection-tracker">HostPromiseRejectionTracker</a> host hook, as defined in [[!HTML]]. This includes firing the {{Window/error}}, {{Window/unhandledrejection}} and {{Window/rejectionhandled}} events on the global object.
166166

0 commit comments

Comments
 (0)