Added support for Element.selected API (#174)

Author: bootuz

Docs/SupportedAPIs.md

@@ -33,7 +33,7 @@ Contributions to expand support to unimplemented functionality are always welcom
 | GET    | `/session/:sessionId/element/:id/location_in_view`  | Supported    | Not implemented     |
 | GET    | `/session/:sessionId/element/:id/name`              | Supported    | Not implemented     |
 | GET    | `/session/:sessionId/element/:id/screenshot`        | Supported    | Not implemented     |
-| GET    | `/session/:sessionId/element/:id/selected`          | Supported    | Not implemented     |
+| GET    | `/session/:sessionId/element/:id/selected`          | Supported    | `Element.selected`  |
 | GET    | `/session/:sessionId/element/:id/size`              | Supported    | `Element.size`      |
 | GET    | `/session/:sessionId/element/:id/text`              | Supported    | `Element.text`      |
 | POST   | `/session/:sessionId/element/:id/value`             | Supported    | `Element.sendKeys()`|

Sources/WebDriver/Element.swift

@@ -53,6 +53,14 @@ public struct Element {
         }
     }
 
+    /// Gets a value indicating whether this element is currently selected.
+    public var selected: Bool {
+        get throws {
+            try webDriver.send(Requests.ElementSelected(
+                session: session.id, element: id)).value
+        }
+    }
+
     /// Clicks this element.
     public func click(retryTimeout: TimeInterval? = nil) throws {
         let request = Requests.ElementClick(session: session.id, element: id)

Sources/WebDriver/Requests.swift

@@ -91,6 +91,18 @@ public enum Requests {
         }
     }
 
+    public struct ElementSelected: Request {
+        public var session: String
+        public var element: String
+        
+        public var pathComponents: [String] { ["session", session, "element", element, "selected"] }
+        public var method: HTTPMethod { .get }
+        
+        public struct Response: Codable {
+            public var value: Bool
+        }
+    }
+
     // https://www.selenium.dev/documentation/legacy/json_wire_protocol/#sessionsessionidelementidvalue
     public struct ElementValue: Request {
         public var session: String

Tests/UnitTests/APIToRequestMappingTests.swift

@@ -190,6 +190,16 @@ class APIToRequestMappingTests: XCTestCase {
         XCTAssert(try element.enabled == true)
     }
 
+    func testElementSelected() throws {
+        let mockWebDriver = MockWebDriver()
+        let session = Session(webDriver: mockWebDriver, existingId: "mySession")
+        let element = Element(session: session, id: "myElement")
+        mockWebDriver.expect(path: "session/mySession/element/myElement/selected", method: .get) {
+            ResponseWithValue(true)
+        }
+        XCTAssert(try element.selected == true)
+    }
+
     func testWindowPosition() throws {
         let mockWebDriver: MockWebDriver = MockWebDriver()
         let session = Session(webDriver: mockWebDriver, existingId: "mySession")