Add WebDriver automation for custom handlers

Closes whatwg#8251.

Author: javifernandez

source

@@ -4339,6 +4339,24 @@ a.setAttribute('href', 'https://example.com/'); // change the content attribute
     </ul>
    </dd>
 
+   <dt>WebDriver</dt>
+
+   <dd>
+    <p>The following terms are defined in <cite>WebDriver</cite>: <ref spec=WEBDRIVER></p>
+
+    <ul class="brief">
+     <li><dfn data-x-href="https://w3c.github.io/webdriver/#dfn-extension-commands">extension command</dfn></li>
+     <li><dfn data-x-href="https://w3c.github.io/webdriver/#dfn-remote-end-steps">remote end steps</dfn></li>
+     <li><dfn data-x-href="https://w3c.github.io/webdriver/#dfn-errors">WebDriver error</dfn></li>
+     <li><dfn data-x-href="https://w3c.github.io/webdriver/#dfn-error-code">WebDriver error code</dfn></li>
+     <li><dfn data-x-href="https://w3c.github.io/webdriver/#dfn-invalid-argument">invalid argument</dfn></li>
+     <li><dfn data-x-href="https://w3c.github.io/webdriver/#dfn-getting-properties">getting a property</dfn></li>
+     <li><dfn data-x="success-value" data-x-href="https://w3c.github.io/webdriver/#dfn-success">success</dfn></li>
+     <li><dfn data-x-href="https://w3c.github.io/webdriver/#security">WebDriver's security considerations</dfn></li>
+     <li><dfn data-x="webdriver-current-browsing-context" data-x-href="https://w3c.github.io/webdriver/#dfn-current-browsing-context">current browsing context</dfn></li>
+    </ul>
+   </dd>
+
    <dt>WebDriver BiDi</dt>
 
    <dd>
@@ -103074,6 +103092,25 @@ interface <dfn interface>Navigator</dfn> {
     declined such registrations) so that the user is not repeatedly prompted with the same
     request.</p>
 
+    <p>If the <span><code
+    data-x="dom-navigator-registerProtocolHandler">registerProtocolHandler()</code> automation
+    mode</span> of <span>this</span>'s <span>relevant global object</span>'s <span
+    data-x="concept-document-window">associated <code>Document</code></span> is not "<dfn><code
+    data-x="rph-automation-mode-none">none</code></dfn>", the user agent should first verify that it
+    is in an automation context (see <span>WebDriver's security considerations</span>). The user
+    agent should then bypass the above communication of information and gathering of user consent,
+    and instead do the following based on the value of the <span><code
+    data-x="dom-navigator-registerProtocolHandler">registerProtocolHandler()</code> automation
+    mode</span>:</p>
+
+    <dl>
+     <dt>"<dfn data-x="rph-automation-mode-auto-accept"><code>auto-accept</code></dfn>"</dt>
+     <dd><p>Act as if the user has seen the registration details and accepted the request.</p></dd>
+
+     <dt>"<dfn data-x="rph-automation-mode-auto-reject"><code>auto-reject</code></dfn>"</dt>
+     <dd><p>Act as if the user has seen the registration details and rejected the request.</p></dd>
+    </dl>
+
     <p>When the <dfn export data-x="protocol-handler-invocation" data-lt="invoke a protocol
     handler">user agent uses this handler</dfn> for a <span>URL</span> <var>inputURL</var>:</p>
 
@@ -103276,9 +103313,57 @@ interface <dfn interface>Navigator</dfn> {
   button and a "deny" button, with the "accept" binding containing the name of the handler, it's
   important that a long name not cause the "deny" button to be pushed off the screen.</p>
 
-  </div>
+  <h6><dfn id="rph-user-agent-automation">User agent automation</dfn></h6>
 
+  <p>Each <code>Document</code> has a <dfn><code
+  data-x="dom-navigator-registerProtocolHandler">registerProtocolHandler()</code> automation
+  mode</dfn>. It defaults to "<code data-x="rph-automation-mode-none">none</code>", but it also can
+  be either "<code data-x="rph-automation-mode-auto-accept">auto-accept</code>" or "<code
+  data-x="rph-automation-mode-auto-reject">auto-reject</code>".</p>
 
+  <p>For the purposes of user agent automation and website testing, this standard defines <dfn
+  data-x="set-rph-registration-mode">Set RPH Registration Mode</dfn> WebDriver <span>extension
+  command</span>. It instructs the user agent to place a <code>Document</code> into a mode where it
+  will automatically simulate a user either accepting or rejecting and registration confirmation
+  prompt dialog.</p>
+
+  <table class="data">
+   <thead>
+    <tr>
+     <th>HTTP Method
+     <th>URI Template
+   <tbody>
+    <tr>
+     <td>`<code data-x="">POST</code>`
+     <td><code data-x="">/session/{session id}/custom-handlers/set-mode</code>
+  </table>
+
+  <p>The <span>remote end steps</span> are:</p>
+
+  <ol>
+   <li><p>If <var>parameters</var> is not a JSON Object, return a <span>WebDriver error</span> with
+   <span>WebDriver error code</span> <span>invalid argument</span>.</p></li>
+
+   <li><p>Let <var>mode</var> be the result of <span>getting a property</span> named "<code
+   data-x="">mode</code>" from <var>parameters</var>.</p></li>
+
+   <li><p>If <var>mode</var> is not "<code
+   data-x="rph-automation-mode-auto-accept">auto-accept</code>", "<code
+   data-x="rph-automation-mode-auto-reject">auto-reject</code>, or "<code
+   data-x="rph-automation-mode-none">none</code>", return a <span>WebDriver error</span> with
+   <span>WebDriver error code</span> <span>invalid argument</span>.</p></li>
+
+   <li><p>Let <var>document</var> be the <span data-x="webdriver-current-browsing-context">current
+   browsing context</span>'s <span>active document</span>.</p></li>
+
+   <li><p>Set <var>document</var>'s <span><code
+   data-x="dom-navigator-registerProtocolHandler">registerProtocolHandler()</code> automation
+   mode</span> to <var>mode</var>.</p></li>
+
+   <li><p>Return <span data-x="success-value">success</span> with data null.</p></li>
+  </ol>
+
+  </div>
 
   <h5>Cookies</h5>
 
@@ -131342,6 +131427,9 @@ INSERT INTERFACES HERE
    <dt id="refsWEBCRYPTO">[WEBCRYPTO]</dt>
    <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>
+
    <dt id="refsWEBDRIVERBIDI">[WEBDRIVERBIDI]</dt>
    <dd><cite><a href="https://w3c.github.io/webdriver-bidi/">WebDriver BiDi</a></cite>. W3C</dd>