Skip to content

Commit f28d2b2

Browse files
committed
Rename [LenientSetter] to [LegacyLenientSetter]
Part of #350.
1 parent d9074f8 commit f28d2b2

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
@@ -1917,7 +1917,7 @@ ignored or an exception is thrown.
19171917
</pre>
19181918

19191919
Attributes whose type is a [=promise type=] must be [=read only=]. Additionally, they cannot have
1920-
any of the [=extended attributes=] [{{LenientSetter}}], [{{PutForwards}}], [{{Replaceable}}], or
1920+
any of the [=extended attributes=] [{{LegacyLenientSetter}}], [{{PutForwards}}], [{{Replaceable}}], or
19211921
[{{SameObject}}].
19221922

19231923
A [=regular attribute=]
@@ -1968,7 +1968,7 @@ are applicable to regular and static attributes:
19681968

19691969
The following [=extended attributes=]
19701970
are applicable only to regular attributes:
1971-
[{{LenientSetter}}],
1971+
[{{LegacyLenientSetter}}],
19721972
[{{LenientThis}}],
19731973
[{{PutForwards}}],
19741974
[{{Replaceable}}],
@@ -9755,23 +9755,23 @@ are to be implemented.
97559755
</div>
97569756

97579757

9758-
<h4 id="LenientSetter" extended-attribute lt="LenientSetter">[LenientSetter]</h4>
9758+
<h4 id="LegacyLenientSetter" extended-attribute lt="LegacyLenientSetter" oldids="LenientSetter">[LegacyLenientSetter]</h4>
97599759

97609760
<div class="advisement">
97619761

9762-
Specifications should not use [{{LenientSetter}}]
9762+
Specifications should not use [{{LegacyLenientSetter}}]
97639763
unless required for compatibility reasons. Pages have been observed
97649764
where authors have attempted to polyfill an IDL attribute by assigning
97659765
to the property, but have accidentally done so even if the property
97669766
exists. In strict mode, this would cause an exception to be thrown,
9767-
potentially breaking page. Without [{{LenientSetter}}],
9767+
potentially breaking page. Without [{{LegacyLenientSetter}}],
97689768
this could prevent a browser from shipping the feature.
97699769
Editors who wish to use this feature are strongly advised to discuss this
9770-
by <a href="https://github.com/heycam/webidl/issues/new?title=Intent%20to%20use%20[LenientSetter]">filing an issue</a>
9770+
by <a href="https://github.com/heycam/webidl/issues/new?title=Intent%20to%20use%20[LegacyLenientSetter]">filing an issue</a>
97719771
before proceeding.
97729772

97739773
<small class="non-normative">
9774-
The [{{LenientSetter}}] [=extended attribute=] appears on
9774+
The [{{LegacyLenientSetter}}] [=extended attribute=] appears on
97759775
the {{Document/fullscreenEnabled}} and {{Document/fullscreenEnabled}} [=attributes=]
97769776
of the {{Document}} interface, and on
97779777
the {{DocumentOrShadowRoot/fullscreenElement}} [=attribute=]
@@ -9780,40 +9780,40 @@ are to be implemented.
97809780

97819781
</div>
97829782

9783-
If the [{{LenientSetter}}]
9783+
If the [{{LegacyLenientSetter}}]
97849784
[=extended attribute=]
97859785
appears on a [=read only=]
97869786
[=regular attribute=],
97879787
it indicates that a no-op setter will be generated for the attribute’s
97889788
accessor property. This results in erroneous assignments to the property
97899789
in strict mode to be ignored rather than causing an exception to be thrown.
97909790

9791-
The [{{LenientSetter}}] extended attribute
9791+
The [{{LegacyLenientSetter}}] extended attribute
97929792
must [=takes no arguments|take no arguments=].
97939793
It must not be used on anything other than
97949794
a [=read only=] [=regular attribute=].
97959795

9796-
An attribute with the [{{LenientSetter}}]
9796+
An attribute with the [{{LegacyLenientSetter}}]
97979797
extended attribute must not also be declared
97989798
with the [{{PutForwards}}]
97999799
or [{{Replaceable}}] extended attributes.
98009800

9801-
The [{{LenientSetter}}] extended attribute must not be used on an attribute declared on a
9801+
The [{{LegacyLenientSetter}}] extended attribute must not be used on an attribute declared on a
98029802
[=namespace=].
98039803

98049804
See the <a href="#es-attributes">Attributes</a> section for how
9805-
[{{LenientSetter}}] is to be implemented.
9805+
[{{LegacyLenientSetter}}] is to be implemented.
98069806

98079807
<div class="example">
98089808

98099809
The following IDL fragment defines an interface that uses the
9810-
[{{LenientSetter}}] extended
9810+
[{{LegacyLenientSetter}}] extended
98119811
attribute.
98129812

98139813
<pre highlight="webidl">
98149814
[Exposed=Window]
98159815
interface Example {
9816-
[LenientSetter] readonly attribute DOMString x;
9816+
[LegacyLenientSetter] readonly attribute DOMString x;
98179817
readonly attribute DOMString y;
98189818
};
98199819
</pre>
@@ -10322,7 +10322,7 @@ encountered more than once.
1032210322

1032310323
An attribute with the [{{PutForwards}}]
1032410324
extended attribute must not also be declared
10325-
with the [{{LenientSetter}}] or
10325+
with the [{{LegacyLenientSetter}}] or
1032610326
[{{Replaceable}}] extended attributes.
1032710327

1032810328
The [{{PutForwards}}]
@@ -10398,7 +10398,7 @@ extended attribute must
1039810398

1039910399
An attribute with the [{{Replaceable}}]
1040010400
extended attribute must not also be declared
10401-
with the [{{LenientSetter}}] or
10401+
with the [{{LegacyLenientSetter}}] or
1040210402
[{{PutForwards}}] extended attributes.
1040310403

1040410404
The [{{Replaceable}}]
@@ -11780,7 +11780,7 @@ in which case they are exposed on every object that [=implements=] the interface
1178011780
1. Assert: |attribute| is [=read only=].
1178111781
1. Return <emu-val>undefined</emu-val>.
1178211782
1. If |attribute| is [=read only=] and does not have a
11783-
[{{LenientSetter}}], [{{PutForwards}}] or [{{Replaceable}}] [=extended attribute=], return
11783+
[{{LegacyLenientSetter}}], [{{PutForwards}}] or [{{Replaceable}}] [=extended attribute=], return
1178411784
<emu-val>undefined</emu-val>; there is no [=attribute setter=] function.
1178511785
1. Assert: |attribute|'s type is not a [=promise type=].
1178611786
1. Let |steps| be the following series of steps:
@@ -11805,7 +11805,7 @@ in which case they are exposed on every object that [=implements=] the interface
1180511805
1. Perform [=?=] <a abstract-op>CreateDataProperty</a>(|esValue|, |id|, |V|).
1180611806
1. Return <emu-val>undefined</emu-val>.
1180711807
1. If |validThis| is false, then return <emu-val>undefined</emu-val>.
11808-
1. If |attribute| is declared with a [{{LenientSetter}}] extended attribute, then
11808+
1. If |attribute| is declared with a [{{LegacyLenientSetter}}] extended attribute, then
1180911809
return <emu-val>undefined</emu-val>.
1181011810
1. If |attribute| is declared with a [{{PutForwards}}] extended attribute, then:
1181111811
1. Let |Q| be [=?=] <a abstract-op>Get</a>(|esValue|, |id|).

0 commit comments

Comments
 (0)