webdriverio 9.27.1 → 9.27.2

package/build/commands/browser/action.d.ts

@@ -42,14 +42,15 @@ import { KeyAction, PointerAction, WheelAction } from '../../utils/actions/index
  * #### Special Characters
  *
  * If you like to use special characters like e.g. `Control`, `Page Up` or `Shift`, make sure to import the
- * [`Key`](https://github.com/webdriverio/webdriverio/blob/main/packages/webdriverio/src/constants.ts#L352-L417) object
- * from the `webdriverio` package like so:
+ * [`Key`](/docs/api/modules#key) object from the `webdriverio` package like so:
  *
  * ```ts
  * import { Key } from 'webdriverio'
  * ```
  *
- * The object allows you to access the unicode representation of the desired special character.
+ * The `Key` object provides constants for all special keys including `Key.Ctrl` (cross-platform), `Key.Enter`,
+ * `Key.Tab`, `Key.ArrowLeft`, arrow keys, function keys, and more. See the [Key API docs](/docs/api/modules#key)
+ * for a complete list.
  *
  * ### Pointer input source
  *

package/build/commands/browser/action.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../../src/commands/browser/action.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAChF,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAEpF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmJG;AACH,wBAAgB,MAAM,CAClB,IAAI,EAAE,WAAW,CAAC,OAAO,EACzB,IAAI,EAAE,KAAK,EACX,IAAI,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,GACpC,SAAS,CAAA;AACZ,wBAAgB,MAAM,CAClB,IAAI,EAAE,WAAW,CAAC,OAAO,EACzB,IAAI,EAAE,SAAS,EACf,IAAI,CAAC,EAAE,gBAAgB,GACxB,aAAa,CAAA;AAChB,wBAAgB,MAAM,CAClB,IAAI,EAAE,WAAW,CAAC,OAAO,EACzB,IAAI,EAAE,OAAO,EACb,IAAI,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,GACpC,WAAW,CAAA"}
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../../src/commands/browser/action.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAChF,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAEpF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoJG;AACH,wBAAgB,MAAM,CAClB,IAAI,EAAE,WAAW,CAAC,OAAO,EACzB,IAAI,EAAE,KAAK,EACX,IAAI,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,GACpC,SAAS,CAAA;AACZ,wBAAgB,MAAM,CAClB,IAAI,EAAE,WAAW,CAAC,OAAO,EACzB,IAAI,EAAE,SAAS,EACf,IAAI,CAAC,EAAE,gBAAgB,GACxB,aAAa,CAAA;AAChB,wBAAgB,MAAM,CAClB,IAAI,EAAE,WAAW,CAAC,OAAO,EACzB,IAAI,EAAE,OAAO,EACb,IAAI,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,GACpC,WAAW,CAAA"}

package/build/commands/browser/keys.d.ts

@@ -1,16 +1,31 @@
 /**
  *
  * Send a sequence of key strokes to the "active" element. You can make an input element active by just clicking
- * on it. To use characters like "Left arrow" or "Back space", import the `Key` object from the WebdriverIO package.
+ * on it. To use special characters like "ArrowLeft", "Enter", or "Backspace", import the `Key` object from the WebdriverIO package:
  *
- * Modifier like `Control`, `Shift`, `Alt` and `Command` will stay pressed throughout the sequence and will be released
+ * ```js
+ * import { Key } from 'webdriverio'
+ * ```
+ *
+ * The `Key` object provides constants for all special keys including:
+ * - Navigation: `Key.ArrowLeft`, `Key.ArrowUp`, `Key.ArrowRight`, `Key.ArrowDown`, `Key.PageUp`, `Key.PageDown`, `Key.Home`, `Key.End`
+ * - Editing: `Key.Enter`, `Key.Tab`, `Key.Backspace`, `Key.Delete`, `Key.Insert`
+ * - Modifiers: `Key.Ctrl` (cross-platform), `Key.Shift`, `Key.Alt`, `Key.Control`, `Key.Command`
+ * - Function keys: `Key.F1` through `Key.F12`
+ * - Numpad: `Key.Numpad0` through `Key.Numpad9`, `Key.Multiply`, `Key.Add`, `Key.Subtract`, `Key.Divide`
+ * - And more: `Key.Escape`, `Key.Space`, `Key.Clear`, `Key.Pause`, etc.
+ *
+ * See the [Key API docs](/docs/api/modules#key) for a complete list.
+ *
+ * Modifier keys like `Control`, `Shift`, `Alt` and `Command` will stay pressed throughout the sequence and will be released
  * at the end. Modifying a click requires you to use the WebDriver Actions API through the
  * [performActions](https://webdriver.io/docs/api/webdriver#performactions) method.
  *
- * :::info
+ * :::info Cross-Platform Modifier
  *
- * Control keys differ based on the operating system the browser is running on, e.g. MacOS: `Command` and Windows: `Control`.
- * WebdriverIO provides a cross browser modifier control key called `Ctrl` (see example below).
+ * The `Key.Ctrl` constant provides a convenient way to use the "control" modifier across different operating systems.
+ * On macOS, it maps to the `Command` key, while on Windows and Linux it maps to the `Control` key.
+ * This is useful for keyboard shortcuts like select-all (`[Key.Ctrl, 'a']`), copy, or paste.
  *
  * :::
  *

package/build/commands/browser/keys.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../../src/commands/browser/keys.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,IAAI,CACtB,IAAI,EAAE,WAAW,CAAC,OAAO,EACzB,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GACzB,OAAO,CAAC,IAAI,CAAC,CAiCf"}
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../../src/commands/browser/keys.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAsB,IAAI,CACtB,IAAI,EAAE,WAAW,CAAC,OAAO,EACzB,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GACzB,OAAO,CAAC,IAAI,CAAC,CAiCf"}

package/build/commands/element/addValue.d.ts

@@ -6,7 +6,7 @@ import type { InputOptions } from '../../types.js';
  * :::info
  *
  * If you like to use special characters, e.g. to copy and paste a value from one input to another, use the
- * [`keys`](/docs/api/browser/keys) command.
+ * [`keys`](/docs/api/browser/keys) command with the [`Key`](/docs/api/modules#key) object.
  *
  * :::
  *

package/build/commands/element/setValue.d.ts

@@ -6,7 +6,7 @@ import type { InputOptions } from '../../types.js';
  * :::info
  *
  * If you like to use special characters, e.g. to copy and paste a value from one input to another, use the
- * [`keys`](/docs/api/browser/keys) command.
+ * [`keys`](/docs/api/browser/keys) command with the [`Key`](/docs/api/modules#key) object.
  *
  * :::
  *

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "webdriverio",
   "description": "Next-gen browser and mobile automation test framework for Node.js",
-  "version": "9.27.1",
+  "version": "9.27.2",
   "homepage": "https://webdriver.io",
   "author": "Christian Bromann <mail@bromann.dev>",
   "license": "MIT",
@@ -77,12 +77,12 @@
   "dependencies": {
     "@types/node": "^20.11.30",
     "@types/sinonjs__fake-timers": "^8.1.5",
-    "@wdio/config": "9.27.1",
+    "@wdio/config": "9.27.2",
     "@wdio/logger": "9.18.0",
-    "@wdio/protocols": "9.27.1",
+    "@wdio/protocols": "9.27.2",
     "@wdio/repl": "9.16.2",
-    "@wdio/types": "9.27.1",
-    "@wdio/utils": "9.27.1",
+    "@wdio/types": "9.27.2",
+    "@wdio/utils": "9.27.2",
     "archiver": "^7.0.1",
     "aria-query": "^5.3.0",
     "cheerio": "^1.0.0-rc.12",
@@ -99,7 +99,7 @@
     "rgb2hex": "0.2.5",
     "serialize-error": "^12.0.0",
     "urlpattern-polyfill": "^10.0.0",
-    "webdriver": "9.27.1"
+    "webdriver": "9.27.2"
   },
   "peerDependencies": {
     "puppeteer-core": ">=22.x || <=24.x"
@@ -109,5 +109,5 @@
       "optional": true
     }
   },
-  "gitHead": "e2b5652f61da0858251860e7d3bc0c0aaffbb525"
+  "gitHead": "a95ab41f3ac1fd9510341a21d365a359528212ac"
 }