Skip to content

Commit 3f97331

Browse files
Editorial: remove Extensability text (#239)
1 parent c33c7af commit 3f97331

File tree

1 file changed

+0
-50
lines changed

1 file changed

+0
-50
lines changed

index.html

-50
Original file line numberDiff line numberDiff line change
@@ -688,56 +688,6 @@ <h2>
688688
</li>
689689
</ul>
690690
</section>
691-
<section class="appendix informative">
692-
<h2>
693-
Extensibility of this API
694-
</h2>
695-
<p>
696-
The Web Share API is designed to be extended in the future by way of
697-
new members added to the {{ShareData}} dictionary, to allow both
698-
sharing of new types of data (<i>e.g.</i>, <a href=
699-
"https://github.com/w3c/web-share/issues/12">images</a>) and strings
700-
with new semantics (<i>e.g.</i> author).
701-
</p>
702-
<div class="warning">
703-
This doesn't mean user agents can add whatever members they like. It
704-
means that new members can be added to the standard in the future.
705-
</div>
706-
<p>
707-
The three members {{ShareData/title}}, {{ShareData/text}}, and
708-
{{ShareData/url}}, are part of the base feature set, and
709-
implementations that provide {{Navigator/share()}} need to accept all
710-
three. Any new members that are added in the future will be
711-
<em>individually feature-detectable</em>, to allow for
712-
backwards-compatibility with older implementations that don't recognize
713-
those members. These new members might also be added as optional "MAY"
714-
requirements.
715-
</p>
716-
<div class="note">
717-
There is <a href="https://github.com/heycam/webidl/issues/107">an open
718-
discussion</a> about how to provide feature-detection for dictionary
719-
members. Web Share will use the mechanism produced by that discussion.
720-
</div>
721-
<p>
722-
The {{Navigator/share()}} method returns a rejected promise with a
723-
{{TypeError}} if none of the specified members are present. The
724-
intention is that when a new member is added, it will also be added to
725-
this list of recognized members. This is for future-proofing
726-
implementations: if a web site written against a future version of this
727-
spec uses <em>only</em> new members (<i>e.g.</i>,
728-
`navigator.share({image: x})`), it will be valid in future user agents,
729-
but a {{TypeError}} on user agents implementing an older version of the
730-
spec. Developers will be asked to feature-detect any new members they
731-
rely on, to avoid having errors surface in their program.
732-
</p>
733-
<p>
734-
Editors of this spec will want to carefully consider the genericity of
735-
any new members being added, avoiding members that are closely
736-
associated with a particular service, user agent or operating system,
737-
in favour of members that can potentially be applied to a wide range of
738-
platforms and targets.
739-
</p>
740-
</section>
741691
<section id="conformance"></section>
742692
<section id="idl-index"></section>
743693
<section class="informative">

0 commit comments

Comments
 (0)