feat(Element): implemented send chord function and test

Sources/SwiftWebDriver/API/Request/Elements/ElementsTypes.swift

@@ -1,5 +1,5 @@
 // ElementsTypes.swift
-// Copyright (c) 2025 GetAutomaApp
+// Copyright (c) 2026 GetAutomaApp
 // All source code and related assets are the property of GetAutomaApp.
 // All rights reserved.
 
@@ -17,19 +17,43 @@
         /// The **Enter** key (Unicode: `\u{E007}`).
         ///
         /// Typically used to submit forms or trigger button actions in web pages.
         case ENTER1 = "\u{E007}"
 
         /// The **Return** key (Unicode: `\u{E006}`).
         ///
         /// Often treated similarly to `Enter`, but provided as a separate code
         /// for systems that distinguish between them.
         case RETURN1 = "\u{E006}"
 
         /// The **Tab** key (Unicode: `\u{E004}`).
         ///
         /// Used to move focus between interactive elements (e.g., form fields) in a web page.
         case TAB = "\u{E004}"
 
+        case NULL = "\u{E000}"
+        case CANCEL = "\u{E001}"
+        case HELP = "\u{E002}"
+        case BACKSPACE = "\u{E003}"
+        case CLEAR = "\u{E005}"
+        case SHIFT = "\u{E008}"
+        case CONTROL = "\u{E009}"
+        case ALT = "\u{E00A}"
+        case PAUSE = "\u{E00B}"
+        case ESCAPE = "\u{E00C}"
+        case SPACE = "\u{E00D}"
+        case PAGE_UP = "\u{E00E}"
+        case PAGE_DOWN = "\u{E00F}"
+        case END = "\u{E010}"
+        case HOME = "\u{E011}"
+        case LEFT_ARROW = "\u{E012}"
+        case UP_ARROW = "\u{E013}"
+        case RIGHT_ARROW = "\u{E014}"
+        case DOWN_ARROW = "\u{E015}"
+        case INSERT = "\u{E016}"
+        case DELETE = "\u{E017}"
+        case F1 = "\u{E031}"
+        case F2 = "\u{E032}"
+
         /// The raw Unicode representation of the key.
         ///
         /// This string value is what will be sent to the WebDriver `sendKeys`

Sources/SwiftWebDriver/Element/Element.swift

@@ -1,5 +1,5 @@
 // Element.swift
-// Copyright (c) 2025 GetAutomaApp
+// Copyright (c) 2026 GetAutomaApp
 // All source code and related assets are the property of GetAutomaApp.
 // All rights reserved.
 
@@ -264,6 +264,23 @@ public struct Element: ElementCommandProtocol, Sendable {
         return response.value
     }
 
+    @discardableResult
+    @available(macOS 10.15, iOS 13.0, watchOS 6.0, tvOS 13.0, *)
+    public func sendKeys(
+        keys: ElementsTypes.SendValueActionKeyTypes...,
+        characters: String = ""
+    ) async throws -> String? {
+        let text = keys.map(\.rawValue).joined() + characters
+        let request = PostElementSendValueRequest(
+            baseURL: baseURL,
+            sessionId: sessionId,
+            elementId: elementId,
+            text: text
+        )
+        let response = try await APIClient.shared.request(request)
+        return response.value
+    }
+
     /// Takes a screenshot of the element.
     ///
     /// - Returns: A Base64-encoded string representing the image.

Tests/SwiftWebDriverIntegrationTests/ChromeDriver/Element/ChromeDriverElementHandleIntegrationTests.swift

@@ -1,5 +1,5 @@
 // ChromeDriverElementHandleIntegrationTests.swift
-// Copyright (c) 2025 GetAutomaApp
+// Copyright (c) 2026 GetAutomaApp
 // All source code and related assets are the property of GetAutomaApp.
 // All rights reserved.
 
@@ -95,6 +95,22 @@ internal class ChromeDriverElementHandleIntegrationTests: ChromeDriverTest {
         #expect(text == "newValue")
     }
 
+    @Test("Send Chord")
+    public func sendChord() async throws {
+        page = "elementHandleTestPage.html"
+        try await driver.navigateTo(urlString: testPageURL.absoluteString)
+        let element = try await driver.findElement(.css(.id("sendValue")))
+        try await element.send(value: "newValue")
+        let text = try await driver.execute("return document.querySelector('#sendValue').value").value?.stringValue
+        #expect(text == "newValue")
+
+        // Remove text from element
+        try await element.sendKeys(keys: .CONTROL, characters: "a")
+        try await element.sendKeys(keys: .BACKSPACE)
+        let newText = try await driver.execute("return document.querySelector('#sendValue').value").value?.stringValue
+        #expect(newText == "")
+    }
+
     @Test("Get Screenshot")
     public func getScreenshot() async throws {
         page = "elementHandleTestPage.html"