feat: input get value

Author: nathanfallet

README.md

@@ -47,7 +47,7 @@ To use kdriver, add the following to your `build.gradle.kts`:
 
 ```kotlin
 dependencies {
- implementation("dev.kdriver:core:0.3.0")
+ implementation("dev.kdriver:core:0.3.1")
 }
 ```
 

build.gradle.kts

@@ -6,7 +6,7 @@ plugins {
 
 allprojects {
  group = "dev.kdriver"
- version = "0.3.0"
+ version = "0.3.1"
  project.ext.set("url", "https://github.com/cdpdriver/kdriver")
  project.ext.set("license.name", "Apache 2.0")
  project.ext.set("license.url", "https://www.apache.org/licenses/LICENSE-2.0.txt")

core/src/commonMain/kotlin/dev/kdriver/core/dom/DefaultElement.kt

@@ -183,6 +183,10 @@ open class DefaultElement(
  )
  }
 
+ override suspend fun getInputValue(): String? {
+ return apply<String>("(el) => el.value")
+ }
+
  override suspend fun clearInput() {
  apply<Unit>("function (element) { element.value = \"\" }")
  }

core/src/commonMain/kotlin/dev/kdriver/core/dom/Element.kt

@@ -159,6 +159,15 @@ interface Element {
  */
  suspend fun sendFile(paths: List<Path>)
 
+ /**
+ * Retrieves the value of the element, typically used for input fields.
+ *
+ * This method applies a JavaScript function to get the `value` property of the element.
+ *
+ * @return The value of the element, or null if it does not have a value.
+ */
+ suspend fun getInputValue(): String?
+
  /**
  * Clears the input of the element by setting its value to an empty string.
  *

core/src/jvmTest/kotlin/dev/kdriver/core/dom/ElementTest.kt

@@ -0,0 +1,31 @@
+package dev.kdriver.core.dom
+
+import dev.kdriver.core.browser.createBrowser
+import dev.kdriver.core.sampleFile
+import kotlinx.coroutines.runBlocking
+import kotlin.test.Test
+import kotlin.test.assertEquals
+
+class ElementTest {
+
+ @Test
+ fun testInput() = runBlocking {
+ val browser = createBrowser(this, headless = true, sandbox = false)
+ val tab = browser.get(sampleFile("groceries.html"))
+
+ val input = tab.select("#my_input")
+
+ assertEquals("", input.getInputValue())
+ input.insertText("Hello World")
+ assertEquals("Hello World", input.getInputValue())
+ input.clearInput()
+ assertEquals("", input.getInputValue())
+ input.sendKeys("KDriver")
+ assertEquals("KDriver", input.getInputValue())
+ input.clearInputByDeleting()
+ assertEquals("", input.getInputValue())
+
+ browser.stop()
+ }
+
+}

core/src/jvmTest/resources/groceries.html

@@ -37,5 +37,6 @@ <h1>Grocery List</h1>
  <li>Grapes</li>
 </ul>
 <button id="download_file" onclick="downloadGroceryList()">Download List</button>
+<input id="my_input" type="text"/>
 </body>
 </html>

docs/home/quickstart.md

@@ -12,7 +12,7 @@ To install, add the dependency to your `build.gradle.kts`:
 
 ```kotlin
 dependencies {
- implementation("dev.kdriver:core:0.3.0")
+ implementation("dev.kdriver:core:0.3.1")
 }
 ```