webdriverio 9.1.4 → 9.2.0

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

@@ -0,0 +1,48 @@
+import { type local } from 'webdriver';
+import type { ChainablePromiseElement } from '../../types.js';
+type FlatContextTree = Omit<local.BrowsingContextInfo, 'children'> & {
+    children: string[];
+};
+/**
+ * Switches the active context to a frame, e.g. an iframe on the page. There are multiple ways you can query a frame
+ * on the page:
+ *
+ *   - If given a string it switches to the frame with a matching context id, url or url that contains that string
+ *     ```ts
+ *     // switch to a frame that has the url "https://the-internet.herokuapp.com/iframe"
+ *     await browser.switchFrame('https://the-internet.herokuapp.com/iframe')
+ *     // switch to a frame that has a certain context id
+ *     await browser.switchFrame('A5734774C41F8C91D483BDD4022B2EF3')
+ *     ```
+ *
+ *   - If given a WebdriverIO element that references an `iframe` element it will switch to that frame
+ *     ```ts
+ *     // switch to a frame element queried from current context
+ *     await browser.switchFrame($('iframe'))
+ *     ```
+ *
+ *   - If given a function it will loop through all iframes on the page and call the function with the context
+ *     object. The function should return a boolean indicating if the frame should be selected. Within the function
+ *     you can use WebdriverIO commands to e.g. check if a certain frame element exists.
+ *     ```ts
+ *     // switch to first frame that contains an element with id "#frameContent"
+ *     await browser.switchFrame(() => $('#frameContent').isExisting())
+ *     ```
+ *
+ *   - If given `null` it will switch to the top level frame
+ *     ```ts
+ *     // first switch into a frame
+ *     await browser.switchFrame($('iframe'))
+ *     // do more automation within that frame, then ...
+ *
+ *     // switch to the top level frame
+ *     await browser.switchFrame(null)
+ *     ```
+ *
+ * @alias browser.switchFrame
+ * @param {string|object|function} context
+ * @returns {Promise<string>} the current active context id
+ */
+export declare function switchFrame(this: WebdriverIO.Browser, context: WebdriverIO.Element | ChainablePromiseElement | string | null | ((tree: FlatContextTree) => boolean | Promise<boolean>)): Promise<string | ((tree: FlatContextTree) => boolean | Promise<boolean>)>;
+export {};
+//# sourceMappingURL=switchFrame.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"switchFrame.d.ts","sourceRoot":"","sources":["../../../src/commands/browser/switchFrame.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,WAAW,CAAA;AAGtC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAA;AAE7D,KAAK,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,mBAAmB,EAAE,UAAU,CAAC,GAAG;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAA;AAE3F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAsB,WAAW,CAC7B,IAAI,EAAE,WAAW,CAAC,OAAO,EACzB,OAAO,EAAE,WAAW,CAAC,OAAO,GAAG,uBAAuB,GAAG,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,eAAe,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,4BAA/C,eAAe,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAgFlI"}

package/build/commands/browser.d.ts

@@ -34,6 +34,7 @@ export * from './browser/setTimeout.js';
 export * from './browser/setViewport.js';
 export * from './browser/setWindowSize.js';
 export * from './browser/switchWindow.js';
+export * from './browser/switchFrame.js';
 export * from './browser/throttle.js';
 export * from './browser/throttleCPU.js';
 export * from './browser/throttleNetwork.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,4BAA4B,CAAA;AAC1C,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,sBAAsB,CAAA;AACpC,cAAc,kCAAkC,CAAA;AAChD,cAAc,6BAA6B,CAAA;AAC3C,cAAc,qBAAqB,CAAA;AACnC,cAAc,yBAAyB,CAAA;AACvC,cAAc,yBAAyB,CAAA;AACvC,cAAc,0BAA0B,CAAA;AACxC,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,4BAA4B,CAAA;AAC1C,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,sBAAsB,CAAA;AACpC,cAAc,kCAAkC,CAAA;AAChD,cAAc,6BAA6B,CAAA;AAC3C,cAAc,qBAAqB,CAAA;AACnC,cAAc,yBAAyB,CAAA;AACvC,cAAc,yBAAyB,CAAA;AACvC,cAAc,0BAA0B,CAAA;AACxC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,2BAA2B,CAAA;AACzC,cAAc,0BAA0B,CAAA;AACxC,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/index.js

