feat: Return one or many window handles

Docs/SupportedAPIs.md

@@ -67,5 +67,5 @@ Contributions to expand support to unimplemented functionality are always welcom
 | POST   | `/session/:sessionId/window/:windowHandle/position` | Supported    | Not implemented     |
 | GET    | `/session/:sessionId/window/:windowHandle/position` | Supported    | Not implemented     |
 | POST   | `/session/:sessionId/window/:windowHandle/maximize` | Supported    | Not implemented     |
-| GET    | `/session/:sessionId/window_handle`                 | Supported    | Not implemented     |
-| GET    | `/session/:sessionId/window_handles`                | Supported    | Not implemented     |
+| GET    | `/session/:sessionId/window_handle`                 | Supported    | `Session.windowHandle()`|
+| GET    | `/session/:sessionId/window_handles`                | Supported    | `Session.windowHandle()`|

Sources/WebDriver/Requests.swift

@@ -531,4 +531,18 @@ public enum Requests {
 
         public typealias Response = WebDriverStatus
     }
+
+    public struct SessionWindowHandle: Request {
+        public var session: String 
+        public var many: Bool
+
+        public var pathComponents: [String] { ["session", session, many ? "window_handles" : "window_handle"] }
+        public var method: HTTPMethod { .get }
+
+        public typealias Response = ResponseWithValue<ResponseValue>
+        public struct ResponseValue: Codable {
+            public var windowHandle: String
+            public var windowHandles: [String]
+        }
+    }
 }

Sources/WebDriver/Session.swift

@@ -317,6 +317,14 @@ public class Session {
         try webDriver.send(Requests.SessionWindowSize.Post(session: id, windowHandle: handle, width: width, height: height))
     }
 
+    /// 
+    /// - Parameter many: Bool value that will return multiple window handles 
+    /// - Returns: either current window handle or many based on bool flag
+    public func windowHandle(many: Bool) throws -> (windowHandle: String, windowHandles: [String]) {
+        let response = try webDriver.send(Requests.SessionWindowHandle(session: id, many: many))
+        return (windowHandle: response.value.windowHandle, windowHandles: response.value.windowHandles)
+    }
+
     /// Deletes the current session.
     public func delete() throws {
         guard shouldDelete else { return }

Tests/UnitTests/APIToRequestMappingTests.swift

@@ -199,4 +199,24 @@ class APIToRequestMappingTests: XCTestCase {
         }
         XCTAssert(try session.size(window: "myWindow") == (width: 500, height: 500))
     }
+
+    func testWindowHandle() throws {
+        let mockWebDriver: MockWebDriver = MockWebDriver()
+        let session = Session(webDriver: mockWebDriver, existingId: "mySession")
+
+        mockWebDriver.expect(path: "session/mySession/window_handle", method: .get, type: Requests.SessionWindowHandle.self) {
+            ResponseWithValue(.init(windowHandle: "myWindow", windowHandles: []))
+        }
+        XCTAssert(try session.windowHandle(many: false) == (windowHandle: "myWindow", windowHandles: []))
+    }
+
+        func testWindowHandles() throws {
+        let mockWebDriver: MockWebDriver = MockWebDriver()
+        let session = Session(webDriver: mockWebDriver, existingId: "mySession")
+
+        mockWebDriver.expect(path: "session/mySession/window_handles", method: .get, type: Requests.SessionWindowHandle.self) {
+            ResponseWithValue(.init(windowHandle: "", windowHandles: ["myWindow", "myWindow"]))
+        }
+        XCTAssert(try session.windowHandle(many: true) == (windowHandle: "", windowHandles: ["myWindow", "myWindow"]))
+    }
 }