SafariDriver supports opening new windows and tabs

This uses an experimental API provided by Apple, and
so is marked as a `@Beta` feature.

Author: shs96c

java/client/src/org/openqa/selenium/safari/SafariDriver.java

@@ -17,11 +17,14 @@
 
 package org.openqa.selenium.safari;
 
+import com.google.common.collect.ImmutableMap;
+
+import org.openqa.selenium.Beta;
 import org.openqa.selenium.Capabilities;
 import org.openqa.selenium.WebDriverException;
 import org.openqa.selenium.remote.FileDetector;
 import org.openqa.selenium.remote.RemoteWebDriver;
-import org.openqa.selenium.remote.service.DriverCommandExecutor;
+import org.openqa.selenium.remote.Response;
 
 /**
  * A WebDriver implementation that controls Safari using a browser extension
@@ -75,7 +78,7 @@ public SafariDriver(SafariDriverService safariService) {
    * @param safariOptions safari specific options / capabilities for the driver
    */
   public SafariDriver(SafariDriverService safariServer, SafariOptions safariOptions) {
-    super(new DriverCommandExecutor(safariServer), safariOptions);
+    super(new SafariDriverCommandExecutor(safariServer), safariOptions);
   }
 
   @Override
@@ -84,4 +87,24 @@ public void setFileDetector(FileDetector detector) {
         "Setting the file detector only works on remote webdriver instances obtained " +
         "via RemoteWebDriver");
   }
+
+  /**
+   * Open either a new tab or window, depending on what is requested, and return the window handle
+   * without switching to it.
+   *
+   * @return The handle of the new window.
+   */
+  @Beta
+  public String newWindow(WindowType type) {
+    Response response = execute(
+        "SAFARI_NEW_WINDOW",
+        ImmutableMap.of("newTab", type == WindowType.TAB));
+
+    return (String) response.getValue();
+  }
+
+  public enum WindowType {
+    TAB,
+    WINDOW,
+  }
 }

java/client/src/org/openqa/selenium/safari/SafariDriverCommandExecutor.java

@@ -0,0 +1,38 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+package org.openqa.selenium.safari;
+
+import static org.openqa.selenium.remote.http.HttpMethod.POST;
+
+import com.google.common.collect.ImmutableMap;
+
+import org.openqa.selenium.remote.CommandInfo;
+import org.openqa.selenium.remote.service.DriverCommandExecutor;
+import org.openqa.selenium.remote.service.DriverService;
+
+import java.util.Map;
+
+class SafariDriverCommandExecutor extends DriverCommandExecutor {
+
+  private static final Map<String, CommandInfo> SAFARI_COMMANDS = ImmutableMap.of(
+      "SAFARI_NEW_WINDOW", new CommandInfo("/session/:sessionId/apple/window/new", POST));
+
+  SafariDriverCommandExecutor(DriverService service) {
+    super(service, SAFARI_COMMANDS);
+  }
+}