From d6335ec105b859e7a50d228f5ec5ff61eeef6eb1 Mon Sep 17 00:00:00 2001
From: hoodjoshua <141174228+hoodjoshua@users.noreply.github.com>
Date: Thu, 28 Sep 2023 18:30:16 +0000
Subject: [PATCH] Add WebDriver commands for triggering bounce tracking
 mitigations (#63)

---
 index.bs | 50 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 50 insertions(+)

diff --git a/index.bs b/index.bs
index 57e7db1..327443d 100644
--- a/index.bs
+++ b/index.bs
@@ -41,6 +41,11 @@ spec: HTTP; urlPrefix: https://httpwg.org/specs/rfc7231.html#
     type: dfn; text: HTTP 3xx statuses; url: status.3xx
 spec: tracking-dnt; urlPrefix: https://www.w3.org/TR/tracking-dnt/#
     type: dfn; text: tracking; url: dfn-tracking
+spec: WEBDRIVER; urlPrefix: https://w3c.github.io/webdriver/
+    type: dfn
+        text: error code; url: dfn-error-code
+        text: unknown error; url: dfn-unknown-error
+        text: unsupported operation; url: dfn-unsupported-operation
 spec: RFC6265; urlPrefix: https://tools.ietf.org/html/rfc6265/
     type: dfn
         text: cookie store; url: section-5.3
@@ -787,6 +792,51 @@ following steps:
 
 </div>
 
+<h3 id="bounce-tracking-mitigations-automation">User Agent Automation</h3>
+
+For the purposes of user-agent automation and application testing, this
+document defines a number of [extension commands] for the [[WebDriver]]
+specification.
+
+<h4 id="run-bounce-tracking-mitigations-command">Run Bounce Tracking Mitigations</h4>
+
+<figure id="table-webdriver-run-bounce-tracking-mitigations-command" class="table">
+    <table class="data">
+        <thead>
+            <tr>
+                <th>HTTP Method</th>
+                <th>URI Template</th>
+            </tr>
+        </thead>
+        <tbody>
+            <tr>
+                <td>DELETE</td>
+                <td>`/session/{session id}/storage/run_bounce_tracking_mitigations`</td>
+            </tr>
+        </tbody>
+    </table>
+</figure>
+
+The [=remote end steps=] are:
+
+1. If no Bounce Tracking Mitigation Service is currently running, return a [=error|WebDriver error=] with
+    [=error code=] [=unsupported operation=].
+
+1. If the [=stateful bounce tracking map=] contains a malformed host, return a [=error|WebDriver error=] with
+    [=error code=] [=unknown error=].
+
+1. Let |list| be a new list of the [=site=] [=hosts=] in the [=stateful bounce tracking map=].
+
+1. Let |temp| be [=bounce tracking grace period=].
+
+1. Set [=bounce tracking grace period=] to 0 seconds.
+
+1. Run the [=bounce tracking timer=] algorithm.
+
+1. Set [=bounce tracking grace period=] to |temp|.
+
+1. Return [=success=] with data |list|.
+
 <h2 id="privacy-and-security-considerations">Privacy and Security Considerations</h2>
 
 This feature stores information about sites that have a user interaction, some amount of view time, or