Skip to content

Commit a162c1a

Browse files
committed
Rename [OverrideBuiltins] to [LegacyOverrideBuiltIns]
Part of #350.
1 parent 3ff0cb9 commit a162c1a

File tree

1 file changed

+18
-18
lines changed

1 file changed

+18
-18
lines changed

index.bs

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1012,12 +1012,12 @@ The following extended attributes are applicable to interfaces:
10121012
[{{LegacyWindowAlias}}],
10131013
[{{NamedConstructor}}],
10141014
[{{NoInterfaceObject}}],
1015-
[{{OverrideBuiltins}}], and
1015+
[{{LegacyOverrideBuiltIns}}], and
10161016
[{{SecureContext}}].
10171017

10181018
The following extended attributes are applicable to [=partial interfaces=]:
10191019
[{{Exposed}}],
1020-
[{{OverrideBuiltins}}], and
1020+
[{{LegacyOverrideBuiltIns}}], and
10211021
[{{SecureContext}}].
10221022

10231023
[=Interfaces=] which are not annotated
@@ -9457,10 +9457,10 @@ used on an [=interface=], then:
94579457
* The interface must not define a [=named property setter=].
94589458
* The interface must not define [=indexed property getters=] or [=indexed property setter|setters=].
94599459
* The interface must not define a [=constructor operation=].
9460-
* The interface must not also be declared with the [{{OverrideBuiltins}}]
9460+
* The interface must not also be declared with the [{{LegacyOverrideBuiltIns}}]
94619461
extended attribute.
94629462
* The interface must not [=interface/inherit=] from another interface with the
9463-
[{{OverrideBuiltins}}] extended attribute.
9463+
[{{LegacyOverrideBuiltIns}}] extended attribute.
94649464
* Any other interface must not [=interface/inherit=] from it.
94659465

94669466
If [{{Global}}] is specified on
@@ -10159,29 +10159,29 @@ for the specific requirements that the use of
1015910159
</div>
1016010160

1016110161

10162-
<h4 id="OverrideBuiltins" extended-attribute lt="OverrideBuiltins">[OverrideBuiltins]</h4>
10162+
<h4 id="LegacyOverrideBuiltIns" extended-attribute lt="LegacyOverrideBuiltIns" oldids="OverrideBuiltins">[LegacyOverrideBuiltIns]</h4>
1016310163

1016410164
<div class="advisement">
1016510165

10166-
The [{{OverrideBuiltins}}] [=extended attribute=] is an undesirable feature.
10166+
The [{{LegacyOverrideBuiltIns}}] [=extended attribute=] is an undesirable feature.
1016710167
It exists only so that legacy Web platform features can be specified.
1016810168
It should not be used in specifications
1016910169
unless required to specify the behavior of legacy APIs,
1017010170
or for consistency with these APIs.
1017110171
Editors who wish to use this feature are strongly advised to discuss this
10172-
by <a href="https://github.com/heycam/webidl/issues/new?title=Intent%20to%20use%20[OverrideBuiltins]">filing an issue</a>
10172+
by <a href="https://github.com/heycam/webidl/issues/new?title=Intent%20to%20use%20[LegacyOverrideBuiltIns]">filing an issue</a>
1017310173
before proceeding.
1017410174

1017510175
<small class="non-normative">
10176-
The [{{OverrideBuiltins}}] [=extended attribute=] appears on the
10176+
The [{{LegacyOverrideBuiltIns}}] [=extended attribute=] appears on the
1017710177
{{DOMStringMap}},
1017810178
{{Document}}, and
1017910179
{{HTMLFormElement}} [=interfaces=]. [[HTML]]
1018010180
</small>
1018110181

1018210182
</div>
1018310183

10184-
If the [{{OverrideBuiltins}}]
10184+
If the [{{LegacyOverrideBuiltIns}}]
1018510185
[=extended attribute=]
1018610186
appears on an [=interface=],
1018710187
it indicates that for a [=legacy platform object=] implementing the interface,
@@ -10195,7 +10195,7 @@ This is in contrast to the usual behavior, which is for named properties
1019510195
to be exposed only if there is no property with the
1019610196
same name on the object itself or somewhere on its prototype chain.
1019710197

