Merge pull request #2322 from youennf/split-hostCandidate

Clarify the rules for filtering and split hostCandidate in address and port

webrtc.html

@@ -4944,7 +4944,8 @@ <h4><dfn>RTCPeerConnectionIceErrorEvent</dfn></h4>
 >[Exposed=Window]
 interface RTCPeerConnectionIceErrorEvent : Event {
   constructor(DOMString type, RTCPeerConnectionIceErrorEventInit eventInitDict);
-  readonly attribute DOMString hostCandidate;
+  readonly attribute DOMString? address;
+  readonly attribute unsigned short? port;
   readonly attribute DOMString url;
   readonly attribute unsigned short errorCode;
   readonly attribute USVString errorText;
@@ -4962,18 +4963,26 @@ <h2>Constructors</h2>
             <h2>Attributes</h2>
             <dl data-link-for="RTCPeerConnectionIceErrorEvent" data-dfn-for=
             "RTCPeerConnectionIceErrorEvent" class="attributes">
-              <dt><dfn data-idl><code>hostCandidate</code></dfn> of type <span class=
+              <dt><dfn data-idl><code>address</code></dfn> of type <span class=
               "idlAttrType">DOMString</span>, readonly</dt>
               <dd>
-                <p>The <code>hostCandidate</code> attribute is the local IP
-                address and port used to communicate with the STUN or TURN
+                <p>The <code>address</code> attribute is the local IP
+                address used to communicate with the STUN or TURN
                 server.</p>
                 <p>On a multihomed system, multiple interfaces may be used to
                 contact the server, and this attribute allows the application
                 to figure out on which one the failure occurred.</p>
-                <p>If use of multiple interfaces has been prohibited for
-                privacy reasons, this attribute will be set to 0.0.0.0:0 or
-                [::]:0, as appropriate.</p>
+                <p>If the local IP address value is not already exposed
+                as part of a local candidate, the <code>address</code>
+                attribute will be set to <code>null</code>.</p>
+              </dd>
+              <dt><dfn data-idl><code>port</code></dfn> of type <span class=
+              "idlAttrType">unsigned short</span>, readonly</dt>
+              <dd>
+                <p>The <code>port</code> attribute is the port used to
+                communicate with the STUN or TURN server.</p>
+                <p>If the <code>address</code> attribute is <code>null</code>,
+                 the <code>port</code> attribute is also set to <code>null</code>.</p>
               </dd>
               <dt><dfn data-idl><code>url</code></dfn> of type <span class=
               "idlAttrType">DOMString</span>, readonly</dt>