webdriverio 8.3.9 → 8.3.11

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cjs/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAgB,MAAM,aAAa,CAAA;AAIxD,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,cAAc,GAAG,SAAS,CAAC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cjs/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAgB,MAAM,aAAa,CAAA;AAuExD,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,cAAc,GAAG,SAAS,CAAC,CAAA"}

package/build/cjs/index.js

@@ -1,3 +1,68 @@
+exports.SevereServiceError = class SevereServiceError extends Error {
+    constructor(message = 'Severe Service Error occurred.') {
+        super(message);
+        this.name = 'SevereServiceError';
+    }
+};
+exports.Key = {
+    Ctrl: 'WDIO_CONTROL',
+    NULL: '\uE000',
+    Cancel: '\uE001',
+    Help: '\uE002',
+    Backspace: '\uE003',
+    Tab: '\uE004',
+    Clear: '\uE005',
+    Return: '\uE006',
+    Enter: '\uE007',
+    Shift: '\uE008',
+    Control: '\uE009',
+    Alt: '\uE00A',
+    Pause: '\uE00B',
+    Escape: '\uE00C',
+    Space: '\uE00D',
+    PageUp: '\uE00E',
+    PageDown: '\uE00F',
+    End: '\uE010',
+    Home: '\uE011',
+    ArrowLeft: '\uE012',
+    ArrowUp: '\uE013',
+    ArrowRight: '\uE014',
+    ArrowDown: '\uE015',
+    Insert: '\uE016',
+    Delete: '\uE017',
+    Semicolon: '\uE018',
+    Equals: '\uE019',
+    Numpad0: '\uE01A',
+    Numpad1: '\uE01B',
+    Numpad2: '\uE01C',
+    Numpad3: '\uE01D',
+    Numpad4: '\uE01E',
+    Numpad5: '\uE01F',
+    Numpad6: '\uE020',
+    Numpad7: '\uE021',
+    Numpad8: '\uE022',
+    Numpad9: '\uE023',
+    Multiply: '\uE024',
+    Add: '\uE025',
+    Separator: '\uE026',
+    Subtract: '\uE027',
+    Decimal: '\uE028',
+    Divide: '\uE029',
+    F1: '\uE031',
+    F2: '\uE032',
+    F3: '\uE033',
+    F4: '\uE034',
+    F5: '\uE035',
+    F6: '\uE036',
+    F7: '\uE037',
+    F8: '\uE038',
+    F9: '\uE039',
+    F10: '\uE03A',
+    F11: '\uE03B',
+    F12: '\uE03C',
+    Command: '\uE03D',
+    ZenkakuHankaku: '\uE040'
+};
 /**
  * A method to create a new session with WebdriverIO.
  *

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/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.9",
+  "version": "8.3.11",
   "homepage": "https://webdriver.io",
   "author": "Christian Bromann <mail@bromann.dev>",
   "license": "MIT",
@@ -67,9 +67,9 @@
   },
   "dependencies": {
     "@types/node": "^18.0.0",
-    "@wdio/config": "8.3.2",
+    "@wdio/config": "8.3.11",
     "@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",
@@ -77,20 +77,20 @@
     "aria-query": "^5.0.0",
     "css-shorthand-properties": "^1.1.1",
     "css-value": "^0.0.1",
-    "devtools": "8.3.8",
+    "devtools": "8.3.11",
     "devtools-protocol": "^0.0.1103684",
     "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.1",
     "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.3.11"
   },
-  "gitHead": "948a4993962f18a6cba4c0fb48a58b176b9fb57c"
+  "gitHead": "d54b501e286d4f2c14b1f0e038d7253bd0c1a9b0"
 }