Merge pull request #1541 from w3c/issue-1495-patch

getCapabilities behavior with an unsupported value of kind

webrtc.html

@@ -5223,11 +5223,15 @@ <h2>Methods</h2>
             <dt><code>getCapabilities</code>, static</dt>
             <dd>
               <p>The <dfn>getCapabilities()</dfn>
-              method returns the most optimist view on the capabilities of the
+              method returns the most optimistic view of the capabilities of the
               system for sending media of the given kind. It does not reserve
               any resources, ports, or other state but is meant to provide a
               way to discover the types of capabilities of the browser
-              including which codecs may be supported.</p>
+              including which codecs may be supported. User agents
+              MUST support <var>kind</var> values of <code>"audio"</code>
+              and <code>"video"</code>. If the system has no capabilities
+              corresponding to the value of the <var>kind</var>
+              argument, <code>getCapabilities</code> returns <code>null</code>.</p>
               <p class="fingerprint">These capabilities provide generally
               persistent cross-origin information on the device and thus
               increases the fingerprinting surface of the application. In
@@ -6161,7 +6165,11 @@ <h2>Methods</h2>
               the system for receiving media of the given kind. It does not
               reserve any resources, ports, or other state but is meant to
               provide a way to discover the types of capabilities of the
-              browser including which codecs may be supported.</p>
+              browser including which codecs may be supported. User agents
+              MUST support <var>kind</var> values of <code>"audio"</code>
+              and <code>"video"</code>. If the system has no capabilities
+              corresponding to the value of the <var>kind</var> argument,
+              <code>getCapabilities</code> returns <code>null</code>.</p>
               <p class="fingerprint">These capabilities provide generally
               persistent cross-origin information on the device and thus
               increases the fingerprinting surface of the application. In