@@ -122,6 +122,7 @@ __export(browser_exports, {
   setTimeout: () => setTimeout2,
   setViewport: () => setViewport,
   setWindowSize: () => setWindowSize,
+  switchFrame: () => switchFrame,
   switchWindow: () => switchWindow,
   throttle: () => throttle,
   throttleCPU: () => throttleCPU,
@@ -885,7 +886,7 @@ async function addInitScript(script, ...args) {
     throw new Error("This command is only supported when automating browser using WebDriver Bidi protocol");
   }
   const serializedParameters = (args || []).map((arg) => JSON.stringify(arg));
-  const context = await this.getWindowHandle();
+  const context2 = await this.getWindowHandle();
   const fn = `(emit) => {
         const closure = new Function(\`return ${script.toString()}\`)
         return closure()(${serializedParameters.length ? `${serializedParameters.join(", ")}, emit` : "emit"})
@@ -897,7 +898,7 @@ async function addInitScript(script, ...args) {
       type: "channel",
       value: { channel }
     }],
-    contexts: [context]
+    contexts: [context2]
   });
   await this.sessionSubscribe({
     events: ["script.message"]
@@ -971,13 +972,13 @@ function debug(commandTimeout = 5e3) {
   const { introMessage } = WDIORepl;
   if (!process.env.WDIO_WORKER_ID || typeof process.send !== "function") {
     console.log(WDIORepl.introMessage);
-    const context = {
+    const context2 = {
       browser: this,
       driver: this,
       $: this.$.bind(this),
       $$: this.$$.bind(this)
     };
-    return repl.start(context);
+    return repl.start(context2);
   }
   process._debugProcess(process.pid);
   process.send({
@@ -3012,15 +3013,15 @@ var ContextManager = class {
    *
    * @param {local.BrowsingContextNavigationInfo} context  browsing context used to navigate
    */
-  async #handleNavigationStarted(context) {
+  async #handleNavigationStarted(context2) {
     const windowHandle = await this.#browser.getWindowHandle();
-    if (context.context === windowHandle) {
-      log4.info(`Update current context: ${context.context}`);
-      this.#currentContext = context.context;
+    if (context2.context === windowHandle && context2.url !== "UNKNOWN") {
+      log4.info(`Update current context: ${context2.context}`);
+      this.#currentContext = context2.context;
     }
   }
-  setCurrentContext(context) {
-    this.#currentContext = context;
+  setCurrentContext(context2) {
+    this.#currentContext = context2;
   }
   async getCurrentContext() {
     if (!this.#currentContext) {
@@ -3076,7 +3077,7 @@ async function execute(script, ...args) {
   if (this.isBidi && !this.isMultiremote) {
     const browser = getBrowserObject2(this);
     const contextManager2 = getContextManager(browser);
-    const context = await contextManager2.getCurrentContext();
+    const context2 = await contextManager2.getCurrentContext();
     const userScript = typeof script === "string" ? new Function(script) : script;
     const functionDeclaration = new Function(`
             return (${SCRIPT_PREFIX}${userScript.toString()}${SCRIPT_SUFFIX}).apply(this, arguments);
@@ -3086,7 +3087,7 @@ async function execute(script, ...args) {
       awaitPromise: true,
       arguments: args.map((arg) => LocalValue.getArgument(arg)),
       target: {
-        context
+        context: context2
       }
     };
     const result = await browser.scriptCallFunction(params);
@@ -3110,7 +3111,7 @@ async function executeAsync(script, ...args) {
   if (this.isBidi && !this.isMultiremote) {
     const browser = getBrowserObject3(this);
     const contextManager2 = getContextManager(browser);
-    const context = await contextManager2.getCurrentContext();
+    const context2 = await contextManager2.getCurrentContext();
     const userScript = typeof script === "string" ? new Function(script) : script;
     const functionDeclaration = new Function(`
             const args = Array.from(arguments)
@@ -3128,7 +3129,7 @@ async function executeAsync(script, ...args) {
       awaitPromise: true,
       arguments: args.map((arg) => LocalValue.getArgument(arg)),
       target: {
-        context
+        context: context2
       }
     };
     const result = await browser.scriptCallFunction(params);
@@ -3801,12 +3802,12 @@ async function mock(url6, filterOptions) {
   }
   const browser = getBrowserObject5(this);
   const contextManager2 = getContextManager(browser);
-  const context = await contextManager2.getCurrentContext();
-  if (!SESSION_MOCKS[context]) {
-    SESSION_MOCKS[context] = /* @__PURE__ */ new Set();
+  const context2 = await contextManager2.getCurrentContext();
+  if (!SESSION_MOCKS[context2]) {
+    SESSION_MOCKS[context2] = /* @__PURE__ */ new Set();
   }
   const networkInterception = await WebDriverInterception.initiate(url6, filterOptions || {}, this);
-  SESSION_MOCKS[context].add(networkInterception);
+  SESSION_MOCKS[context2].add(networkInterception);
   return networkInterception;
 }
 
@@ -3848,9 +3849,9 @@ async function newWindow(url6, { windowName = "", windowFeatures = "" } = {}) {
   const tabsBefore = await this.getWindowHandles();
   if (this.isBidi) {
     const contextManager2 = getContextManager(this);
-    const { context } = await this.browsingContextCreate({ type: "window" });
-    contextManager2.setCurrentContext(context);
-    await this.browsingContextNavigate({ context, url: url6 });
+    const { context: context2 } = await this.browsingContextCreate({ type: "window" });
+    contextManager2.setCurrentContext(context2);
+    await this.browsingContextNavigate({ context: context2, url: url6 });
   } else {
     await this.execute(newWindowHelper, url6, windowName, windowFeatures);
   }
@@ -4016,8 +4017,8 @@ async function saveScreenshot(filepath) {
   if (this.isBidi) {
     const browser = getBrowserObject6(this);
     const contextManager2 = getContextManager(browser);
-    const context = await contextManager2.getCurrentContext();
-    const { data } = await this.browsingContextCaptureScreenshot({ context });
+    const context2 = await contextManager2.getCurrentContext();
+    const { data } = await this.browsingContextCaptureScreenshot({ context: context2 });
     screenBuffer = data;
   } else {
     screenBuffer = await this.takeScreenshot();
@@ -4103,9 +4104,9 @@ async function setViewport(options) {
     throw new Error("setViewport expects devicePixelRatio to be a number in the 0 to 2^31 \u2212 1 range");
   }
   const contextManager2 = getContextManager(this);
-  const context = await contextManager2.getCurrentContext();
+  const context2 = await contextManager2.getCurrentContext();
   await this.browsingContextSetViewport({
-    context,
+    context: context2,
     devicePixelRatio: options.devicePixelRatio || 1,
     viewport: {
       width: options.width,
@@ -4164,6 +4165,107 @@ async function switchWindow(matcher) {
   throw new Error(`No window found with title, url or name matching "${matcher}"`);
 }
 
+// src/commands/browser/switchFrame.ts
+async function switchFrame(context2) {
+  if (context2 === null) {
+    const handle = await this.getWindowHandle();
+    await switchToFrameHelper(this, handle);
+    return handle;
+  }
+  if (typeof context2 === "string") {
+    const tree = await this.browsingContextGetTree({});
+    const urlContext = findContext(context2, tree.contexts, byUrl)?.context;
+    if (urlContext) {
+      await switchToFrameHelper(this, urlContext);
+      return urlContext;
+    }
+    const urlContextContaining = findContext(context2, tree.contexts, byUrlContaining)?.context;
+    if (urlContextContaining) {
+      await switchToFrameHelper(this, urlContextContaining);
+      return urlContextContaining;
+    }
+    const contextIdContext = findContext(context2, tree.contexts, byContextId)?.context;
+    if (contextIdContext) {
+      await switchToFrameHelper(this, contextIdContext);
+      return contextIdContext;
+    }
+    throw new Error(`Frame with url or context id "${context2}" not found`);
+  }
+  if (typeof context2 === "object" && typeof context2.getElement === "function") {
+    const element = await context2.getElement();
+    return switchToFrameUsingElement(this, element);
+  }
+  if (typeof context2 === "function") {
+    const tree = await this.browsingContextGetTree({});
+    const mapContext = (context3) => [
+      context3.context,
+      ...(context3.children || []).map(mapContext)
+    ];
+    const sessionContext = getContextManager(this);
+    const currentContext = await sessionContext.getCurrentContext();
+    const allContexts = tree.contexts.map(mapContext).flat(Infinity).filter((ctx) => ctx !== currentContext).reduce((acc, ctx) => {
+      const context3 = findContext(ctx, tree.contexts, byContextId);
+      acc[ctx] = context3;
+      return acc;
+    }, {});
+    for (const [contextId, ctx] of Object.entries(allContexts)) {
+      sessionContext.setCurrentContext(contextId);
+      const isDesiredFrame = await context2(ctx);
+      if (isDesiredFrame) {
+        return context2;
+      }
+    }
+    sessionContext.setCurrentContext(currentContext);
+    throw new Error("Could not find the desired frame");
+  }
+  throw new Error(
+    `Invalid type for context parameter: ${typeof context2}, expected one of number, string or null. Check out our docs: https://webdriver.io/docs/api/browser/switchToFrame.html`
+  );
+}
+function switchToFrameHelper(browser, context2) {
+  const sessionContext = getContextManager(browser);
+  sessionContext.setCurrentContext(context2);
+}
+async function switchToFrameUsingElement(browser, element) {
+  let frameSrc = await element.getAttribute("src");
+  if (!frameSrc) {
+    throw new Error(`Frame with index ${context} has no src attribute`);
+  }
+  if (!frameSrc.startsWith("http")) {
+    frameSrc = await browser.execute((urlPath) => URL.parse(urlPath, window.location.href)?.href, frameSrc) || frameSrc;
+  }
+  const tree = await browser.browsingContextGetTree({});
+  const urlContext = findContext(frameSrc, tree.contexts, byUrl)?.context;
+  if (!urlContext) {
+    throw new Error(`Frame with url "${frameSrc}" not found`);
+  }
+  await switchToFrameHelper(browser, urlContext);
+  return urlContext;
+}
+function byUrl(context2, url6) {
+  return context2.url === url6;
+}
+function byUrlContaining(context2, url6) {
+  return context2.url.includes(url6);
+}
+function byContextId(context2, contextId) {
+  return context2.context === contextId;
+}
+function findContext(url6, contexts, matcher) {
+  for (const context2 of contexts || []) {
+    if (matcher(context2, url6)) {
+      return context2;
+    }
+    if (Array.isArray(context2.children) && context2.children.length > 0) {
+      const result = findContext(url6, context2.children, matcher);
+      if (result) {
+        return result;
+      }
+    }
+  }
+  return void 0;
+}
+
 // src/commands/browser/throttle.ts
 import logger13 from "@wdio/logger";
 import { getBrowserObject as getBrowserObject8 } from "@wdio/utils";
@@ -4455,18 +4557,18 @@ var NetworkManager = class {
     };
     response.children?.push(request);
   }
-  getRequestResponseData(context) {
-    return this.#requests.get(context);
+  getRequestResponseData(context2) {
+    return this.#requests.get(context2);
   }
   /**
    * Returns the number of requests that are currently pending.
    * @param context browsing context id
    * @returns the number of requests that are currently pending
    */
-  getPendingRequests(context) {
-    const request = this.#requests.get(context);
+  getPendingRequests(context2) {
+    const request = this.#requests.get(context2);
     if (!request) {
-      throw new Error(`Couldn't find request for context ${context}`);
+      throw new Error(`Couldn't find request for context ${context2}`);
     }
     const subRequests = request.children || [];
     return subRequests.filter((child) => (
@@ -4500,7 +4602,7 @@ async function url3(path4, options = {}) {
   if (this.isBidi) {
     let resetPreloadScript;
     const contextManager2 = getContextManager(this);
-    const context = await contextManager2.getCurrentContext();
+    const context2 = await contextManager2.getCurrentContext();
     if (options.onBeforeLoad) {
       if (typeof options.onBeforeLoad !== "function") {
         throw new Error(`Option "onBeforeLoad" must be a function, but received: ${typeof options.onBeforeLoad}`);
@@ -4521,22 +4623,22 @@ async function url3(path4, options = {}) {
     const classicPageLoadStrategy = this.capabilities.pageLoadStrategy === "none" ? "none" : this.capabilities.pageLoadStrategy === "normal" ? "complete" : this.capabilities.pageLoadStrategy === "eager" ? "interactive" : void 0;
     const wait = options.wait === "networkIdle" ? "complete" : options.wait || classicPageLoadStrategy || DEFAULT_WAIT_STATE;
     await this.browsingContextNavigate({
-      context,
+      context: context2,
       url: path4,
       wait
     });
     const network = networkManager.get(this);
-    const request = network?.getRequestResponseData(context);
+    const request = network?.getRequestResponseData(context2);
     if (mock2) {
       await mock2.restore();
     }
     if (network && options.wait === "networkIdle") {
       const timeout = options.timeout || DEFAULT_NETWORK_IDLE_TIMEOUT;
       await this.waitUntil(async () => {
-        return network.getPendingRequests(context).length === 0;
+        return network.getPendingRequests(context2).length === 0;
       }, {
         timeout,
-        timeoutMsg: `Navigation to '${path4}' timed out after ${timeout}ms with ${network.getPendingRequests(context).length} (${network.getPendingRequests(context).map((r) => r.url).join(", ")}) pending requests`
+        timeoutMsg: `Navigation to '${path4}' timed out after ${timeout}ms with ${network.getPendingRequests(context2).length} (${network.getPendingRequests(context2).map((r) => r.url).join(", ")}) pending requests`
       });
     }
     if (resetPreloadScript) {
@@ -4955,7 +5057,7 @@ var ShadowRootManager = class {
     }).then(() => true, () => false);
     this.#browser.on("log.entryAdded", this.handleLogEntry.bind(this));
     this.#browser.on("result", this.#commandResultHandler.bind(this));
-    this.#browser.on("browsingContext.navigationStarted", this.#handleNavigationStarted.bind(this));
+    this.#browser.on("bidiCommand", this.#handleBidiCommand.bind(this));
     browser.scriptAddPreloadScript({
       functionDeclaration: customElementWrapper.toString()
     });
@@ -4966,8 +5068,12 @@ var ShadowRootManager = class {
   /**
    * keep track of navigation events and remove shadow roots when they are no longer needed
    */
-  #handleNavigationStarted(context) {
-    this.#shadowRoots.delete(context.context);
+  #handleBidiCommand(command) {
+    if (command.method !== "browsingContext.navigate") {
+      return;
+    }
+    const params = command.params;
+    this.#shadowRoots.delete(params.context);
   }
   /**
    * keep track of frame depth
@@ -5213,8 +5319,8 @@ async function getHTML(options = {}) {
     const { load } = await import("cheerio");
     const shadowRootManager2 = getShadowRootManager(browser);
     const contextManager2 = getContextManager(browser);
-    const context = await contextManager2.getCurrentContext();
-    const shadowRootElementPairs = shadowRootManager2.getShadowElementPairsByContextId(context, this.elementId);
+    const context2 = await contextManager2.getCurrentContext();
+    const shadowRootElementPairs = shadowRootManager2.getShadowElementPairsByContextId(context2, this.elementId);
     const elementsWithShadowRootAndIdVerified = (await Promise.all(
       shadowRootElementPairs.map(([elemId, elem]) => browser.execute((elem2) => elem2.tagName, { [ELEMENT_KEY11]: elemId }).then(
         () => [elemId, elem],
@@ -5235,7 +5341,7 @@ async function getHTML(options = {}) {
     populateHTML($3, shadowElementHTML.map(({ id, ...props }) => ({
       ...props,
       id,
-      mode: shadowRootManager2.getShadowRootModeById(context, id) || "open"
+      mode: shadowRootManager2.getShadowRootModeById(context2, id) || "open"
     })));
     return sanitizeHTML($3, { removeCommentNodes, prettify, excludeElements });
   }
@@ -5386,8 +5492,8 @@ var getWebElement = (el) => ({
 async function isEqual(el) {
   const browser = getBrowserObject21(this);
   if (browser.isMobile) {
-    const context = await browser.getContext().catch(() => void 0);
-    const contextId = typeof context === "string" ? context : context?.id;
+    const context2 = await browser.getContext().catch(() => void 0);
+    const contextId = typeof context2 === "string" ? context2 : context2?.id;
     if (contextId && contextId.toLowerCase().includes("native")) {
       return this.elementId === el.elementId;
     }
@@ -6489,15 +6595,15 @@ async function findDeepElement(selector) {
   const browser = getBrowserObject30(this);
   const shadowRootManager2 = getShadowRootManager(browser);
   const contextManager2 = getContextManager(browser);
-  const context = await contextManager2.getCurrentContext();
+  const context2 = await contextManager2.getCurrentContext();
   const shadowRoots = shadowRootManager2.getShadowElementsByContextId(
-    context,
+    context2,
     this.elementId
   );
   const { using, value } = findStrategy(selector, this.isW3C, this.isMobile);
   const locator = transformClassicToBidiSelector(using, value);
   const startNodes = shadowRoots.length > 0 ? shadowRoots.map((shadowRootNodeId) => ({ sharedId: shadowRootNodeId })) : this.elementId ? [{ sharedId: this.elementId }] : void 0;
-  const deepElementResult = await browser.browsingContextLocateNodes({ locator, context, startNodes }).then(async (result) => {
+  const deepElementResult = await browser.browsingContextLocateNodes({ locator, context: context2, startNodes }).then(async (result) => {
     const nodes = result.nodes.filter((node) => Boolean(node.sharedId)).map((node) => ({
       [ELEMENT_KEY17]: node.sharedId,
       locator
@@ -6527,15 +6633,15 @@ async function findDeepElements(selector) {
   const browser = getBrowserObject30(this);
   const shadowRootManager2 = getShadowRootManager(browser);
   const contextManager2 = getContextManager(browser);
-  const context = await contextManager2.getCurrentContext();
+  const context2 = await contextManager2.getCurrentContext();
   const shadowRoots = shadowRootManager2.getShadowElementsByContextId(
-    context,
+    context2,
     this.elementId
   );
   const { using, value } = findStrategy(selector, this.isW3C, this.isMobile);
   const locator = transformClassicToBidiSelector(using, value);
   const startNodes = shadowRoots.length > 0 ? shadowRoots.map((shadowRootNodeId) => ({ sharedId: shadowRootNodeId })) : this.elementId ? [{ sharedId: this.elementId }] : void 0;
-  const deepElementResult = await browser.browsingContextLocateNodes({ locator, context, startNodes }).then(async (result) => {
+  const deepElementResult = await browser.browsingContextLocateNodes({ locator, context: context2, startNodes }).then(async (result) => {
     const nodes = result.nodes.filter((node) => Boolean(node.sharedId)).map((node) => ({
       [ELEMENT_KEY17]: node.sharedId,
       locator

package/build/shadowRoot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shadowRoot.d.ts","sourceRoot":"","sources":["../src/shadowRoot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,WAAW,CAAA;AAQtC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,WAAW,CAAC,OAAO,qBAShE;AAED;;;;GAIG;AACH,qBAAa,iBAAiB;;gBAMd,OAAO,EAAE,WAAW,CAAC,OAAO;IAyBlC,UAAU;IAuBhB;;;OAGG;IACH,aAAa;IAIb;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ;IA2FvC,4BAA4B,CAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE;IAwB1E,gCAAgC,CAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EAAE;IAgBpG,qBAAqB,CAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IActF,gBAAgB,CAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAOvD;AAED,qBAAa,cAAc;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,EAAE,cAAc,CAAA;IACrB,QAAQ,sBAA4B;gBAEvB,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc;IAMxE;;OAEG;IACH,gBAAgB,CAAE,IAAI,EAAE,cAAc,GAAG,IAAI;IAC7C;;;;;OAKG;IACH,gBAAgB,CAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI;IA6B5D,IAAI,CAAE,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAelD,cAAc,CAAE,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAe/D,kBAAkB,IAAK,MAAM,EAAE;IAO/B,IAAI,IAAK,cAAc,EAAE;IAIzB,MAAM,CAAE,OAAO,EAAE,MAAM,GAAG,OAAO;CAcpC"}
+{"version":3,"file":"shadowRoot.d.ts","sourceRoot":"","sources":["../src/shadowRoot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,WAAW,CAAA;AAStC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,WAAW,CAAC,OAAO,qBAShE;AAED;;;;GAIG;AACH,qBAAa,iBAAiB;;gBAMd,OAAO,EAAE,WAAW,CAAC,OAAO;IAyBlC,UAAU;IA2BhB;;;OAGG;IACH,aAAa;IAIb;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ;IA2FvC,4BAA4B,CAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE;IAwB1E,gCAAgC,CAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EAAE;IAgBpG,qBAAqB,CAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IActF,gBAAgB,CAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAOvD;AAED,qBAAa,cAAc;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,EAAE,cAAc,CAAA;IACrB,QAAQ,sBAA4B;gBAEvB,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc;IAMxE;;OAEG;IACH,gBAAgB,CAAE,IAAI,EAAE,cAAc,GAAG,IAAI;IAC7C;;;;;OAKG;IACH,gBAAgB,CAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI;IA6B5D,IAAI,CAAE,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAelD,cAAc,CAAE,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAe/D,kBAAkB,IAAK,MAAM,EAAE;IAO/B,IAAI,IAAK,cAAc,EAAE;IAIzB,MAAM,CAAE,OAAO,EAAE,MAAM,GAAG,OAAO;CAcpC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "webdriverio",
   "description": "Next-gen browser and mobile automation test framework for Node.js",
-  "version": "9.1.4",
+  "version": "9.2.0",
   "homepage": "https://webdriver.io",
   "author": "Christian Bromann <mail@bromann.dev>",
   "license": "MIT",
@@ -78,7 +78,7 @@
     "@types/sinonjs__fake-timers": "^8.1.5",
     "@wdio/config": "9.1.3",
     "@wdio/logger": "9.1.3",
-    "@wdio/protocols": "9.0.8",
+    "@wdio/protocols": "9.2.0",
     "@wdio/repl": "9.0.8",
     "@wdio/types": "9.1.3",
     "@wdio/utils": "9.1.3",
@@ -100,7 +100,7 @@
     "rgb2hex": "0.2.5",
     "serialize-error": "^11.0.3",
     "urlpattern-polyfill": "^10.0.0",
-    "webdriver": "9.1.3"
+    "webdriver": "9.2.0"
   },
   "peerDependencies": {
     "puppeteer-core": "^22.3.0"
@@ -110,5 +110,5 @@
       "optional": true
     }
   },
-  "gitHead": "39fb68e6fa78c99c0def775c2b976f36e0be3af0"
+  "gitHead": "d19039c7166c6df2e47a02de289a66865372107e"
 }