Adds 'Consume User Activation of Window' via WebDriver

Context: web-platform-tests/wpt#36727.

Closes #8608.

Author: marcoscaceres

source

@@ -76885,6 +76885,44 @@ partial interface <span id="NavigatorUserActivation-partial">Navigator</span> {
   <span>this</span>'s <span>relevant global object</span> has <span>transient activation</span>,
   and false otherwise.</p>
 
+
+  <h4 id="user-activation-user-agent-automation">User agent automation</h4>
+
+  <p>For the purposes of user-agent automation and application testing, this specification defines
+  the following <span>extension command</span> for the <cite>Web Driver</cite> specification. It is
+  optional for a user agent to support the following <span>extension command</span>. <ref
+  spec=WEBDRIVER></p>
+
+  <table class="data">
+   <thead>
+    <tr>
+     <th>HTTP Method</th>
+     <th>URI Template</th>
+    </tr>
+   </thead>
+   <tbody>
+    <tr>
+     <td>`<code data-x="">POST</code>`</td>
+     <td><code data-x="">/session/{<var>session id</var>}/window/consume-user-activation</code></td>
+    </tr>
+   </tbody>
+  </table>
+
+  <p>The <span>remote end steps</span> are:</p>
+
+  <ol>
+   <li><p>Let <var>window</var> be <span data-x="webdriver-current-browsing-context">current
+   browsing context</span>'s <span>active window</span>.</p></li>
+
+   <li><p>Let <var>consume</var> be true if <var>window</var> has <span>transient activation</span>;
+   otherwise false.</p></li>
+
+   <li><p>If <var>consume</var> is true, then <span>consume user activation</span> of
+   <var>window</var>.</p></li>
+
+   <li><p>Return <span data-x="success-value">success</span> with data <var>consume</var>.</p></li>
+  </ol>
+
   </div>
 
 
@@ -133403,7 +133441,7 @@ INSERT INTERFACES HERE
    <dd><cite><a href="https://w3c.github.io/webcrypto/Overview.html">Web Cryptography API</a></cite>, D. Huigens. W3C.</dd>
 
    <dt id="refsWEBDRIVER">[WEBDRIVER]</dt>
-   <dd><cite><a href="https://w3c.github.io/webdriver/">WebDriver</a></cite>. W3C</dd>
+   <dd><cite><a href="https://w3c.github.io/webdriver/">WebDriver</a></cite>, S. Stewart, D. Burns. W3C.</dd>
 
    <dt id="refsWEBDRIVERBIDI">[WEBDRIVERBIDI]</dt>
    <dd><cite><a href="https://w3c.github.io/webdriver-bidi/">WebDriver BiDi</a></cite>. W3C</dd>