From 51572fef5259f62bcc68d78909ffc7c25635ded2 Mon Sep 17 00:00:00 2001 From: Leo Balter Date: Mon, 3 May 2021 17:36:37 -0700 Subject: [PATCH 1/3] Normative: Clarify text about host added properties Ref #284 --- spec.html | 21 ++++++++++++++++++--- 1 file changed, 18 insertions(+), 3 deletions(-) diff --git a/spec.html b/spec.html index 4f497a9..e29b43f 100644 --- a/spec.html +++ b/spec.html @@ -357,10 +357,25 @@

Runtime Semantics: HostInitializeSyntheticRealm ( _realm_ )

operation used to inform the host of any newly created realms from the Realm constructor. Its return value is not used, though it may throw an exception. The idea of this hook is to initialize host - data structures related to the Realm, e.g., for module loading. It - is not expected that this hook would add properties to the Realm's - global object. + data structures related to the Realm, e.g., for module loading.

+

+ The host may use this hook to add properties to the Realm's global + object. Those properties must each be configurable to provide + platform capabilities with no authority to cause side effects such + as I/O or mutation of values that are shared across different + realms within the same host environment. +

+ +

+ EDITOR'S NOTE: This specification does not recommend any specific + addition. In the Web embedding, HTML and WebIDL will specify which + interfaces are included. The Web Platform and Web-like + environments may decide to include `setTimeout`, `EventTarget`, + `atob`, `TextEncoder`, `URL`, etc. while at the same time not + including `HTMLElement`, `console`, `localStorage`, `fetch`, etc.. +

+
From b29eb1b154cefcefc000dc6ecc2c1c5c57aeded5 Mon Sep 17 00:00:00 2001 From: Leo Balter Date: Mon, 3 May 2021 17:38:48 -0700 Subject: [PATCH 2/3] fixup! Normative: Clarify text about host added properties --- spec.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/spec.html b/spec.html index e29b43f..88c76e2 100644 --- a/spec.html +++ b/spec.html @@ -368,8 +368,8 @@

Runtime Semantics: HostInitializeSyntheticRealm ( _realm_ )

- EDITOR'S NOTE: This specification does not recommend any specific - addition. In the Web embedding, HTML and WebIDL will specify which + This specification does not recommend any specific addition. + In the Web embedding, HTML and WebIDL will specify which interfaces are included. The Web Platform and Web-like environments may decide to include `setTimeout`, `EventTarget`, `atob`, `TextEncoder`, `URL`, etc. while at the same time not From e44a8f5859b1f01b5c9cc0d047e486c4714c3d60 Mon Sep 17 00:00:00 2001 From: Leo Balter Date: Wed, 5 May 2021 10:08:29 -0700 Subject: [PATCH 3/3] Update spec.html --- spec.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/spec.html b/spec.html index 88c76e2..9723a6a 100644 --- a/spec.html +++ b/spec.html @@ -371,7 +371,7 @@

Runtime Semantics: HostInitializeSyntheticRealm ( _realm_ )

This specification does not recommend any specific addition. In the Web embedding, HTML and WebIDL will specify which interfaces are included. The Web Platform and Web-like - environments may decide to include `setTimeout`, `EventTarget`, + environments may decide to include `EventTarget`, `atob`, `TextEncoder`, `URL`, etc. while at the same time not including `HTMLElement`, `console`, `localStorage`, `fetch`, etc..