webdriverio 8.3.10 → 8.4.0

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

@@ -16,42 +16,13 @@ import type { Selector, ElementArray } from '../../types.js';
  *
  * :::
  *
- * <example>
-    :index.html
-    <ul id="menu">
-        <li><a href="/">Home</a></li>
-        <li><a href="/">Developer Guide</a></li>
-        <li><a href="/">API</a></li>
-        <li><a href="/">Contribute</a></li>
-    </ul>
-    :$.js
-    it('should get text a menu link', async () => {
-        const text = await $$('#menu')[0];
-        console.log(await text.$$('li')[2].$('a').getText()); // outputs: "API"
-    });
-
-    it('should get text a menu link - JS Function', async () => {
-        const text = await $$(function() { // Arrow function is not allowed here.
-            // this is Window https://developer.mozilla.org/en-US/docs/Web/API/Window
-            // TypeScript users may do something like this
-            // return (this as Window).document.querySelectorAll('#menu')
-            return this.document.querySelectorAll('#menu'); // Element[]
-        })[0];
-        console.log(await text.$$('li')[2].$('a').getText()); // outputs: "API"
-    });
-
-    it('can create element array out of single elements', async () => {
-        const red = await $('.red');
-        const green = await $('.green');
-        const elems = $$([red, green]);
-        console.log(await elems.map((e) => e.getAttribute('class')));
-        // returns "[ 'box red ui-droppable', 'box green' ]"
-    });
- * </example>
- *
  * @alias $$
  * @param {String|Function} selector  selector or JS Function to fetch multiple elements
  * @return {ElementArray}
+ * @example https://github.com/webdriverio/example-recipes/blob/59c122c809d44d343c231bde2af7e8456c8f086c/queryElements/example.html
+ * @example https://github.com/webdriverio/example-recipes/blob/59c122c809d44d343c231bde2af7e8456c8f086c/queryElements/multipleElements.js#L6-L7
+ * @example https://github.com/webdriverio/example-recipes/blob/59c122c809d44d343c231bde2af7e8456c8f086c/queryElements/multipleElements.js#L15-L24
+ * @example https://github.com/webdriverio/example-recipes/blob/59c122c809d44d343c231bde2af7e8456c8f086c/queryElements/multipleElements.js#L32-L39
  * @type utility
  *
  */

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

