@@ -688,56 +688,6 @@ <h2>
688
688
</ li >
689
689
</ ul >
690
690
</ 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 >
741
691
< section id ="conformance "> </ section >
742
692
< section id ="idl-index "> </ section >
743
693
< section class ="informative ">
0 commit comments