webdriverio 9.0.0-alpha.114 → 9.0.0-alpha.321

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

@@ -0,0 +1,34 @@
+/**
+ *
+ * Download a file from the remote computer running Selenium node to local file system
+ * by using the [`downloadFile`](https://webdriver.io/docs/api/selenium#downloadFile) command.
+ *
+ * :::info
+ * Note that this command is only supported if you use a
+ * [Selenium Grid](https://www.selenium.dev/documentation/en/grid/) with Chrome, Edge or Firefox
+ * and have the `se:downloadsEnabled` flag set in the capabilities.
+ * :::
+ *
+ * <example>
+ :downloadFile.js
+ it('should download a file', async () => {
+        await browser.url('https://www.selenium.dev/selenium/web/downloads/download.html')
+        await $('#file-1').click()
+        await browser.waitUntil(async function () {
+            return (await browser.getDownloadableFiles()).names.includes('file_1.txt')
+        }, {timeout: 5000})
+        const files = await browser.getDownloadableFiles()
+        const downloaded = await browser.downloadFile(files.names[0], process.cwd())
+        await browser.deleteDownloadableFiles()
+    })
+ * </example>
+ *
+ * @alias browser.downloadFile
+ * @param {string} fileName remote path to file
+ * @param {string} targetDirectory target location on local computer
+ * @type utility
+ * @uses protocol/download
+ *
+ */
+export declare function downloadFile(this: WebdriverIO.Browser, fileName: string, targetDirectory: string): Promise<object>;
+//# sourceMappingURL=downloadFile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"downloadFile.d.ts","sourceRoot":"","sources":["../../../src/commands/browser/downloadFile.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAsB,YAAY,CAC9B,IAAI,EAAE,WAAW,CAAC,OAAO,EACzB,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,GACxB,OAAO,CAAC,MAAM,CAAC,CAgDjB"}

package/build/commands/browser/downloadFile.js

@@ -0,0 +1,79 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import JSZip from 'jszip';
+import logger from '@wdio/logger';
+const log = logger('webdriverio');
+/**
+ *
+ * Download a file from the remote computer running Selenium node to local file system
+ * by using the [`downloadFile`](https://webdriver.io/docs/api/selenium#downloadFile) command.
+ *
+ * :::info
+ * Note that this command is only supported if you use a
+ * [Selenium Grid](https://www.selenium.dev/documentation/en/grid/) with Chrome, Edge or Firefox
+ * and have the `se:downloadsEnabled` flag set in the capabilities.
+ * :::
+ *
+ * <example>
+ :downloadFile.js
+ it('should download a file', async () => {
+        await browser.url('https://www.selenium.dev/selenium/web/downloads/download.html')
+        await $('#file-1').click()
+        await browser.waitUntil(async function () {
+            return (await browser.getDownloadableFiles()).names.includes('file_1.txt')
+        }, {timeout: 5000})
+        const files = await browser.getDownloadableFiles()
+        const downloaded = await browser.downloadFile(files.names[0], process.cwd())
+        await browser.deleteDownloadableFiles()
+    })
+ * </example>
+ *
+ * @alias browser.downloadFile
+ * @param {string} fileName remote path to file
+ * @param {string} targetDirectory target location on local computer
+ * @type utility
+ * @uses protocol/download
+ *
+ */
+export async function downloadFile(fileName, targetDirectory) {
+    /**
+     * parameter check
+     */
+    if (typeof fileName !== 'string' || typeof targetDirectory !== 'string') {
+        throw new Error('number or type of arguments don\'t agree with downloadFile command');
+    }
+    /**
+     * check if command is available
+     */
+    if (typeof this.download !== 'function') {
+        throw new Error(`The downloadFile command is not available in ${this.capabilities.browserName} and only available when using Selenium Grid`);
+    }
+    const response = await this.download(fileName);
+    const base64Content = response.contents;
+    if (!targetDirectory.endsWith('/')) {
+        targetDirectory += '/';
+    }
+    fs.mkdirSync(targetDirectory, { recursive: true });
+    const zipFilePath = path.join(targetDirectory, `${fileName}.zip`);
+    fs.writeFileSync(zipFilePath, Buffer.from(base64Content, 'base64'));
+    const zipData = fs.readFileSync(zipFilePath);
+    const filesData = [];
+    try {
+        const zip = await JSZip.loadAsync(zipData);
+        const keys = Object.keys(zip.files);
+        // Iterate through each file in the zip archive
+        for (let i = 0; i < keys.length; i++) {
+            const fileData = await zip.files[keys[i]].async('nodebuffer');
+            const dir = path.resolve(targetDirectory, keys[i]);
+            fs.writeFileSync(dir, fileData);
+            log.info(`File extracted: ${keys[i]}`);
+            filesData.push(dir);
+        }
+    }
+    catch (error) {
+        log.error('Error unzipping file:', error);
+    }
+    return Promise.resolve({
+        files: filesData
+    });
+}

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

