[bidi] [java] Add script pinning methods (SeleniumHQ#14305)

Author: pujagani

java/src/org/openqa/selenium/remote/RemoteScript.java

@@ -121,4 +121,14 @@ public long addDomMutationHandler(Consumer<DomMutation> consumer) {
   public void removeDomMutationHandler(long id) {
     this.biDi.removeListener(id);
   }
+
+  @Override
+  public String pin(String script) {
+    return this.script.addPreloadScript(script);
+  }
+
+  @Override
+  public void unpin(String id) {
+    this.script.removePreloadScript(id);
+  }
 }

java/src/org/openqa/selenium/remote/Script.java

@@ -36,4 +36,8 @@ public interface Script {
   long addDomMutationHandler(Consumer<DomMutation> event);
 
   void removeDomMutationHandler(long id);
+
+  String pin(String script);
+
+  void unpin(String id);
 }

java/test/org/openqa/selenium/WebScriptTest.java

@@ -245,4 +245,47 @@ void canRemoveDomMutationHandler() throws InterruptedException {
 
     Assertions.assertThat(latch.await(10, SECONDS)).isFalse();
   }
+
+  @Test
+  void canPinScript() throws ExecutionException, InterruptedException, TimeoutException {
+    CompletableFuture<ConsoleLogEntry> future = new CompletableFuture<>();
+
+    ((RemoteWebDriver) driver).script().pin("() => { console.log('Hello!'); }");
+
+    long id = ((RemoteWebDriver) driver).script().addConsoleMessageHandler(future::complete);
+
+    page = server.whereIs("/bidi/logEntryAdded.html");
+    driver.get(page);
+
+    ConsoleLogEntry logEntry = future.get(5, TimeUnit.SECONDS);
+
+    assertThat(logEntry.getText()).isEqualTo("Hello!");
+
+    ((RemoteWebDriver) driver).script().removeConsoleMessageHandler(id);
+  }
+
+  @Test
+  void canUnpinScript() throws ExecutionException, InterruptedException, TimeoutException {
+    CountDownLatch latch = new CountDownLatch(2);
+
+    String pinnedScript =
+        ((RemoteWebDriver) driver).script().pin("() => { console.log('Hello!'); }");
+
+    long id =
+        ((RemoteWebDriver) driver)
+            .script()
+            .addConsoleMessageHandler(consoleLogEntry -> latch.countDown());
+
+    page = server.whereIs("/bidi/logEntryAdded.html");
+
+    driver.get(page);
+
+    ((RemoteWebDriver) driver).script().unpin(pinnedScript);
+
+    driver.get(page);
+
+    assertThat(latch.getCount()).isEqualTo(1L);
+
+    ((RemoteWebDriver) driver).script().removeConsoleMessageHandler(id);
+  }
 }