@@ -1 +1 @@
-{"version":3,"file":"$$.d.ts","sourceRoot":"","sources":["../../../src/commands/browser/$$.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAIvD,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,wBAAsB,EAAE,CACpB,IAAI,EAAE,WAAW,CAAC,OAAO,GAAG,WAAW,CAAC,OAAO,EAC/C,QAAQ,EAAE,QAAQ,GAAG,gBAAgB,EAAE,GAAG,WAAW,CAAC,OAAO,EAAE,GAAG,WAAW,EAAE,yBAkBlF"}
+{"version":3,"file":"$$.d.ts","sourceRoot":"","sources":["../../../src/commands/browser/$$.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAIvD,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,EAAE,CACpB,IAAI,EAAE,WAAW,CAAC,OAAO,GAAG,WAAW,CAAC,OAAO,EAC/C,QAAQ,EAAE,QAAQ,GAAG,gBAAgB,EAAE,GAAG,WAAW,CAAC,OAAO,EAAE,GAAG,WAAW,EAAE,yBAkBlF"}

package/build/commands/browser/$$.js

@@ -16,42 +16,13 @@ import { getElements } from '../../utils/getElementObject.js';
  *
  * :::
  *
- * <example>
-    :index.html
-    <ul id="menu">
-        <li><a href="/">Home</a></li>
-        <li><a href="/">Developer Guide</a></li>
-        <li><a href="/">API</a></li>
-        <li><a href="/">Contribute</a></li>
-    </ul>
-    :$.js
-    it('should get text a menu link', async () => {
-        const text = await $$('#menu')[0];
-        console.log(await text.$$('li')[2].$('a').getText()); // outputs: "API"
-    });
-
-    it('should get text a menu link - JS Function', async () => {
-        const text = await $$(function() { // Arrow function is not allowed here.
-            // this is Window https://developer.mozilla.org/en-US/docs/Web/API/Window
-            // TypeScript users may do something like this
-            // return (this as Window).document.querySelectorAll('#menu')
-            return this.document.querySelectorAll('#menu'); // Element[]
-        })[0];
-        console.log(await text.$$('li')[2].$('a').getText()); // outputs: "API"
-    });
-
-    it('can create element array out of single elements', async () => {
-        const red = await $('.red');
-        const green = await $('.green');
-        const elems = $$([red, green]);
-        console.log(await elems.map((e) => e.getAttribute('class')));
-        // returns "[ 'box red ui-droppable', 'box green' ]"
-    });
- * </example>
- *
  * @alias $$
  * @param {String|Function} selector  selector or JS Function to fetch multiple elements
  * @return {ElementArray}
+ * @example https://github.com/webdriverio/example-recipes/blob/59c122c809d44d343c231bde2af7e8456c8f086c/queryElements/example.html
+ * @example https://github.com/webdriverio/example-recipes/blob/59c122c809d44d343c231bde2af7e8456c8f086c/queryElements/multipleElements.js#L6-L7
+ * @example https://github.com/webdriverio/example-recipes/blob/59c122c809d44d343c231bde2af7e8456c8f086c/queryElements/multipleElements.js#L15-L24
+ * @example https://github.com/webdriverio/example-recipes/blob/59c122c809d44d343c231bde2af7e8456c8f086c/queryElements/multipleElements.js#L32-L39
  * @type utility
  *
  */

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

@@ -23,34 +23,7 @@ import type { Selector } from '../../types.js';
  * :::
  *
  * <example>
-    :index.html
-    <ul id="menu">
-        <li><a href="/">Home</a></li>
-        <li><a href="/">Developer Guide</a></li>
-        <li><a href="/">API</a></li>
-        <li><a href="/">Contribute</a></li>
-    </ul>
     :$.js
-    it('should get text a menu link', async () => {
-        const text = await $('#menu');
-        console.log(await text.$$('li')[2].$('a').getText()); // outputs: "API"
-    });
-
-    it('should get text a menu link - JS Function', async () => {
-        const text = await $(function() { // Arrow function is not allowed here.
-            // this is Window https://developer.mozilla.org/en-US/docs/Web/API/Window
-            // TypeScript users may do something like this
-            // return (this as Window).document.querySelector('#menu')
-            return this.document.querySelector('#menu'); // Element
-        });
-        console.log(await text.$$('li')[2].$('a').getText()); // outputs: "API"
-    });
-
-    it('should allow to convert protocol result of an element into a WebdriverIO element', async () => {
-        const activeElement = await browser.getActiveElement();
-        console.log(await $(activeElement).getTagName()); // outputs active element
-    });
-
     it('should use Androids DataMatcher or ViewMatcher selector', async () => {
         const menuItem = await $({
             "name": "hasEntry",
@@ -70,6 +43,10 @@ import type { Selector } from '../../types.js';
  * @alias $
  * @param {String|Function|Matcher} selector  selector, JS Function, or Matcher object to fetch a certain element
  * @return {Element}
+ * @example https://github.com/webdriverio/example-recipes/blob/59c122c809d44d343c231bde2af7e8456c8f086c/queryElements/example.html
+ * @example https://github.com/webdriverio/example-recipes/blob/59c122c809d44d343c231bde2af7e8456c8f086c/queryElements/singleElements.js#L9-L10
+ * @example https://github.com/webdriverio/example-recipes/blob/59c122c809d44d343c231bde2af7e8456c8f086c/queryElements/singleElements.js#L16-L25
+ * @example https://github.com/webdriverio/example-recipes/blob/59c122c809d44d343c231bde2af7e8456c8f086c/queryElements/singleElements.js#L42-L46
  * @type utility
  *
  */

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

@@ -1 +1 @@
-{"version":3,"file":"$.d.ts","sourceRoot":"","sources":["../../../src/commands/browser/$.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAG9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyEG;AACH,wBAAsB,CAAC,CACnB,IAAI,EAAE,WAAW,CAAC,OAAO,GAAG,WAAW,CAAC,OAAO,EAC/C,QAAQ,EAAE,QAAQ,GACnB,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAc9B"}
+{"version":3,"file":"$.d.ts","sourceRoot":"","sources":["../../../src/commands/browser/$.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAG9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,wBAAsB,CAAC,CACnB,IAAI,EAAE,WAAW,CAAC,OAAO,GAAG,WAAW,CAAC,OAAO,EAC/C,QAAQ,EAAE,QAAQ,GACnB,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAc9B"}

package/build/commands/browser/$.js

@@ -25,34 +25,7 @@ import { ELEMENT_KEY } from '../../constants.js';
  * :::
  *
  * <example>
-    :index.html
-    <ul id="menu">
-        <li><a href="/">Home</a></li>
-        <li><a href="/">Developer Guide</a></li>
-        <li><a href="/">API</a></li>
-        <li><a href="/">Contribute</a></li>
-    </ul>
     :$.js
-    it('should get text a menu link', async () => {
-        const text = await $('#menu');
-        console.log(await text.$$('li')[2].$('a').getText()); // outputs: "API"
-    });
-
-    it('should get text a menu link - JS Function', async () => {
-        const text = await $(function() { // Arrow function is not allowed here.
-            // this is Window https://developer.mozilla.org/en-US/docs/Web/API/Window
-            // TypeScript users may do something like this
-            // return (this as Window).document.querySelector('#menu')
-            return this.document.querySelector('#menu'); // Element
-        });
-        console.log(await text.$$('li')[2].$('a').getText()); // outputs: "API"
-    });
-
-    it('should allow to convert protocol result of an element into a WebdriverIO element', async () => {
-        const activeElement = await browser.getActiveElement();
-        console.log(await $(activeElement).getTagName()); // outputs active element
-    });
-
     it('should use Androids DataMatcher or ViewMatcher selector', async () => {
         const menuItem = await $({
             "name": "hasEntry",
@@ -72,6 +45,10 @@ import { ELEMENT_KEY } from '../../constants.js';
  * @alias $
  * @param {String|Function|Matcher} selector  selector, JS Function, or Matcher object to fetch a certain element
  * @return {Element}
+ * @example https://github.com/webdriverio/example-recipes/blob/59c122c809d44d343c231bde2af7e8456c8f086c/queryElements/example.html
+ * @example https://github.com/webdriverio/example-recipes/blob/59c122c809d44d343c231bde2af7e8456c8f086c/queryElements/singleElements.js#L9-L10
+ * @example https://github.com/webdriverio/example-recipes/blob/59c122c809d44d343c231bde2af7e8456c8f086c/queryElements/singleElements.js#L16-L25
+ * @example https://github.com/webdriverio/example-recipes/blob/59c122c809d44d343c231bde2af7e8456c8f086c/queryElements/singleElements.js#L42-L46
  * @type utility
  *
  */

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

@@ -57,7 +57,7 @@ import { KeyAction, PointerAction, WheelAction } from '../../utils/actions/index
  * specified when invoking the `action` command, e.g.:
  *
  * ```ts
- * browser.action('pointer'. {
+ * browser.action('pointer', {
  *     parameters: { pointerType: 'mouse' } // "mouse" is default value, also possible: "pen" or "touch"
  * })
  * ```

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

@@ -2,44 +2,11 @@
  * Delete cookies visible to the current page. By providing a cookie name it
  * just removes the single cookie or more when multiple names are passed.
  *
- * <example>
-    :deleteCookie.js
-    it('should delete cookies', async () => {
-        await browser.setCookies([
-            {name: 'test', value: '123'},
-            {name: 'test2', value: '456'},
-            {name: 'test3', value: '789'}
-        ])
-
-        let cookies = await browser.getCookies()
-        console.log(cookies)
-        // outputs:
-        // [
-        //     { name: 'test', value: '123' },
-        //     { name: 'test2', value: '456' }
-        //     { name: 'test3', value: '789' }
-        // ]
-
-        await browser.deleteCookies(['test3'])
-        cookies = await browser.getCookies()
-        console.log(cookies)
-        // outputs:
-        // [
-        //     { name: 'test', value: '123' },
-        //     { name: 'test2', value: '456' }
-        // ]
-
-        await browser.deleteCookies()
-        cookies = await browser.getCookies()
-        console.log(cookies) // outputs: []
-    })
- * </example>
- *
  * @alias browser.deleteCookies
  * @param {String | String[]} names  names of cookies to be deleted
  * @uses webdriver/deleteAllCookies,webdriver/deleteCookie
- * @type cookie
- *
+ * @example https://github.com/webdriverio/example-recipes/blob/e8b147e88e7a38351b0918b4f7efbd9ae292201d/deleteCookies/example.js#L9-L29
+ * @example https://github.com/webdriverio/example-recipes/blob/e8b147e88e7a38351b0918b4f7efbd9ae292201d/deleteCookies/example.js#L31-L35
  */
 export declare function deleteCookies(this: WebdriverIO.Browser, names?: string | string[]): Promise<void> | Promise<void[]>;
 //# sourceMappingURL=deleteCookies.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"deleteCookies.d.ts","sourceRoot":"","sources":["../../../src/commands/browser/deleteCookies.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,aAAa,CACzB,IAAI,EAAE,WAAW,CAAC,OAAO,EACzB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,mCAa5B"}
+{"version":3,"file":"deleteCookies.d.ts","sourceRoot":"","sources":["../../../src/commands/browser/deleteCookies.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CACzB,IAAI,EAAE,WAAW,CAAC,OAAO,EACzB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,mCAa5B"}

package/build/commands/browser/deleteCookies.js

@@ -2,44 +2,11 @@
  * Delete cookies visible to the current page. By providing a cookie name it
  * just removes the single cookie or more when multiple names are passed.
  *
- * <example>
-    :deleteCookie.js
-    it('should delete cookies', async () => {
-        await browser.setCookies([
-            {name: 'test', value: '123'},
-            {name: 'test2', value: '456'},
-            {name: 'test3', value: '789'}
-        ])
-
-        let cookies = await browser.getCookies()
-        console.log(cookies)
-        // outputs:
-        // [
-        //     { name: 'test', value: '123' },
-        //     { name: 'test2', value: '456' }
-        //     { name: 'test3', value: '789' }
-        // ]
-
-        await browser.deleteCookies(['test3'])
-        cookies = await browser.getCookies()
-        console.log(cookies)
-        // outputs:
-        // [
-        //     { name: 'test', value: '123' },
-        //     { name: 'test2', value: '456' }
-        // ]
-
-        await browser.deleteCookies()
-        cookies = await browser.getCookies()
-        console.log(cookies) // outputs: []
-    })
- * </example>
- *
  * @alias browser.deleteCookies
  * @param {String | String[]} names  names of cookies to be deleted
  * @uses webdriver/deleteAllCookies,webdriver/deleteCookie
- * @type cookie
- *
+ * @example https://github.com/webdriverio/example-recipes/blob/e8b147e88e7a38351b0918b4f7efbd9ae292201d/deleteCookies/example.js#L9-L29
+ * @example https://github.com/webdriverio/example-recipes/blob/e8b147e88e7a38351b0918b4f7efbd9ae292201d/deleteCookies/example.js#L31-L35
  */
 export function deleteCookies(names) {
     if (names === undefined) {

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

@@ -14,24 +14,9 @@
  *
  * :::
  *
- * <example>
-    :keys.js
-    import { Key } from 'webdriverio'
-
-    it('copies text out of active element', async () => {
-        await $('#username').setValue('anonymous')
-
-        // copies text from an input element
-        await browser.keys([Key.Ctrl, 'a', 'c])
-
-        // inserts text from clipboard into input element
-        await $('#username').click() // make input active element
-        await browser.keys([Key.Ctrl, 'v'])
-    });
- * </example>
- *
  * @param {String|String[]} value  The sequence of keys to type. An array or string must be provided.
  * @see https://w3c.github.io/webdriver/#dispatching-actions
+ * @example https://github.com/webdriverio/example-recipes/blob/355434bdef13d29608d6d5fbfbeaa034c8a2aa74/keys/keys.js#L1-L17
  *
  */
 export declare function keys(this: WebdriverIO.Browser, value: string | string[]): Promise<void>;

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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,IAAI,CAChB,IAAI,EAAE,WAAW,CAAC,OAAO,EACzB,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,iBAiC3B"}
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../../src/commands/browser/keys.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,IAAI,CAChB,IAAI,EAAE,WAAW,CAAC,OAAO,EACzB,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,iBAiC3B"}

package/build/commands/browser/keys.js

@@ -15,24 +15,9 @@ import { checkUnicode } from '../../utils/index.js';
  *
  * :::
  *
- * <example>
-    :keys.js
-    import { Key } from 'webdriverio'
-
-    it('copies text out of active element', async () => {
-        await $('#username').setValue('anonymous')
-
-        // copies text from an input element
-        await browser.keys([Key.Ctrl, 'a', 'c])
-
-        // inserts text from clipboard into input element
-        await $('#username').click() // make input active element
-        await browser.keys([Key.Ctrl, 'v'])
-    });
- * </example>
- *
  * @param {String|String[]} value  The sequence of keys to type. An array or string must be provided.
  * @see https://w3c.github.io/webdriver/#dispatching-actions
+ * @example https://github.com/webdriverio/example-recipes/blob/355434bdef13d29608d6d5fbfbeaa034c8a2aa74/keys/keys.js#L1-L17
  *
  */
 export function keys(value) {

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

@@ -5,28 +5,6 @@ import type { WaitUntilOptions } from '../../types.js';
  *
  * A common example is to wait until a certain element contains a certain text (see example).
  *
- * <example>
-    :example.html
-    <div id="someText">I am some text</div>
-    <script>
-      setTimeout(() => {
-        await $('#someText').html('I am now different');
-      }, 1000);
-    </script>
-
-    :waitUntil.js
-    it('should wait until text has changed', async () => {
-        await browser.waitUntil(
-            async () => (await $('#someText').getText()) === 'I am now different',
-            {
-                timeout: 5000,
-                timeoutMsg: 'expected text to be different after 5s'
-            }
-        );
-    });
- * </example>
- *
- *
  * @alias browser.waitUntil
  * @param {Function}          condition  condition to wait on until returning a truthy value
  * @param {WaitUntilOptions=} options    command options
@@ -35,6 +13,8 @@ import type { WaitUntilOptions } from '../../types.js';
  * @param {Number=}           options.interval    interval between condition checks (default: 500)
  * @return {Boolean} true if condition is fulfilled
  * @uses utility/pause
+ * @example https://github.com/webdriverio/example-recipes/blob/0bfb2b8d212b627a2659b10f4449184b657e1d59/waitUntil/index.html#L3-L8
+ * @example https://github.com/webdriverio/example-recipes/blob/0bfb2b8d212b627a2659b10f4449184b657e1d59/waitUntil/waitUntilExample.js#L6-L14
  * @type utility
  *
  */

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

@@ -1 +1 @@
-{"version":3,"file":"waitUntil.d.ts","sourceRoot":"","sources":["../../../src/commands/browser/waitUntil.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,SAAS,CAAC,WAAW,EACjC,IAAI,EAAE,WAAW,CAAC,OAAO,GAAG,WAAW,CAAC,OAAO,EAC/C,SAAS,EAAE,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,EACnD,EACI,OAAqC,EACrC,QAAuC,EACvC,UAAU,EACb,GAAE,OAAO,CAAC,gBAAgB,CAAM,GAClC,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CA4BxC"}
+{"version":3,"file":"waitUntil.d.ts","sourceRoot":"","sources":["../../../src/commands/browser/waitUntil.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEtD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,SAAS,CAAC,WAAW,EACjC,IAAI,EAAE,WAAW,CAAC,OAAO,GAAG,WAAW,CAAC,OAAO,EAC/C,SAAS,EAAE,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,EACnD,EACI,OAAqC,EACrC,QAAuC,EACvC,UAAU,EACb,GAAE,OAAO,CAAC,gBAAgB,CAAM,GAClC,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CA4BxC"}

package/build/commands/browser/waitUntil.js

@@ -5,28 +5,6 @@ import Timer from '../../utils/Timer.js';
  *
  * A common example is to wait until a certain element contains a certain text (see example).
  *
- * <example>
-    :example.html
-    <div id="someText">I am some text</div>
-    <script>
-      setTimeout(() => {
-        await $('#someText').html('I am now different');
-      }, 1000);
-    </script>
-
-    :waitUntil.js
-    it('should wait until text has changed', async () => {
-        await browser.waitUntil(
-            async () => (await $('#someText').getText()) === 'I am now different',
-            {
-                timeout: 5000,
-                timeoutMsg: 'expected text to be different after 5s'
-            }
-        );
-    });
- * </example>
- *
- *
  * @alias browser.waitUntil
  * @param {Function}          condition  condition to wait on until returning a truthy value
  * @param {WaitUntilOptions=} options    command options
@@ -35,6 +13,8 @@ import Timer from '../../utils/Timer.js';
  * @param {Number=}           options.interval    interval between condition checks (default: 500)
  * @return {Boolean} true if condition is fulfilled
  * @uses utility/pause
+ * @example https://github.com/webdriverio/example-recipes/blob/0bfb2b8d212b627a2659b10f4449184b657e1d59/waitUntil/index.html#L3-L8
+ * @example https://github.com/webdriverio/example-recipes/blob/0bfb2b8d212b627a2659b10f4449184b657e1d59/waitUntil/waitUntilExample.js#L6-L14
  * @type utility
  *
  */

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

@@ -9,35 +9,13 @@
  *
  * :::
  *
- * <example>
-    :index.html
-    <ul id="menu">
-        <li><a href="/">Home</a></li>
-        <li><a href="/">Developer Guide</a></li>
-        <li><a href="/">API</a></li>
-        <li><a href="/">Contribute</a></li>
-    </ul>
-    :$.js
-    it('should get text a menu link', async () => {
-        const text = await $('#menu');
-        console.log(await text.$$('li')[2].$('a').getText()); // outputs: "API"
-    });
-
-    it('should get text a menu link - JS Function', async () => {
-        const text = await $('#menu');
-        console.log(await text.$$(function() { // Arrow function is not allowed here.
-            // this is Element https://developer.mozilla.org/en-US/docs/Web/API/Element
-            // in this particular example it is HTMLUListElement
-            // TypeScript users may do something like this
-            // return (this as Element).querySelectorAll('li')
-            return this.querySelectorAll('li'); // Element[]
-        })[2].$('a').getText()); // outputs: "API"
-    });
- * </example>
- *
  * @alias $$
  * @param {String|Function|Matcher} selector  selector, JS Function, or Matcher object to fetch multiple elements
  * @return {ElementArray}
+ * @example https://github.com/webdriverio/example-recipes/blob/59c122c809d44d343c231bde2af7e8456c8f086c/queryElements/example.html
+ * @example https://github.com/webdriverio/example-recipes/blob/59c122c809d44d343c231bde2af7e8456c8f086c/queryElements/multipleElements.js#L6-L7
+ * @example https://github.com/webdriverio/example-recipes/blob/59c122c809d44d343c231bde2af7e8456c8f086c/queryElements/multipleElements.js#L15-L24
+ * @example https://github.com/webdriverio/example-recipes/blob/59c122c809d44d343c231bde2af7e8456c8f086c/queryElements/multipleElements.js#L32-L39
  * @type utility
  *
  */

package/build/commands/element/$$.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"$$.d.ts","sourceRoot":"","sources":["../../../src/commands/element/$$.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,OAAO,EAAE,EAAE,IAAI,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAClD,eAAO,MAAM,EAAE,kBAAY,CAAA"}
+{"version":3,"file":"$$.d.ts","sourceRoot":"","sources":["../../../src/commands/element/$$.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAE,EAAE,IAAI,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAClD,eAAO,MAAM,EAAE,kBAAY,CAAA"}

package/build/commands/element/$$.js

@@ -9,35 +9,13 @@
  *
  * :::
  *
- * <example>
-    :index.html
-    <ul id="menu">
-        <li><a href="/">Home</a></li>
-        <li><a href="/">Developer Guide</a></li>
-        <li><a href="/">API</a></li>
-        <li><a href="/">Contribute</a></li>
-    </ul>
-    :$.js
-    it('should get text a menu link', async () => {
-        const text = await $('#menu');
-        console.log(await text.$$('li')[2].$('a').getText()); // outputs: "API"
-    });
-
-    it('should get text a menu link - JS Function', async () => {
-        const text = await $('#menu');
-        console.log(await text.$$(function() { // Arrow function is not allowed here.
-            // this is Element https://developer.mozilla.org/en-US/docs/Web/API/Element
-            // in this particular example it is HTMLUListElement
-            // TypeScript users may do something like this
-            // return (this as Element).querySelectorAll('li')
-            return this.querySelectorAll('li'); // Element[]
-        })[2].$('a').getText()); // outputs: "API"
-    });
- * </example>
- *
  * @alias $$
  * @param {String|Function|Matcher} selector  selector, JS Function, or Matcher object to fetch multiple elements
  * @return {ElementArray}
+ * @example https://github.com/webdriverio/example-recipes/blob/59c122c809d44d343c231bde2af7e8456c8f086c/queryElements/example.html
+ * @example https://github.com/webdriverio/example-recipes/blob/59c122c809d44d343c231bde2af7e8456c8f086c/queryElements/multipleElements.js#L6-L7
+ * @example https://github.com/webdriverio/example-recipes/blob/59c122c809d44d343c231bde2af7e8456c8f086c/queryElements/multipleElements.js#L15-L24
+ * @example https://github.com/webdriverio/example-recipes/blob/59c122c809d44d343c231bde2af7e8456c8f086c/queryElements/multipleElements.js#L32-L39
  * @type utility
  *
  */

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

@@ -16,35 +16,7 @@
  * :::
  *
  * <example>
-    :index.html
-    <ul id="menu">
-        <li><a href="/">Home</a></li>
-        <li><a href="/">Developer Guide</a></li>
-        <li><a href="/">API</a></li>
-        <li><a href="/">Contribute</a></li>
-    </ul>
     :$.js
-    it('should get text a menu link', async () => {
-        const text = await $('#menu');
-        console.log(await text.$$('li')[2].$('a').getText()); // outputs: "API"
-    });
-
-    it('should get text a menu link - JS Function', async () => {
-        const text = await $('#menu');
-        console.log(await text.$$('li')[2].$(function() { // Arrow function is not allowed here.
-            // this is Element https://developer.mozilla.org/en-US/docs/Web/API/Element
-            // in this particular example it is HTMLLIElement
-            // TypeScript users may do something like this
-            // return (this as Element).querySelector('a')
-            return this.querySelector('a'); // Element
-        }).getText()); // outputs: "API"
-    });
-
-    it('should allow to convert protocol result of an element into a WebdriverIO element', async () => {
-        const activeElement = await browser.getActiveElement();
-        console.log(await $(activeElement).getTagName()); // outputs active element
-    });
-
     it('should use Androids DataMatcher or ViewMatcher selector', async () => {
         const menuItem = await $({
             "name": "hasEntry",
@@ -64,6 +36,10 @@
  * @alias $
  * @param {String|Function|Matcher} selector  selector, JS Function, or Matcher object to fetch a certain element
  * @return {Element}
+ * @example https://github.com/webdriverio/example-recipes/blob/59c122c809d44d343c231bde2af7e8456c8f086c/queryElements/example.html
+ * @example https://github.com/webdriverio/example-recipes/blob/59c122c809d44d343c231bde2af7e8456c8f086c/queryElements/singleElements.js#L9-L10
+ * @example https://github.com/webdriverio/example-recipes/blob/59c122c809d44d343c231bde2af7e8456c8f086c/queryElements/singleElements.js#L16-L25
+ * @example https://github.com/webdriverio/example-recipes/blob/59c122c809d44d343c231bde2af7e8456c8f086c/queryElements/singleElements.js#L42-L46
  * @type utility
  *
  */

package/build/commands/element/$.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"$.d.ts","sourceRoot":"","sources":["../../../src/commands/element/$.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoEG;AACH,OAAO,EAAE,CAAC,IAAI,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC/C,eAAO,MAAM,CAAC,iBAAW,CAAA"}
+{"version":3,"file":"$.d.ts","sourceRoot":"","sources":["../../../src/commands/element/$.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,OAAO,EAAE,CAAC,IAAI,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC/C,eAAO,MAAM,CAAC,iBAAW,CAAA"}

package/build/commands/element/$.js

@@ -16,35 +16,7 @@
  * :::
  *
  * <example>
-    :index.html
-    <ul id="menu">
-        <li><a href="/">Home</a></li>
-        <li><a href="/">Developer Guide</a></li>
-        <li><a href="/">API</a></li>
-        <li><a href="/">Contribute</a></li>
-    </ul>
     :$.js
-    it('should get text a menu link', async () => {
-        const text = await $('#menu');
-        console.log(await text.$$('li')[2].$('a').getText()); // outputs: "API"
-    });
-
-    it('should get text a menu link - JS Function', async () => {
-        const text = await $('#menu');
-        console.log(await text.$$('li')[2].$(function() { // Arrow function is not allowed here.
-            // this is Element https://developer.mozilla.org/en-US/docs/Web/API/Element
-            // in this particular example it is HTMLLIElement
-            // TypeScript users may do something like this
-            // return (this as Element).querySelector('a')
-            return this.querySelector('a'); // Element
-        }).getText()); // outputs: "API"
-    });
-
-    it('should allow to convert protocol result of an element into a WebdriverIO element', async () => {
-        const activeElement = await browser.getActiveElement();
-        console.log(await $(activeElement).getTagName()); // outputs active element
-    });
-
     it('should use Androids DataMatcher or ViewMatcher selector', async () => {
         const menuItem = await $({
             "name": "hasEntry",
@@ -64,6 +36,10 @@
  * @alias $
  * @param {String|Function|Matcher} selector  selector, JS Function, or Matcher object to fetch a certain element
  * @return {Element}
+ * @example https://github.com/webdriverio/example-recipes/blob/59c122c809d44d343c231bde2af7e8456c8f086c/queryElements/example.html
+ * @example https://github.com/webdriverio/example-recipes/blob/59c122c809d44d343c231bde2af7e8456c8f086c/queryElements/singleElements.js#L9-L10
+ * @example https://github.com/webdriverio/example-recipes/blob/59c122c809d44d343c231bde2af7e8456c8f086c/queryElements/singleElements.js#L16-L25
+ * @example https://github.com/webdriverio/example-recipes/blob/59c122c809d44d343c231bde2af7e8456c8f086c/queryElements/singleElements.js#L42-L46
  * @type utility
  *
  */

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

@@ -10,25 +10,6 @@ import type { WaitForOptions } from '../../types.js';
  *
  * :::
  *
- * <example>
-    :index.html
-    <div id="elem" style="visibility: hidden;">Hello World!</div>
-    <script type="text/javascript">
-        setTimeout(() => {
-            document.getElementById('elem').style.visibility = 'visible';
-        }, 2000);
-    </script>
-    :waitForDisplayedExample.js
-    it('should detect when element is visible', async () => {
-        const elem = await $('#elem')
-        await elem.waitForDisplayed({ timeout: 3000 });
-    });
-    it('should detect when element is no longer visible', async () => {
-        const elem = await $('#elem')
-        await elem.waitForDisplayed({ reverse: true });
-    });
- * </example>
- *
  * @alias element.waitForDisplayed
  * @param {WaitForOptions=}  options             waitForEnabled options (optional)
  * @param {Number=}          options.timeout     time in ms (default: 500)
@@ -37,8 +18,9 @@ import type { WaitForOptions } from '../../types.js';
  * @param {Number=}          options.interval    interval between checks (default: `waitforInterval`)
  * @return {Boolean} true     if element is displayed (or doesn't if flag is set)
  * @uses utility/waitUntil, state/isDisplayed
+ * @example https://github.com/webdriverio/example-recipes/blob/0bfb2b8d212b627a2659b10f4449184b657e1d59/waitForDisplayed/index.html#L3-L8
+ * @example https://github.com/webdriverio/example-recipes/blob/9ac16b4d4cf4bc8ec87f6369439a2d0bcaae4483/waitForDisplayed/waitForDisplayedExample.js#L6-L14
  * @type utility
- *
  */
 export declare function waitForDisplayed(this: WebdriverIO.Element, { timeout, interval, reverse, timeoutMsg }?: WaitForOptions): Promise<never>;
 //# sourceMappingURL=waitForDisplayed.d.ts.map

package/build/commands/element/waitForDisplayed.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"waitForDisplayed.d.ts","sourceRoot":"","sources":["../../../src/commands/element/waitForDisplayed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAsB,gBAAgB,CAClC,IAAI,EAAE,WAAW,CAAC,OAAO,EACzB,EACI,OAAqC,EACrC,QAAuC,EACvC,OAAe,EACf,UAAsG,EACzG,GAAE,cAAmB,kBAMzB"}
+{"version":3,"file":"waitForDisplayed.d.ts","sourceRoot":"","sources":["../../../src/commands/element/waitForDisplayed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAEpD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,gBAAgB,CAClC,IAAI,EAAE,WAAW,CAAC,OAAO,EACzB,EACI,OAAqC,EACrC,QAAuC,EACvC,OAAe,EACf,UAAsG,EACzG,GAAE,cAAmB,kBAMzB"}

package/build/commands/element/waitForDisplayed.js

@@ -9,25 +9,6 @@
  *
  * :::
  *
- * <example>
-    :index.html
-    <div id="elem" style="visibility: hidden;">Hello World!</div>
-    <script type="text/javascript">
-        setTimeout(() => {
-            document.getElementById('elem').style.visibility = 'visible';
-        }, 2000);
-    </script>
-    :waitForDisplayedExample.js
-    it('should detect when element is visible', async () => {
-        const elem = await $('#elem')
-        await elem.waitForDisplayed({ timeout: 3000 });
-    });
-    it('should detect when element is no longer visible', async () => {
-        const elem = await $('#elem')
-        await elem.waitForDisplayed({ reverse: true });
-    });
- * </example>
- *
  * @alias element.waitForDisplayed
  * @param {WaitForOptions=}  options             waitForEnabled options (optional)
  * @param {Number=}          options.timeout     time in ms (default: 500)
@@ -36,8 +17,9 @@
  * @param {Number=}          options.interval    interval between checks (default: `waitforInterval`)
  * @return {Boolean} true     if element is displayed (or doesn't if flag is set)
  * @uses utility/waitUntil, state/isDisplayed
+ * @example https://github.com/webdriverio/example-recipes/blob/0bfb2b8d212b627a2659b10f4449184b657e1d59/waitForDisplayed/index.html#L3-L8
+ * @example https://github.com/webdriverio/example-recipes/blob/9ac16b4d4cf4bc8ec87f6369439a2d0bcaae4483/waitForDisplayed/waitForDisplayedExample.js#L6-L14
  * @type utility
- *
  */
 export async function waitForDisplayed({ timeout = this.options.waitforTimeout, interval = this.options.waitforInterval, reverse = false, timeoutMsg = `element ("${this.selector}") still ${reverse ? '' : 'not '}displayed after ${timeout}ms` } = {}) {
     return this.waitUntil(async () => reverse !== await this.isDisplayed(), { timeout, interval, timeoutMsg });

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

@@ -12,27 +12,6 @@
  *
  * A common example is to wait until a certain element contains a certain text (see example).
  *
- * <example>
-    :example.html
-    <div id="someText">I am some text</div>
-    <script>
-      setTimeout(() => {
-        await $('#someText').html('I am now different');
-      }, 1000);
-    </script>
-
-    :waitUntil.js
-    it('should wait until text has changed', async () => {
-        const elem = await $('#someText')
-        await elem.waitUntil(async function () {
-            return (await this.getText()) === 'I am now different'
-        }, {
-            timeout: 5000,
-            timeoutMsg: 'expected text to be different after 5s'
-        });
-    });
- * </example>
- *
  * @alias element.waitUntil
  * @param {Function#Boolean}  condition  condition to wait on
  * @param {WaitUntilOptions=} options    command options
@@ -40,6 +19,8 @@
  * @param {String=}           options.timeoutMsg  error message to throw when waitUntil times out
  * @param {Number=}           options.interval    interval between condition checks (default: 500)
  * @return {Boolean} true if condition is fulfilled
+ * @example https://github.com/webdriverio/example-recipes/blob/0bfb2b8d212b627a2659b10f4449184b657e1d59/waitUntil/index.html#L3-L8
+ * @example https://github.com/webdriverio/example-recipes/blob/0bfb2b8d212b627a2659b10f4449184b657e1d59/waitUntil/waitUntilExample.js#L6-L14
  * @type utility
  *
  */

package/build/commands/element/waitUntil.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"waitUntil.d.ts","sourceRoot":"","sources":["../../../src/commands/element/waitUntil.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,OAAO,EAAE,SAAS,IAAI,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AACvE,eAAO,MAAM,SAAS,yBAAmB,CAAA"}
+{"version":3,"file":"waitUntil.d.ts","sourceRoot":"","sources":["../../../src/commands/element/waitUntil.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EAAE,SAAS,IAAI,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AACvE,eAAO,MAAM,SAAS,yBAAmB,CAAA"}

package/build/commands/element/waitUntil.js

@@ -12,27 +12,6 @@
  *
  * A common example is to wait until a certain element contains a certain text (see example).
  *
- * <example>
-    :example.html
-    <div id="someText">I am some text</div>
-    <script>
-      setTimeout(() => {
-        await $('#someText').html('I am now different');
-      }, 1000);
-    </script>
-
-    :waitUntil.js
-    it('should wait until text has changed', async () => {
-        const elem = await $('#someText')
-        await elem.waitUntil(async function () {
-            return (await this.getText()) === 'I am now different'
-        }, {
-            timeout: 5000,
-            timeoutMsg: 'expected text to be different after 5s'
-        });
-    });
- * </example>
- *
  * @alias element.waitUntil
  * @param {Function#Boolean}  condition  condition to wait on
  * @param {WaitUntilOptions=} options    command options
@@ -40,6 +19,8 @@
  * @param {String=}           options.timeoutMsg  error message to throw when waitUntil times out
  * @param {Number=}           options.interval    interval between condition checks (default: 500)
  * @return {Boolean} true if condition is fulfilled
+ * @example https://github.com/webdriverio/example-recipes/blob/0bfb2b8d212b627a2659b10f4449184b657e1d59/waitUntil/index.html#L3-L8
+ * @example https://github.com/webdriverio/example-recipes/blob/0bfb2b8d212b627a2659b10f4449184b657e1d59/waitUntil/waitUntilExample.js#L6-L14
  * @type utility
  *
  */

package/build/utils/actions/pointer.d.ts

@@ -28,7 +28,7 @@ declare const MOVE_PARAM_DEFAULTS: {
     x: number;
     y: number;
     duration: number;
-    origin: WebdriverIO.Element | ElementReference | Element | Origin | ChainablePromiseElement<Element>;
+    origin: WebdriverIO.Element | ElementReference | ChainablePromiseElement<WebdriverIO.Element> | Origin;
 };
 type PointerActionParams = Partial<typeof PARAM_DEFAULTS> & Partial<PointerActionUpParams>;
 type PointerActionMoveParams = Partial<typeof MOVE_PARAM_DEFAULTS> & PointerActionParams;

package/build/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AACvD,OAAO,KAAK,EAAE,OAAO,EAAgB,MAAM,aAAa,CAAA;AAOxD,OAAO,KAAK,EAAE,YAAY,EAAmB,QAAQ,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAA;AAOpH,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,MAAM;QAAG,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;KAAE;CACnE;AAiBD;;GAEG;AACH,eAAO,MAAM,YAAY,UAAW,SAAS,GAAG,SAAS,uCAexD,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,QAAS,gBAAgB,kBAuB3D,CAAA;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAE,IAAI,EAAE,WAAW,CAAC,OAAO,GAAG,WAAW,CAAC,OAAO,GAAG,WAAW,CAAC,OAAO,CAGtG;AAWD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAE,gBAAgB,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,kBAkDvE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAE,KAAK,EAAE,MAAM,EAAE,UAAU,UAAQ,YAc9D;AAmBD,wBAAgB,SAAS,CAAE,CAAC,EAAE,QAAQ,gBAMrC;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC7B,IAAI,EAAE,WAAW,CAAC,OAAO,GAAG,WAAW,CAAC,OAAO,EAC/C,QAAQ,EAAE,QAAQ,qCAsErB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAC9B,IAAI,EAAE,WAAW,CAAC,OAAO,GAAG,WAAW,CAAC,OAAO,EAC/C,QAAQ,EAAE,QAAQ,+BAkDrB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,GAAG,OAkBpD;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,iDAuC9D;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,UAInD;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,iBAK3D;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAE,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAcnE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAE,KAAK,EAAE,WAAW,CAAC,OAAO;;;GAK5D;AAED,wBAAsB,YAAY,CAAE,OAAO,EAAE,WAAW,CAAC,OAAO,oBAkB/D;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,GAAG,WAAW,CAAC,kBAAkB,UACnF,MAAM,mBAAmB,MAAM,SAAS,WAAW,KAAK,wBAAwB,UAOjG;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,aACnB,YAAY,UACd,YAAY,OAAO,GAAG,mBAAmB,YACvC,QAAQ,GAAG,gBAAgB,EAAE,GAAG,mBAAmB,EAAE,8BAExD,GAAG,EAAE,iBAcf,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,MAAM,wBAAyB,MAAM,YAAgD,CAAA;AAElG,eAAO,MAAM,qBAAqB,WAAkB,mBAAmB,GAAG,QAAQ,UAAU,wCAmE3F,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,WACnB,mBAAmB,GAAG,QAAQ,UAAU,uBAC3B,QAAQ,kBAAkB,SAKlD,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,SACvB,OAAO,MAAM,EAAE,MAAM,CAAC,SACrB,OAAO,MAAM,EAAE,MAAM,CAAC,YAShC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AACvD,OAAO,KAAK,EAAE,OAAO,EAAgB,MAAM,aAAa,CAAA;AAOxD,OAAO,KAAK,EAAE,YAAY,EAAmB,QAAQ,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAA;AAOpH,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,MAAM;QAAG,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;KAAE;CACnE;AAiBD;;GAEG;AACH,eAAO,MAAM,YAAY,UAAW,SAAS,GAAG,SAAS,uCAexD,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,QAAS,gBAAgB,kBAuB3D,CAAA;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAE,IAAI,EAAE,WAAW,CAAC,OAAO,GAAG,WAAW,CAAC,OAAO,GAAG,WAAW,CAAC,OAAO,CAGtG;AAWD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAE,gBAAgB,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,kBAkDvE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAE,KAAK,EAAE,MAAM,EAAE,UAAU,UAAQ,YAoB9D;AAmBD,wBAAgB,SAAS,CAAE,CAAC,EAAE,QAAQ,gBAMrC;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC7B,IAAI,EAAE,WAAW,CAAC,OAAO,GAAG,WAAW,CAAC,OAAO,EAC/C,QAAQ,EAAE,QAAQ,qCAsErB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAC9B,IAAI,EAAE,WAAW,CAAC,OAAO,GAAG,WAAW,CAAC,OAAO,EAC/C,QAAQ,EAAE,QAAQ,+BAkDrB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,GAAG,OAkBpD;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,iDAuC9D;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,UAInD;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,iBAK3D;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAE,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAcnE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAE,KAAK,EAAE,WAAW,CAAC,OAAO;;;GAK5D;AAED,wBAAsB,YAAY,CAAE,OAAO,EAAE,WAAW,CAAC,OAAO,oBAkB/D;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,GAAG,WAAW,CAAC,kBAAkB,UACnF,MAAM,mBAAmB,MAAM,SAAS,WAAW,KAAK,wBAAwB,UAOjG;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,aACnB,YAAY,UACd,YAAY,OAAO,GAAG,mBAAmB,YACvC,QAAQ,GAAG,gBAAgB,EAAE,GAAG,mBAAmB,EAAE,8BAExD,GAAG,EAAE,iBAcf,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,MAAM,wBAAyB,MAAM,YAAgD,CAAA;AAElG,eAAO,MAAM,qBAAqB,WAAkB,mBAAmB,GAAG,QAAQ,UAAU,wCAmE3F,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,WACnB,mBAAmB,GAAG,QAAQ,UAAU,uBAC3B,QAAQ,kBAAkB,SAKlD,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,SACvB,OAAO,MAAM,EAAE,MAAM,CAAC,SACrB,OAAO,MAAM,EAAE,MAAM,CAAC,YAShC,CAAA"}

package/build/utils/index.js

@@ -12,7 +12,7 @@ import { UNICODE_CHARACTERS } from '@wdio/utils';
 import * as browserCommands from '../commands/browser.js';
 import * as elementCommands from '../commands/element.js';
 import querySelectorAllDeep from './thirdParty/querySelectorShadowDom.js';
-import { ELEMENT_KEY, DRIVER_DEFAULT_ENDPOINT, DEEP_SELECTOR } from '../constants.js';
+import { ELEMENT_KEY, DRIVER_DEFAULT_ENDPOINT, DEEP_SELECTOR, Key } from '../constants.js';
 import { findStrategy } from './findStrategy.js';
 const log = logger('webdriverio');
 const INVALID_SELECTOR_ERROR = 'selector needs to be typeof `string` or `function`';
@@ -144,6 +144,12 @@ export function parseCSS(cssPropertyValue, cssProperty) {
  * @return {Array}         set of characters or unicode symbols
  */
 export function checkUnicode(value, isDevTools = false) {
+    /**
+     * "Ctrl" key is specially handled based on OS in action class
+     */
+    if (value === Key.Ctrl) {
+        return [value];
+    }
     /**
      * when sending emoji characters like 😄 or a value that is not a special character defined
      * by the WebDriver protocol

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "webdriverio",
   "description": "Next-gen browser and mobile automation test framework for Node.js",
-  "version": "8.3.10",
+  "version": "8.4.0",
   "homepage": "https://webdriver.io",
   "author": "Christian Bromann <mail@bromann.dev>",
   "license": "MIT",
@@ -67,30 +67,30 @@
   },
   "dependencies": {
     "@types/node": "^18.0.0",
-    "@wdio/config": "8.3.2",
+    "@wdio/config": "8.4.0",
     "@wdio/logger": "8.1.0",
-    "@wdio/protocols": "8.3.5",
+    "@wdio/protocols": "8.3.11",
     "@wdio/repl": "8.1.0",
-    "@wdio/types": "8.3.0",
-    "@wdio/utils": "8.3.0",
+    "@wdio/types": "8.4.0",
+    "@wdio/utils": "8.4.0",
     "archiver": "^5.0.0",
     "aria-query": "^5.0.0",
     "css-shorthand-properties": "^1.1.1",
     "css-value": "^0.0.1",
-    "devtools": "8.3.8",
-    "devtools-protocol": "^0.0.1103684",
+    "devtools": "8.4.0",
+    "devtools-protocol": "^0.0.1109433",
     "grapheme-splitter": "^1.0.2",
     "import-meta-resolve": "^2.1.0",
     "is-plain-obj": "^4.1.0",
     "lodash.clonedeep": "^4.5.0",
     "lodash.zip": "^4.2.0",
-    "minimatch": "^6.1.4",
-    "puppeteer-core": "19.6.3",
+    "minimatch": "^7.0.0",
+    "puppeteer-core": "19.7.2",
     "query-selector-shadow-dom": "^1.0.0",
     "resq": "^1.9.1",
     "rgb2hex": "0.2.5",
     "serialize-error": "^8.0.0",
-    "webdriver": "8.3.8"
+    "webdriver": "8.4.0"
   },
-  "gitHead": "5135fb86e53dcbfca0a5935eda4b44aa3ca46dc2"
+  "gitHead": "5d003ce35250c9d9dcecc9fd13a97257d6b349fe"
 }