@@ -1,3 +1,4 @@
+import type { Cookie } from '@wdio/protocols';
 /**
  *
  * Retrieve a [cookie](https://w3c.github.io/webdriver/webdriver-spec.html#cookies)
@@ -30,5 +31,5 @@
  * @uses webdriver/getAllCookies
  *
  */
-export declare function getCookies(this: WebdriverIO.Browser, names?: string | string[]): Promise<import("@wdio/protocols").Cookie[]>;
+export declare function getCookies(this: WebdriverIO.Browser, names?: string | string[]): Promise<Cookie[]>;
 //# sourceMappingURL=getCookies.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"getCookies.d.ts","sourceRoot":"","sources":["../../../src/commands/browser/getCookies.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAsB,UAAU,CAC5B,IAAI,EAAE,WAAW,CAAC,OAAO,EACzB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,+CAc5B"}
+{"version":3,"file":"getCookies.d.ts","sourceRoot":"","sources":["../../../src/commands/browser/getCookies.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAC7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAsB,UAAU,CAC5B,IAAI,EAAE,WAAW,CAAC,OAAO,EACzB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAC1B,OAAO,CAAC,MAAM,EAAE,CAAC,CAanB"}

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

@@ -1 +1 @@
-{"version":3,"file":"getPuppeteer.d.ts","sourceRoot":"","sources":["../../../src/commands/browser/getPuppeteer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAa,OAAO,IAAI,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAM5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAsB,YAAY,CAAE,IAAI,EAAE,WAAW,CAAC,OAAO,6BAyG5D"}
+{"version":3,"file":"getPuppeteer.d.ts","sourceRoot":"","sources":["../../../src/commands/browser/getPuppeteer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAa,OAAO,IAAI,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAM5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAsB,YAAY,CAAE,IAAI,EAAE,WAAW,CAAC,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAwGxF"}

package/build/commands/browser/getPuppeteer.js

@@ -47,16 +47,15 @@ export async function getPuppeteer() {
      * check if we already connected Puppeteer and if so return
      * that instance
      */
-    if (this.puppeteer?.isConnected()) {
+    if (this.puppeteer?.connected) {
         log.debug('Reusing existing puppeteer session');
         return this.puppeteer;
     }
     const { headers } = this.options;
-    const caps = this.capabilities.alwaysMatch || this.capabilities;
     /**
      * attach to a Selenium 4 CDP Session if it's returned in the capabilities
      */
-    const cdpEndpoint = caps['se:cdp'];
+    const cdpEndpoint = this.capabilities['se:cdp'];
     if (cdpEndpoint) {
         this.puppeteer = await puppeteer.connect({
             browserWSEndpoint: cdpEndpoint,
@@ -82,7 +81,7 @@ export async function getPuppeteer() {
     /**
      * attach to Chromium debugger session
      */
-    const chromiumOptions = caps['goog:chromeOptions'] || caps['ms:edgeOptions'];
+    const chromiumOptions = this.capabilities['goog:chromeOptions'] || this.capabilities['ms:edgeOptions'];
     if (chromiumOptions && chromiumOptions.debuggerAddress) {
         this.puppeteer = await puppeteer.connect({
             browserURL: `http://${chromiumOptions.debuggerAddress.replace('localhost', '0.0.0.0')}`,
@@ -93,19 +92,19 @@ export async function getPuppeteer() {
     /**
      * attach to Firefox debugger session
      */
-    if (caps.browserName?.toLowerCase() === 'firefox') {
-        if (!caps.browserVersion) {
+    if (this.capabilities.browserName?.toLowerCase() === 'firefox') {
+        if (!this.capabilities.browserVersion) {
             throw new Error('Can\'t find "browserVersion" in capabilities');
         }
-        const majorVersion = parseInt(caps.browserVersion.split('.').shift() || '', 10);
+        const majorVersion = parseInt(this.capabilities.browserVersion.split('.').shift() || '', 10);
         if (majorVersion >= 79) {
             const reqCaps = this.requestedCapabilities.alwaysMatch || this.requestedCapabilities;
             let browserURL;
-            if (caps['moz:debuggerAddress']) {
-                browserURL = caps['moz:debuggerAddress'];
+            if (this.capabilities['moz:debuggerAddress']) {
+                browserURL = this.capabilities['moz:debuggerAddress'];
             }
             else {
-                const ffOptions = caps['moz:firefoxOptions'];
+                const ffOptions = this.capabilities['moz:firefoxOptions'];
                 const ffArgs = reqCaps['moz:firefoxOptions']?.args || [];
                 const rdPort = ffOptions && ffOptions.debuggerAddress
                     ? ffOptions.debuggerAddress

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

@@ -1,4 +1,4 @@
-import type { MockOptions } from '../../utils/interception/types.js';
+import type { MockFilterOptions } from '../../utils/interception/types.js';
 import WebDriverInterception from '../../utils/interception/index.js';
 export declare const SESSION_MOCKS: Record<string, Set<WebDriverInterception>>;
 /**
@@ -107,5 +107,5 @@ export declare const SESSION_MOCKS: Record<string, Set<WebDriverInterception>>;
  * @type utility
  *
  */
-export declare function mock(this: WebdriverIO.Browser, url: string, filterOptions?: MockOptions): Promise<WebdriverIO.Mock>;
+export declare function mock(this: WebdriverIO.Browser, url: string, filterOptions?: MockFilterOptions): Promise<WebdriverIO.Mock>;
 //# sourceMappingURL=mock.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../../src/commands/browser/mock.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAA;AACpE,OAAO,qBAAqB,MAAM,mCAAmC,CAAA;AAErE,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,qBAAqB,CAAC,CAAM,CAAA;AAE3E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyGG;AACH,wBAAsB,IAAI,CACtB,IAAI,EAAE,WAAW,CAAC,OAAO,EACzB,GAAG,EAAE,MAAM,EACX,aAAa,CAAC,EAAE,WAAW,GAC5B,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAa3B"}
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../../src/commands/browser/mock.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAA;AAC1E,OAAO,qBAAqB,MAAM,mCAAmC,CAAA;AAErE,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,qBAAqB,CAAC,CAAM,CAAA;AAE3E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyGG;AACH,wBAAsB,IAAI,CACtB,IAAI,EAAE,WAAW,CAAC,OAAO,EACzB,GAAG,EAAE,MAAM,EACX,aAAa,CAAC,EAAE,iBAAiB,GAClC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAa3B"}

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

@@ -6,6 +6,14 @@
  * Be careful though, this command affects your test time tremendously since spawning
  * new Selenium sessions is very time consuming especially when using cloud services.
  *
+ * Connection parameters such as hostname, port, protocol, etc. can be added along side
+ * browserName when you want to connect to a different remote service. This is useful
+ * in a situation, for example, where you start a test in native app and need to verify
+ * data in web app.
+ *
+ * If you start from remote service, you can pass in 0.0.0.0 for hostname if you want
+ * to switch to local drivers.
+ *
  * <example>
     :reloadSync.js
     it('should reload my session with current capabilities', async () => {
@@ -21,6 +29,18 @@
         })
         console.log(browser.capabilities.browserName) // outputs: firefox
     })
+
+    it('should reload my session with new remote', async () => {
+        console.log(browser.capabilities.browserName) // outputs: chrome
+        await browser.reloadSession({
+            protocol: 'https',
+            host: '0.0.0.1',
+            port: 4444,
+            path: '/wd/hub',
+            browserName: 'firefox'
+        })
+        console.log(browser.capabilities.browserName) // outputs: firefox
+    })
  * </example>
  *
  * @alias browser.reloadSession

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

@@ -1 +1 @@
-{"version":3,"file":"reloadSession.d.ts","sourceRoot":"","sources":["../../../src/commands/browser/reloadSession.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,aAAa,CAAE,IAAI,EAAE,WAAW,CAAC,OAAO,EAAE,eAAe,CAAC,EAAE,WAAW,CAAC,YAAY,mBAoCzG"}
+{"version":3,"file":"reloadSession.d.ts","sourceRoot":"","sources":["../../../src/commands/browser/reloadSession.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,wBAAsB,aAAa,CAAE,IAAI,EAAE,WAAW,CAAC,OAAO,EAAE,eAAe,CAAC,EAAE,WAAW,CAAC,YAAY,mBAoCzG"}

package/build/commands/browser/reloadSession.js

@@ -8,6 +8,14 @@ const log = logger('webdriverio');
  * Be careful though, this command affects your test time tremendously since spawning
  * new Selenium sessions is very time consuming especially when using cloud services.
  *
+ * Connection parameters such as hostname, port, protocol, etc. can be added along side
+ * browserName when you want to connect to a different remote service. This is useful
+ * in a situation, for example, where you start a test in native app and need to verify
+ * data in web app.
+ *
+ * If you start from remote service, you can pass in 0.0.0.0 for hostname if you want
+ * to switch to local drivers.
+ *
  * <example>
     :reloadSync.js
     it('should reload my session with current capabilities', async () => {
@@ -23,6 +31,18 @@ const log = logger('webdriverio');
         })
         console.log(browser.capabilities.browserName) // outputs: firefox
     })
+
+    it('should reload my session with new remote', async () => {
+        console.log(browser.capabilities.browserName) // outputs: chrome
+        await browser.reloadSession({
+            protocol: 'https',
+            host: '0.0.0.1',
+            port: 4444,
+            path: '/wd/hub',
+            browserName: 'firefox'
+        })
+        console.log(browser.capabilities.browserName) // outputs: firefox
+    })
  * </example>
  *
  * @alias browser.reloadSession
@@ -50,7 +70,7 @@ export async function reloadSession(newCapabilities) {
          */
         log.warn(`Suppressing error closing the session: ${err.stack}`);
     }
-    if (this.puppeteer?.isConnected()) {
+    if (this.puppeteer?.connected) {
         this.puppeteer.disconnect();
         log.debug('Disconnected puppeteer session');
     }

package/build/commands/browser.d.ts

@@ -7,6 +7,7 @@ export * from './browser/custom$$.js';
 export * from './browser/custom$.js';
 export * from './browser/debug.js';
 export * from './browser/deleteCookies.js';
+export * from './browser/downloadFile.js';
 export * from './browser/emulate.js';
 export * from './browser/execute.js';
 export * from './browser/executeAsync.js';

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

@@ -1 +1 @@
-{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/commands/browser.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,qBAAqB,CAAA;AACnC,cAAc,sBAAsB,CAAA;AACpC,cAAc,mBAAmB,CAAA;AACjC,cAAc,uBAAuB,CAAA;AACrC,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,sBAAsB,CAAA;AACpC,cAAc,sBAAsB,CAAA;AACpC,cAAc,2BAA2B,CAAA;AACzC,cAAc,yBAAyB,CAAA;AACvC,cAAc,2BAA2B,CAAA;AACzC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,2BAA2B,CAAA;AACzC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,wBAAwB,CAAA;AACtC,cAAc,oBAAoB,CAAA;AAClC,cAAc,sBAAsB,CAAA;AACpC,cAAc,qBAAqB,CAAA;AACnC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,sBAAsB,CAAA;AACpC,cAAc,kCAAkC,CAAA;AAChD,cAAc,6BAA6B,CAAA;AAC3C,cAAc,qBAAqB,CAAA;AACnC,cAAc,yBAAyB,CAAA;AACvC,cAAc,yBAAyB,CAAA;AACvC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,2BAA2B,CAAA;AACzC,cAAc,uBAAuB,CAAA;AACrC,cAAc,0BAA0B,CAAA;AACxC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,0BAA0B,CAAA;AACxC,cAAc,yBAAyB,CAAA;AACvC,cAAc,kBAAkB,CAAA;AAChC,cAAc,wBAAwB,CAAA"}
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/commands/browser.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,qBAAqB,CAAA;AACnC,cAAc,sBAAsB,CAAA;AACpC,cAAc,mBAAmB,CAAA;AACjC,cAAc,uBAAuB,CAAA;AACrC,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,2BAA2B,CAAA;AACzC,cAAc,sBAAsB,CAAA;AACpC,cAAc,sBAAsB,CAAA;AACpC,cAAc,2BAA2B,CAAA;AACzC,cAAc,yBAAyB,CAAA;AACvC,cAAc,2BAA2B,CAAA;AACzC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,2BAA2B,CAAA;AACzC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,wBAAwB,CAAA;AACtC,cAAc,oBAAoB,CAAA;AAClC,cAAc,sBAAsB,CAAA;AACpC,cAAc,qBAAqB,CAAA;AACnC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,sBAAsB,CAAA;AACpC,cAAc,kCAAkC,CAAA;AAChD,cAAc,6BAA6B,CAAA;AAC3C,cAAc,qBAAqB,CAAA;AACnC,cAAc,yBAAyB,CAAA;AACvC,cAAc,yBAAyB,CAAA;AACvC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,2BAA2B,CAAA;AACzC,cAAc,uBAAuB,CAAA;AACrC,cAAc,0BAA0B,CAAA;AACxC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,0BAA0B,CAAA;AACxC,cAAc,yBAAyB,CAAA;AACvC,cAAc,kBAAkB,CAAA;AAChC,cAAc,wBAAwB,CAAA"}

package/build/commands/browser.js

@@ -7,6 +7,7 @@ export * from './browser/custom$$.js';
 export * from './browser/custom$.js';
 export * from './browser/debug.js';
 export * from './browser/deleteCookies.js';
+export * from './browser/downloadFile.js';
 export * from './browser/emulate.js';
 export * from './browser/execute.js';
 export * from './browser/executeAsync.js';

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

@@ -1,3 +1,4 @@
+import type { ChainablePromiseElement } from '../../types.js';
 type DragAndDropOptions = {
     duration?: number;
 };
@@ -36,6 +37,6 @@ type ElementCoordinates = {
  * @param {DragAndDropOptions=} options           dragAndDrop command options
  * @param {Number=}             options.duration  how long the drag should take place
  */
-export declare function dragAndDrop(this: WebdriverIO.Element, target: WebdriverIO.Element | ElementCoordinates, { duration }?: DragAndDropOptions): Promise<void>;
+export declare function dragAndDrop(this: WebdriverIO.Element, target: WebdriverIO.Element | ChainablePromiseElement | ElementCoordinates, { duration }?: DragAndDropOptions): Promise<void>;
 export {};
 //# sourceMappingURL=dragAndDrop.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"dragAndDrop.d.ts","sourceRoot":"","sources":["../../../src/commands/element/dragAndDrop.ts"],"names":[],"mappings":"AAOA,KAAK,kBAAkB,GAAG;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,KAAK,kBAAkB,GAAG;IACtB,CAAC,CAAC,EAAE,MAAM,CAAA;IACV,CAAC,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAsB,WAAW,CAC7B,IAAI,EAAE,WAAW,CAAC,OAAO,EACzB,MAAM,EAAE,WAAW,CAAC,OAAO,GAAG,kBAAkB,EAChD,EAAE,QAAa,EAAE,GAAE,kBAAuB,iBAuD7C"}
+{"version":3,"file":"dragAndDrop.d.ts","sourceRoot":"","sources":["../../../src/commands/element/dragAndDrop.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAA;AAI7D,KAAK,kBAAkB,GAAG;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,KAAK,kBAAkB,GAAG;IACtB,CAAC,CAAC,EAAE,MAAM,CAAA;IACV,CAAC,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAsB,WAAW,CAC7B,IAAI,EAAE,WAAW,CAAC,OAAO,EACzB,MAAM,EAAE,WAAW,CAAC,OAAO,GAAG,uBAAuB,GAAG,kBAAkB,EAC1E,EAAE,QAAa,EAAE,GAAE,kBAAuB,iBAuD7C"}

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

@@ -1 +1 @@
-{"version":3,"file":"isExisting.d.ts","sourceRoot":"","sources":["../../../src/commands/element/isExisting.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,wBAAsB,UAAU,CAAE,IAAI,EAAE,WAAW,CAAC,OAAO,oBAsB1D"}
+{"version":3,"file":"isExisting.d.ts","sourceRoot":"","sources":["../../../src/commands/element/isExisting.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,wBAAsB,UAAU,CAAE,IAAI,EAAE,WAAW,CAAC,OAAO,oBAwB1D"}

package/build/commands/element/isExisting.js

@@ -62,5 +62,7 @@ export async function isExisting() {
         : this.isShadowElement
             ? this.shadow$$.bind(this.parent)
             : this.parent.$$.bind(this.parent);
-    return command(this.selector).then((res) => res.length > 0);
+    return command(this.selector)
+        .getElements()
+        .then((res) => res.length > 0);
 }

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

@@ -21,5 +21,5 @@
  * @return {Element}
  * @type utility
  */
-export declare function nextElement(this: WebdriverIO.Element): import("../../types.js").ChainablePromiseElement<WebdriverIO.Element>;
+export declare function nextElement(this: WebdriverIO.Element): import("../../types.js").ChainablePromiseElement;
 //# sourceMappingURL=nextElement.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"nextElement.d.ts","sourceRoot":"","sources":["../../../src/commands/element/nextElement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,wBAAgB,WAAW,CAAE,IAAI,EAAE,WAAW,CAAC,OAAO,yEAIrD"}
+{"version":3,"file":"nextElement.d.ts","sourceRoot":"","sources":["../../../src/commands/element/nextElement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,wBAAgB,WAAW,CAAE,IAAI,EAAE,WAAW,CAAC,OAAO,oDAIrD"}

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

@@ -21,5 +21,5 @@
  * @return {Element}
  * @type utility
  */
-export declare function parentElement(this: WebdriverIO.Element): import("../../types.js").ChainablePromiseElement<WebdriverIO.Element>;
+export declare function parentElement(this: WebdriverIO.Element): import("../../types.js").ChainablePromiseElement;
 //# sourceMappingURL=parentElement.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"parentElement.d.ts","sourceRoot":"","sources":["../../../src/commands/element/parentElement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,aAAa,CAAE,IAAI,EAAE,WAAW,CAAC,OAAO,yEAIvD"}
+{"version":3,"file":"parentElement.d.ts","sourceRoot":"","sources":["../../../src/commands/element/parentElement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,aAAa,CAAE,IAAI,EAAE,WAAW,CAAC,OAAO,oDAIvD"}

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

@@ -21,5 +21,5 @@
  * @return {Element}
  * @type utility
  */
-export declare function previousElement(this: WebdriverIO.Element): import("../../types.js").ChainablePromiseElement<WebdriverIO.Element>;
+export declare function previousElement(this: WebdriverIO.Element): import("../../types.js").ChainablePromiseElement;
 //# sourceMappingURL=previousElement.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"previousElement.d.ts","sourceRoot":"","sources":["../../../src/commands/element/previousElement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,eAAe,CAAE,IAAI,EAAE,WAAW,CAAC,OAAO,yEAIzD"}
+{"version":3,"file":"previousElement.d.ts","sourceRoot":"","sources":["../../../src/commands/element/previousElement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,eAAe,CAAE,IAAI,EAAE,WAAW,CAAC,OAAO,oDAIzD"}

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

@@ -18,5 +18,5 @@
  * @type utility
  *
  */
-export declare function shadow$$(this: WebdriverIO.Element, selector: string): Promise<WebdriverIO.ElementArray>;
+export declare function shadow$$(this: WebdriverIO.Element, selector: string): Promise<WebdriverIO.ElementArray | import("../../types.js").ChainablePromiseArray>;
 //# sourceMappingURL=shadow$$.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"shadow$$.d.ts","sourceRoot":"","sources":["../../../src/commands/element/shadow$$.ts"],"names":[],"mappings":"AAYA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,QAAQ,CAC1B,IAAI,EAAE,WAAW,CAAC,OAAO,EACzB,QAAQ,EAAE,MAAM,qCAiBnB"}
+{"version":3,"file":"shadow$$.d.ts","sourceRoot":"","sources":["../../../src/commands/element/shadow$$.ts"],"names":[],"mappings":"AAYA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,QAAQ,CAC1B,IAAI,EAAE,WAAW,CAAC,OAAO,EACzB,QAAQ,EAAE,MAAM,sFAiBnB"}

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

@@ -18,5 +18,5 @@
  * @type utility
  *
  */
-export declare function shadow$(this: WebdriverIO.Element, selector: string): Promise<WebdriverIO.Element>;
+export declare function shadow$(this: WebdriverIO.Element, selector: string): Promise<WebdriverIO.Element | import("../../types.js").ChainablePromiseElement>;
 //# sourceMappingURL=shadow$.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"shadow$.d.ts","sourceRoot":"","sources":["../../../src/commands/element/shadow$.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,OAAO,CACzB,IAAI,EAAE,WAAW,CAAC,OAAO,EACzB,QAAQ,EAAE,MAAM,gCAenB"}
+{"version":3,"file":"shadow$.d.ts","sourceRoot":"","sources":["../../../src/commands/element/shadow$.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,OAAO,CACzB,IAAI,EAAE,WAAW,CAAC,OAAO,EACzB,QAAQ,EAAE,MAAM,mFAenB"}

package/build/commands/mock/redirect.d.ts

@@ -0,0 +1,22 @@
+export {};
+/**
+ * Sets up a redirect for a given mock. This allows you to redirect a request to another URL.
+ * Note: these redirects only apply to requests made by a script in the browser, not when calling the `url` command.
+ *
+ * <example>
+    :respond.js
+    it('redirects all my API request to my staging server', async () => {
+        const mock = await browser.mock('https://application.com/api/*')
+        mock.redirect('https://staging.application.com/api/*')
+
+        // is the same as
+        mock.request({ url: 'https://staging.application.com/api/*' })
+
+        // ...
+    })
+ * </example>
+ *
+ * @alias mock.request
+ * @param {string} url  target resource to redirect requests to
+ */
+//# sourceMappingURL=redirect.d.ts.map

package/build/commands/mock/redirect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redirect.d.ts","sourceRoot":"","sources":["../../../src/commands/mock/redirect.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG"}

package/build/commands/mock/redirect.js

@@ -0,0 +1,22 @@
+export {};
+/**
+ * Sets up a redirect for a given mock. This allows you to redirect a request to another URL.
+ * Note: these redirects only apply to requests made by a script in the browser, not when calling the `url` command.
+ *
+ * <example>
+    :respond.js
+    it('redirects all my API request to my staging server', async () => {
+        const mock = await browser.mock('https://application.com/api/*')
+        mock.redirect('https://staging.application.com/api/*')
+
+        // is the same as
+        mock.request({ url: 'https://staging.application.com/api/*' })
+
+        // ...
+    })
+ * </example>
+ *
+ * @alias mock.request
+ * @param {string} url  target resource to redirect requests to
+ */
+// actual implementation is located in packages/webdriverio/src/utils/interception

package/build/commands/mock/request.d.ts

@@ -0,0 +1,37 @@
+export {};
+/**
+ * Allows you do modify requests the browser makes during the session. This can be useful for the following use cases:
+ *
+ * - validating if your application sends correct request payloads
+ * - passing through authorization headers to test protected resources
+ * - setting session cookies to test user authentication
+ * - modifying requests to test edge cases
+ *
+ * <example>
+    :respond.js
+    it('adds an auth header to my API requests', async () => {
+        const mock = await browser.mock('https://application.com/api', {
+            method: 'get'
+        })
+
+        mock.request({
+            headers: { 'Authorization': 'Bearer token' }
+        })
+
+        await browser.url('https://application.com')
+        // ...
+    })
+ * </example>
+ *
+ * @alias mock.request
+ * @param {MockOverwrite}         overwrites            payload to overwrite the response
+ * @param {Record<string, string> overwrites.header     overwrite specific headers
+ * @param {Record<string, string> overwrites.cookies    overwrite request cookies
+ * @param {string}                overwrites.method     overwrite request method
+ * @param {string}                overwrites.url        overwrite request url to initiate a redirect
+ * @param {MockResponseParams=}   params                additional respond parameters to overwrite
+ * @param {Object=}               params.header         overwrite specific headers
+ * @param {Number=}               params.statusCode     overwrite response status code
+ * @param {Boolean=}              params.fetchResponse  fetch real response before responding with mocked data
+ */
+//# sourceMappingURL=request.d.ts.map

package/build/commands/mock/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../../src/commands/mock/request.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG"}

package/build/commands/mock/request.js

@@ -0,0 +1,37 @@
+export {};
+/**
+ * Allows you do modify requests the browser makes during the session. This can be useful for the following use cases:
+ *
+ * - validating if your application sends correct request payloads
+ * - passing through authorization headers to test protected resources
+ * - setting session cookies to test user authentication
+ * - modifying requests to test edge cases
+ *
+ * <example>
+    :respond.js
+    it('adds an auth header to my API requests', async () => {
+        const mock = await browser.mock('https://application.com/api', {
+            method: 'get'
+        })
+
+        mock.request({
+            headers: { 'Authorization': 'Bearer token' }
+        })
+
+        await browser.url('https://application.com')
+        // ...
+    })
+ * </example>
+ *
+ * @alias mock.request
+ * @param {MockOverwrite}         overwrites            payload to overwrite the response
+ * @param {Record<string, string> overwrites.header     overwrite specific headers
+ * @param {Record<string, string> overwrites.cookies    overwrite request cookies
+ * @param {string}                overwrites.method     overwrite request method
+ * @param {string}                overwrites.url        overwrite request url to initiate a redirect
+ * @param {MockResponseParams=}   params                additional respond parameters to overwrite
+ * @param {Object=}               params.header         overwrite specific headers
+ * @param {Number=}               params.statusCode     overwrite response status code
+ * @param {Boolean=}              params.fetchResponse  fetch real response before responding with mocked data
+ */
+// actual implementation is located in packages/webdriverio/src/utils/interception

package/build/commands/mock/requestOnce.d.ts

@@ -0,0 +1,37 @@
+export {};
+/**
+ * Only change request parameter once with given overwrite for the next request. You can call `requestOnce` multiple
+ * consecutive times and it will apply the overwrites in order. If you only use `requestOnce` and the resource is called
+ * more times a mock has been defined than it defaults back to the original resource.
+ *
+ * <example>
+    :respond.js
+    it('adds different auth headers to my API requests', async () => {
+        const mock = await browser.mock('https://application.com/api', {
+            method: 'get'
+        })
+
+        mock.requestOnce({
+            headers: { 'Authorization': 'Bearer token' }
+        })
+        mock.requestOnce({
+            headers: { 'Authorization': 'Another bearer token' }
+        })
+
+        await browser.url('https://application.com')
+        // ...
+    })
+ * </example>
+ *
+ * @alias mock.requestOnce
+ * @param {MockOverwrite}         overwrites            payload to overwrite the response
+ * @param {Record<string, string> overwrites.header     overwrite specific headers
+ * @param {Record<string, string> overwrites.cookies    overwrite request cookies
+ * @param {string}                overwrites.method     overwrite request method
+ * @param {string}                overwrites.url        overwrite request url to initiate a redirect
+ * @param {MockResponseParams=}   params                additional respond parameters to overwrite
+ * @param {Object=}               params.header         overwrite specific headers
+ * @param {Number=}               params.statusCode     overwrite response status code
+ * @param {Boolean=}              params.fetchResponse  fetch real response before responding with mocked data
+ */
+//# sourceMappingURL=requestOnce.d.ts.map

package/build/commands/mock/requestOnce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requestOnce.d.ts","sourceRoot":"","sources":["../../../src/commands/mock/requestOnce.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG"}