10198-
The [{{OverrideBuiltins}}]
10198+
The [{{LegacyOverrideBuiltIns}}]
1019910199
extended attribute must
1020010200
[=takes no arguments|take no arguments=]
1020110201
and must not appear on an interface
@@ -10207,14 +10207,14 @@ definition, then that partial interface definition must
1020710207
be the part of the interface definition that defines
1020810208
the [=named property getter=].
1020910209

10210-
If the [{{OverrideBuiltins}}] extended attribute is specified on a
10210+
If the [{{LegacyOverrideBuiltIns}}] extended attribute is specified on a
1021110211
[=partial interface=] definition, it is considered to appear on the
1021210212
[=interface=] itself.
1021310213

1021410214
See [[#es-legacy-platform-objects]]
1021510215
and [[#legacy-platform-object-defineownproperty]]
1021610216
for the specific requirements that the use of
10217-
[{{OverrideBuiltins}}] entails.
10217+
[{{LegacyOverrideBuiltIns}}] entails.
1021810218

1021910219
<div class="example">
1022010220

@@ -10231,7 +10231,7 @@ for the specific requirements that the use of
1023110231
};
1023210232

1023310233
[Exposed=Window,
10234-
OverrideBuiltins]
10234+
LegacyOverrideBuiltIns]
1023510235
interface StringMap2 {
1023610236
readonly attribute unsigned long length;
1023710237
getter DOMString lookup(DOMString key);
@@ -13432,7 +13432,7 @@ Additionally, [=legacy platform objects=] have internal methods as defined in:
1343213432
and |P| is not an [=unforgeable property name=]
1343313433
of |O|, then:
1343413434
1. Let |creating| be true if |P| is not a [=supported property name=], and false otherwise.
13435-
1. If |O| [=implements=] an interface with the [{{OverrideBuiltins}}]
13435+
1. If |O| [=implements=] an interface with the [{{LegacyOverrideBuiltIns}}]
1343613436
[=extended attribute=] or |O| does not have an own property
1343713437
named |P|, then:
1343813438
1. If |creating| is false and |O| does not implement an
@@ -13555,7 +13555,7 @@ internal method as follows.
1355513555
The <dfn id="dfn-named-property-visibility" export>named property visibility algorithm</dfn>
1355613556
is used to determine if a given named property is exposed on an object.
1355713557
Some named properties are not exposed on an object depending on whether
13558-
the [{{OverrideBuiltins}}] [=extended attribute=] was used.
13558+
the [{{LegacyOverrideBuiltIns}}] [=extended attribute=] was used.
1355913559
The algorithm operates as follows, with property name |P| and object |O|:
1356013560

1356113561
1. If |P| is not a [=supported property name=] of |O|, then return false.
@@ -13565,7 +13565,7 @@ internal method as follows.
1356513565
because in practice those are always set up before objects have any supported property names,
1356613566
and once set up will make the corresponding named properties invisible.
1356713567

13568-
1. If |O| [=implements=] an interface that has the [{{OverrideBuiltins}}]
13568+
1. If |O| [=implements=] an interface that has the [{{LegacyOverrideBuiltIns}}]
1356913569
[=extended attribute=], then return true.
1357013570
1. Let |prototype| be |O|.\[[GetPrototypeOf]]().
1357113571
1. While |prototype| is not null:
@@ -13581,10 +13581,10 @@ internal method as follows.
1358113581

1358213582
1. Indexed properties.
1358313583
1. Own properties, including unforgeable attributes and operations.
13584-
1. Then, if [{{OverrideBuiltins}}]:
13584+
1. Then, if [{{LegacyOverrideBuiltIns}}]:
1358513585
1. Named properties.
1358613586
1. Properties from the prototype chain.
13587-
1. Otherwise, if not [{{OverrideBuiltins}}]:
13587+
1. Otherwise, if not [{{LegacyOverrideBuiltIns}}]:
1358813588
1. Properties from the prototype chain.
1358913589
1. Named properties.
1359013590
</div>

0 commit comments

Comments
 (0)