@browserless.io/browserless 2.14.0 → 2.15.0

package/static/function/client.js

@@ -16907,6 +16907,15 @@
       };
     });
   }
+  function fromAbortSignal(signal, cause) {
+    return signal ? fromEvent(signal, "abort").pipe(map(() => {
+      if (signal.reason instanceof Error) {
+        signal.reason.cause = cause;
+        throw signal.reason;
+      }
+      throw new Error(signal.reason, { cause });
+    })) : NEVER;
+  }
   function filterAsync(predicate) {
     return mergeMap((value) => {
       return from(Promise.resolve(predicate(value))).pipe(filter((isMatch) => {
@@ -18647,8 +18656,8 @@
   })(LocatorEvent || (LocatorEvent = {}));
   var Locator = class extends EventEmitter2 {
     /**
-     * Creates a race between multiple locators but ensures that only a single one
-     * acts.
+     * Creates a race between multiple locators trying to locate elements in
+     * parallel but ensures that only a single element receives the action.
      *
      * @public
      */
@@ -18680,12 +18689,7 @@
       retryAndRaceWithSignalAndTimer: (signal, cause) => {
         const candidates = [];
         if (signal) {
-          candidates.push(fromEvent(signal, "abort").pipe(map(() => {
-            if (signal.reason instanceof Error) {
-              signal.reason.cause = cause;
-            }
-            throw signal.reason;
-          })));
+          candidates.push(fromAbortSignal(signal, cause));
         }
         candidates.push(timeout(this._timeout, cause));
         return pipe(retry({ delay: RETRY_DELAY }), raceWith(...candidates));
@@ -18695,26 +18699,59 @@
     get timeout() {
       return this._timeout;
     }
+    /**
+     * Creates a new locator instance by cloning the current locator and setting
+     * the total timeout for the locator actions.
+     *
+     * Pass `0` to disable timeout.
+     *
+     * @defaultValue `Page.getDefaultTimeout()`
+     */
     setTimeout(timeout2) {
       const locator = this._clone();
       locator._timeout = timeout2;
       return locator;
     }
+    /**
+     * Creates a new locator instance by cloning the current locator with the
+     * visibility property changed to the specified value.
+     */
     setVisibility(visibility) {
       const locator = this._clone();
       locator.visibility = visibility;
       return locator;
     }
+    /**
+     * Creates a new locator instance by cloning the current locator and
+     * specifying whether to wait for input elements to become enabled before the
+     * action. Applicable to `click` and `fill` actions.
+     *
+     * @defaultValue `true`
+     */
     setWaitForEnabled(value) {
       const locator = this._clone();
       locator.#waitForEnabled = value;
       return locator;
     }
+    /**
+     * Creates a new locator instance by cloning the current locator and
+     * specifying whether the locator should scroll the element into viewport if
+     * it is not in the viewport already.
+     *
+     * @defaultValue `true`
+     */
     setEnsureElementIsInTheViewport(value) {
       const locator = this._clone();
       locator.#ensureElementIsInTheViewport = value;
       return locator;
     }
+    /**
+     * Creates a new locator instance by cloning the current locator and
+     * specifying whether the locator has to wait for the element's bounding box
+     * to be same between two consecutive animation frames.
+     *
+     * @defaultValue `true`
+     */
     setWaitForStableBoundingBox(value) {
       const locator = this._clone();
       locator.#waitForStableBoundingBox = value;
@@ -19021,21 +19058,30 @@
     mapHandle(mapper) {
       return new MappedLocator(this._clone(), mapper);
     }
+    /**
+     * Clicks the located element.
+     */
     click(options) {
       return firstValueFrom(this.#click(options));
     }
     /**
      * Fills out the input identified by the locator using the provided value. The
      * type of the input is determined at runtime and the appropriate fill-out
-     * method is chosen based on the type. contenteditable, selector, inputs are
-     * supported.
+     * method is chosen based on the type. `contenteditable`, select, textarea and
+     * input elements are supported.
      */
     fill(value, options) {
       return firstValueFrom(this.#fill(value, options));
     }
+    /**
+     * Hovers over the located element.
+     */
     hover(options) {
       return firstValueFrom(this.#hover(options));
     }
+    /**
+     * Scrolls the located element.
+     */
     scroll(options) {
       return firstValueFrom(this.#scroll(options));
     }
@@ -19427,20 +19473,20 @@
        * the selector, the return value resolves to `null`.
        *
        * @param selector -
-       * {@link https://pptr.dev/guides/page-interactions#query-selectors | selector}
+       * {@link https://pptr.dev/guides/page-interactions#selectors | selector}
        * to query page for.
        * {@link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors | CSS selectors}
        * can be passed as-is and a
-       * {@link https://pptr.dev/guides/page-interactions#p-selectors | Puppeteer-specific seletor syntax}
+       * {@link https://pptr.dev/guides/page-interactions#non-css-selectors | Puppeteer-specific selector syntax}
        * allows quering by
        * {@link https://pptr.dev/guides/page-interactions#text-selectors--p-text | text},
        * {@link https://pptr.dev/guides/page-interactions#aria-selectors--p-aria | a11y role and name},
        * and
        * {@link https://pptr.dev/guides/page-interactions#xpath-selectors--p-xpath | xpath}
        * and
-       * {@link https://pptr.dev/guides/page-interactions#-and--combinators | combining these queries across shadow roots}.
-       * Alternatively, you can specify a selector type using a prefix
-       * {@link https://pptr.dev/guides/page-interactions#built-in-selectors | prefix}.
+       * {@link https://pptr.dev/guides/page-interactions#querying-elements-in-shadow-dom | combining these queries across shadow roots}.
+       * Alternatively, you can specify the selector type using a
+       * {@link https://pptr.dev/guides/page-interactions#prefixed-selector-syntax | prefix}.
        *
        * @remarks
        *
@@ -19454,20 +19500,20 @@
        * match the selector, the return value resolves to `[]`.
        *
        * @param selector -
-       * {@link https://pptr.dev/guides/page-interactions#query-selectors | selector}
+       * {@link https://pptr.dev/guides/page-interactions#selectors | selector}
        * to query page for.
        * {@link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors | CSS selectors}
        * can be passed as-is and a
-       * {@link https://pptr.dev/guides/page-interactions#p-selectors | Puppeteer-specific seletor syntax}
+       * {@link https://pptr.dev/guides/page-interactions#non-css-selectors | Puppeteer-specific selector syntax}
        * allows quering by
        * {@link https://pptr.dev/guides/page-interactions#text-selectors--p-text | text},
        * {@link https://pptr.dev/guides/page-interactions#aria-selectors--p-aria | a11y role and name},
        * and
        * {@link https://pptr.dev/guides/page-interactions#xpath-selectors--p-xpath | xpath}
        * and
-       * {@link https://pptr.dev/guides/page-interactions#-and--combinators | combining these queries across shadow roots}.
-       * Alternatively, you can specify a selector type using a prefix
-       * {@link https://pptr.dev/guides/page-interactions#built-in-selectors | prefix}.
+       * {@link https://pptr.dev/guides/page-interactions#querying-elements-in-shadow-dom | combining these queries across shadow roots}.
+       * Alternatively, you can specify the selector type using a
+       * {@link https://pptr.dev/guides/page-interactions#prefixed-selector-syntax | prefix}.
        *
        * @remarks
        *
@@ -19588,20 +19634,20 @@
        * ```
        *
        * @param selector -
-       * {@link https://pptr.dev/guides/page-interactions#query-selectors | selector}
+       * {@link https://pptr.dev/guides/page-interactions#selectors | selector}
        * to query page for.
        * {@link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors | CSS selectors}
        * can be passed as-is and a
-       * {@link https://pptr.dev/guides/page-interactions#p-selectors | Puppeteer-specific seletor syntax}
+       * {@link https://pptr.dev/guides/page-interactions#non-css-selectors | Puppeteer-specific selector syntax}
        * allows quering by
        * {@link https://pptr.dev/guides/page-interactions#text-selectors--p-text | text},
        * {@link https://pptr.dev/guides/page-interactions#aria-selectors--p-aria | a11y role and name},
        * and
        * {@link https://pptr.dev/guides/page-interactions#xpath-selectors--p-xpath | xpath}
        * and
-       * {@link https://pptr.dev/guides/page-interactions#-and--combinators | combining these queries across shadow roots}.
-       * Alternatively, you can specify a selector type using a prefix
-       * {@link https://pptr.dev/guides/page-interactions#built-in-selectors | prefix}.
+       * {@link https://pptr.dev/guides/page-interactions#querying-elements-in-shadow-dom | combining these queries across shadow roots}.
+       * Alternatively, you can specify the selector type using a
+       * {@link https://pptr.dev/guides/page-interactions#prefixed-selector-syntax | prefix}.
        * @param pageFunction - the function to be evaluated in the page context.
        * Will be passed the result of the element matching the selector as its
        * first argument.
@@ -19661,20 +19707,20 @@
        * ```
        *
        * @param selector -
-       * {@link https://pptr.dev/guides/page-interactions#query-selectors | selector}
+       * {@link https://pptr.dev/guides/page-interactions#selectors | selector}
        * to query page for.
        * {@link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors | CSS selectors}
        * can be passed as-is and a
-       * {@link https://pptr.dev/guides/page-interactions#p-selectors | Puppeteer-specific seletor syntax}
+       * {@link https://pptr.dev/guides/page-interactions#non-css-selectors | Puppeteer-specific selector syntax}
        * allows quering by
        * {@link https://pptr.dev/guides/page-interactions#text-selectors--p-text | text},
        * {@link https://pptr.dev/guides/page-interactions#aria-selectors--p-aria | a11y role and name},
        * and
        * {@link https://pptr.dev/guides/page-interactions#xpath-selectors--p-xpath | xpath}
        * and
-       * {@link https://pptr.dev/guides/page-interactions#-and--combinators | combining these queries across shadow roots}.
-       * Alternatively, you can specify a selector type using a prefix
-       * {@link https://pptr.dev/guides/page-interactions#built-in-selectors | prefix}.
+       * {@link https://pptr.dev/guides/page-interactions#querying-elements-in-shadow-dom | combining these queries across shadow roots}.
+       * Alternatively, you can specify the selector type using a
+       * {@link https://pptr.dev/guides/page-interactions#prefixed-selector-syntax | prefix}.
        * @param pageFunction - the function to be evaluated in the page context.
        * Will be passed an array of matching elements as its first argument.
        * @param args - any additional arguments to pass through to `pageFunction`.
@@ -19790,7 +19836,7 @@
        *   {@link Page.setDefaultTimeout} method.
        */
       waitForRequest(urlOrPredicate, options = {}) {
-        const { timeout: ms = this._timeoutSettings.timeout() } = options;
+        const { timeout: ms = this._timeoutSettings.timeout(), signal } = options;
         if (typeof urlOrPredicate === "string") {
           const url = urlOrPredicate;
           urlOrPredicate = (request) => {
@@ -19801,7 +19847,7 @@
           this,
           "request"
           /* PageEvent.Request */
-        ).pipe(filterAsync(urlOrPredicate), raceWith(timeout(ms), fromEmitterEvent(
+        ).pipe(filterAsync(urlOrPredicate), raceWith(timeout(ms), fromAbortSignal(signal), fromEmitterEvent(
           this,
           "close"
           /* PageEvent.Close */
@@ -19838,7 +19884,7 @@
        *   the {@link Page.setDefaultTimeout} method.
        */
       waitForResponse(urlOrPredicate, options = {}) {
-        const { timeout: ms = this._timeoutSettings.timeout() } = options;
+        const { timeout: ms = this._timeoutSettings.timeout(), signal } = options;
         if (typeof urlOrPredicate === "string") {
           const url = urlOrPredicate;
           urlOrPredicate = (response) => {
@@ -19849,7 +19895,7 @@
           this,
           "response"
           /* PageEvent.Response */
-        ).pipe(filterAsync(urlOrPredicate), raceWith(timeout(ms), fromEmitterEvent(
+        ).pipe(filterAsync(urlOrPredicate), raceWith(timeout(ms), fromAbortSignal(signal), fromEmitterEvent(
           this,
           "close"
           /* PageEvent.Close */
@@ -19871,14 +19917,14 @@
        * @internal
        */
       waitForNetworkIdle$(options = {}) {
-        const { timeout: ms = this._timeoutSettings.timeout(), idleTime = NETWORK_IDLE_TIME, concurrency = 0 } = options;
+        const { timeout: ms = this._timeoutSettings.timeout(), idleTime = NETWORK_IDLE_TIME, concurrency = 0, signal } = options;
         return this.#inflight$.pipe(switchMap((inflight) => {
           if (inflight > concurrency) {
             return EMPTY;
           }
           return timer(idleTime);
         }), map(() => {
-        }), raceWith(timeout(ms), fromEmitterEvent(
+        }), raceWith(timeout(ms), fromAbortSignal(signal), fromEmitterEvent(
           this,
           "close"
           /* PageEvent.Close */
@@ -19898,7 +19944,7 @@
        * ```
        */
       async waitForFrame(urlOrPredicate, options = {}) {
-        const { timeout: ms = this.getDefaultTimeout() } = options;
+        const { timeout: ms = this.getDefaultTimeout(), signal } = options;
         if (isString3(urlOrPredicate)) {
           urlOrPredicate = (frame) => {
             return urlOrPredicate === frame.url();
@@ -19912,7 +19958,7 @@
           this,
           "framenavigated"
           /* PageEvent.FrameNavigated */
-        ), from(this.frames())).pipe(filterAsync(urlOrPredicate), first(), raceWith(timeout(ms), fromEmitterEvent(
+        ), from(this.frames())).pipe(filterAsync(urlOrPredicate), first(), raceWith(timeout(ms), fromAbortSignal(signal), fromEmitterEvent(
           this,
           "close"
           /* PageEvent.Close */
@@ -20233,14 +20279,7 @@
                   ...scrollDimensions
                 });
                 stack.defer(async () => {
-                  if (viewport) {
-                    await this.setViewport(viewport).catch(debugError);
-                  } else {
-                    await this.setViewport({
-                      width: 0,
-                      height: 0
-                    }).catch(debugError);
-                  }
+                  await this.setViewport(viewport).catch(debugError);
                 });
               }
             } else {
@@ -20576,7 +20615,7 @@
     #args;
     #stackTraceLocations;
     /**
-     * @public
+     * @internal
      */
     constructor(type, text, args, stackTraceLocations) {
       this.#type = type;
@@ -21228,6 +21267,9 @@
   var Coverage = class {
     #jsCoverage;
     #cssCoverage;
+    /**
+     * @internal
+     */
     constructor(client) {
       this.#jsCoverage = new JSCoverage(client);
       this.#cssCoverage = new CSSCoverage(client);
@@ -21295,6 +21337,9 @@
     #resetOnNavigation = false;
     #reportAnonymousScripts = false;
     #includeRawScriptCoverage = false;
+    /**
+     * @internal
+     */
     constructor(client) {
       this.#client = client;
     }
@@ -21711,6 +21756,12 @@
         _private_setJavaScriptEnabled_decorators = [invokeAtMostOnceForArguments];
         __esDecorate4(this, _private_applyViewport_descriptor = { value: __setFunctionName2(async function(client, viewportState) {
           if (!viewportState.viewport) {
+            await Promise.all([
+              client.send("Emulation.clearDeviceMetricsOverride"),
+              client.send("Emulation.setTouchEmulationEnabled", {
+                enabled: false
+              })
+            ]).catch(debugError);
             return;
           }
           const { viewport } = viewportState;
@@ -21889,12 +21940,18 @@
         return this.#javascriptEnabledState.state.javaScriptEnabled;
       }
       async emulateViewport(viewport) {
-        await this.#viewportState.setState({
+        const currentState = this.#viewportState.state;
+        if (!viewport && !currentState.active) {
+          return false;
+        }
+        await this.#viewportState.setState(viewport ? {
           viewport,
           active: true
+        } : {
+          active: false
         });
-        const mobile = viewport.isMobile || false;
-        const hasTouch = viewport.hasTouch || false;
+        const mobile = viewport?.isMobile || false;
+        const hasTouch = viewport?.hasTouch || false;
         const reloadNeeded = this.#emulatingMobile !== mobile || this.#hasTouch !== hasTouch;
         this.#emulatingMobile = mobile;
         this.#hasTouch = hasTouch;
@@ -23001,10 +23058,11 @@
   };
   function parsePSelectors(selector) {
     let isPureCSS = true;
+    let hasAria = false;
     let hasPseudoClasses = false;
     const tokens = tokenize(selector);
     if (tokens.length === 0) {
-      return [[], isPureCSS, hasPseudoClasses];
+      return [[], isPureCSS, hasPseudoClasses, false];
     }
     let compoundSelector = [];
     let complexSelector = [compoundSelector];
@@ -23051,8 +23109,12 @@
             compoundSelector.push(stringify(storage));
             storage.splice(0);
           }
+          const name2 = token.name.slice(3);
+          if (name2 === "aria") {
+            hasAria = true;
+          }
           compoundSelector.push({
-            name: token.name.slice(3),
+            name: name2,
             value: unquote(token.argument ?? "")
           });
           continue;
@@ -23074,7 +23136,7 @@
     if (storage.length) {
       compoundSelector.push(stringify(storage));
     }
-    return [selectors, isPureCSS, hasPseudoClasses];
+    return [selectors, isPureCSS, hasPseudoClasses, hasAria];
   }
 
   // node_modules/puppeteer-core/lib/esm/puppeteer/common/TextQueryHandler.js
@@ -23123,7 +23185,7 @@
             selector = selector.slice(prefix.length);
             return {
               updatedSelector: selector,
-              selectorHasPseudoClasses: false,
+              polling: name2 === "aria" ? "raf" : "mutation",
               QueryHandler: QueryHandler2
             };
           }
@@ -23131,23 +23193,23 @@
       }
     }
     try {
-      const [pSelector, isPureCSS, hasPseudoClasses] = parsePSelectors(selector);
+      const [pSelector, isPureCSS, hasPseudoClasses, hasAria] = parsePSelectors(selector);
       if (isPureCSS) {
         return {
           updatedSelector: selector,
-          selectorHasPseudoClasses: hasPseudoClasses,
+          polling: hasPseudoClasses ? "raf" : "mutation",
           QueryHandler: CSSQueryHandler
         };
       }
       return {
         updatedSelector: JSON.stringify(pSelector),
-        selectorHasPseudoClasses: hasPseudoClasses,
+        polling: hasAria ? "raf" : "mutation",
         QueryHandler: PQueryHandler
       };
     } catch {
       return {
         updatedSelector: selector,
-        selectorHasPseudoClasses: false,
+        polling: "mutation",
         QueryHandler: CSSQueryHandler
       };
     }
@@ -23404,7 +23466,7 @@
        * Behaves identically to {@link Page.evaluateHandle} except it's run within
        * the context of this frame.
        *
-       * @see {@link Page.evaluateHandle} for details.
+       * See {@link Page.evaluateHandle} for details.
        */
       async evaluateHandle(pageFunction, ...args) {
         pageFunction = withSourcePuppeteerURLIfNone(this.evaluateHandle.name, pageFunction);
@@ -23414,7 +23476,7 @@
        * Behaves identically to {@link Page.evaluate} except it's run within
        * the context of this frame.
        *
-       * @see {@link Page.evaluate} for details.
+       * See {@link Page.evaluate} for details.
        */
       async evaluate(pageFunction, ...args) {
         pageFunction = withSourcePuppeteerURLIfNone(this.evaluate.name, pageFunction);
@@ -23434,20 +23496,20 @@
        * Queries the frame for an element matching the given selector.
        *
        * @param selector -
-       * {@link https://pptr.dev/guides/page-interactions#query-selectors | selector}
+       * {@link https://pptr.dev/guides/page-interactions#selectors | selector}
        * to query page for.
        * {@link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors | CSS selectors}
        * can be passed as-is and a
-       * {@link https://pptr.dev/guides/page-interactions#p-selectors | Puppeteer-specific seletor syntax}
+       * {@link https://pptr.dev/guides/page-interactions#non-css-selectors | Puppeteer-specific selector syntax}
        * allows quering by
        * {@link https://pptr.dev/guides/page-interactions#text-selectors--p-text | text},
        * {@link https://pptr.dev/guides/page-interactions#aria-selectors--p-aria | a11y role and name},
        * and
        * {@link https://pptr.dev/guides/page-interactions#xpath-selectors--p-xpath | xpath}
        * and
-       * {@link https://pptr.dev/guides/page-interactions#-and--combinators | combining these queries across shadow roots}.
-       * Alternatively, you can specify a selector type using a prefix
-       * {@link https://pptr.dev/guides/page-interactions#built-in-selectors | prefix}.
+       * {@link https://pptr.dev/guides/page-interactions#querying-elements-in-shadow-dom | combining these queries across shadow roots}.
+       * Alternatively, you can specify the selector type using a
+       * {@link https://pptr.dev/guides/page-interactions#prefixed-selector-syntax | prefix}.
        *
        * @returns A {@link ElementHandle | element handle} to the first element
        * matching the given selector. Otherwise, `null`.
@@ -23460,20 +23522,20 @@
        * Queries the frame for all elements matching the given selector.
        *
        * @param selector -
-       * {@link https://pptr.dev/guides/page-interactions#query-selectors | selector}
+       * {@link https://pptr.dev/guides/page-interactions#selectors | selector}
        * to query page for.
        * {@link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors | CSS selectors}
        * can be passed as-is and a
-       * {@link https://pptr.dev/guides/page-interactions#p-selectors | Puppeteer-specific seletor syntax}
+       * {@link https://pptr.dev/guides/page-interactions#non-css-selectors | Puppeteer-specific selector syntax}
        * allows quering by
        * {@link https://pptr.dev/guides/page-interactions#text-selectors--p-text | text},
        * {@link https://pptr.dev/guides/page-interactions#aria-selectors--p-aria | a11y role and name},
        * and
        * {@link https://pptr.dev/guides/page-interactions#xpath-selectors--p-xpath | xpath}
        * and
-       * {@link https://pptr.dev/guides/page-interactions#-and--combinators | combining these queries across shadow roots}.
-       * Alternatively, you can specify a selector type using a prefix
-       * {@link https://pptr.dev/guides/page-interactions#built-in-selectors | prefix}.
+       * {@link https://pptr.dev/guides/page-interactions#querying-elements-in-shadow-dom | combining these queries across shadow roots}.
+       * Alternatively, you can specify the selector type using a
+       * {@link https://pptr.dev/guides/page-interactions#prefixed-selector-syntax | prefix}.
        *
        * @returns An array of {@link ElementHandle | element handles} that point to
        * elements matching the given selector.
@@ -23496,20 +23558,20 @@
        * ```
        *
        * @param selector -
-       * {@link https://pptr.dev/guides/page-interactions#query-selectors | selector}
+       * {@link https://pptr.dev/guides/page-interactions#selectors | selector}
        * to query page for.
        * {@link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors | CSS selectors}
        * can be passed as-is and a
-       * {@link https://pptr.dev/guides/page-interactions#p-selectors | Puppeteer-specific seletor syntax}
+       * {@link https://pptr.dev/guides/page-interactions#non-css-selectors | Puppeteer-specific selector syntax}
        * allows quering by
        * {@link https://pptr.dev/guides/page-interactions#text-selectors--p-text | text},
        * {@link https://pptr.dev/guides/page-interactions#aria-selectors--p-aria | a11y role and name},
        * and
        * {@link https://pptr.dev/guides/page-interactions#xpath-selectors--p-xpath | xpath}
        * and
-       * {@link https://pptr.dev/guides/page-interactions#-and--combinators | combining these queries across shadow roots}.
-       * Alternatively, you can specify a selector type using a prefix
-       * {@link https://pptr.dev/guides/page-interactions#built-in-selectors | prefix}.
+       * {@link https://pptr.dev/guides/page-interactions#querying-elements-in-shadow-dom | combining these queries across shadow roots}.
+       * Alternatively, you can specify the selector type using a
+       * {@link https://pptr.dev/guides/page-interactions#prefixed-selector-syntax | prefix}.
        * @param pageFunction - The function to be evaluated in the frame's context.
        * The first element matching the selector will be passed to the function as
        * its first argument.
@@ -23535,20 +23597,20 @@
        * ```
        *
        * @param selector -
-       * {@link https://pptr.dev/guides/page-interactions#query-selectors | selector}
+       * {@link https://pptr.dev/guides/page-interactions#selectors | selector}
        * to query page for.
        * {@link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors | CSS selectors}
        * can be passed as-is and a
-       * {@link https://pptr.dev/guides/page-interactions#p-selectors | Puppeteer-specific seletor syntax}
+       * {@link https://pptr.dev/guides/page-interactions#non-css-selectors | Puppeteer-specific selector syntax}
        * allows quering by
        * {@link https://pptr.dev/guides/page-interactions#text-selectors--p-text | text},
        * {@link https://pptr.dev/guides/page-interactions#aria-selectors--p-aria | a11y role and name},
        * and
        * {@link https://pptr.dev/guides/page-interactions#xpath-selectors--p-xpath | xpath}
        * and
-       * {@link https://pptr.dev/guides/page-interactions#-and--combinators | combining these queries across shadow roots}.
-       * Alternatively, you can specify a selector type using a prefix
-       * {@link https://pptr.dev/guides/page-interactions#built-in-selectors | prefix}.
+       * {@link https://pptr.dev/guides/page-interactions#querying-elements-in-shadow-dom | combining these queries across shadow roots}.
+       * Alternatively, you can specify the selector type using a
+       * {@link https://pptr.dev/guides/page-interactions#prefixed-selector-syntax | prefix}.
        * @param pageFunction - The function to be evaluated in the frame's context.
        * An array of elements matching the given selector will be passed to the
        * function as its first argument.
@@ -23596,9 +23658,9 @@
        * @throws Throws if an element matching the given selector doesn't appear.
        */
       async waitForSelector(selector, options = {}) {
-        const { updatedSelector, QueryHandler: QueryHandler2, selectorHasPseudoClasses } = getQueryHandlerAndSelector(selector);
+        const { updatedSelector, QueryHandler: QueryHandler2, polling } = getQueryHandlerAndSelector(selector);
         return await QueryHandler2.waitFor(this, updatedSelector, {
-          polling: selectorHasPseudoClasses ? "raf" : void 0,
+          polling,
           ...options
         });
       }
@@ -24472,7 +24534,21 @@
       /**
        * Queries the current element for an element matching the given selector.
        *
-       * @param selector - The selector to query for.
+       * @param selector -
+       * {@link https://pptr.dev/guides/page-interactions#selectors | selector}
+       * to query page for.
+       * {@link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors | CSS selectors}
+       * can be passed as-is and a
+       * {@link https://pptr.dev/guides/page-interactions#non-css-selectors | Puppeteer-specific selector syntax}
+       * allows quering by
+       * {@link https://pptr.dev/guides/page-interactions#text-selectors--p-text | text},
+       * {@link https://pptr.dev/guides/page-interactions#aria-selectors--p-aria | a11y role and name},
+       * and
+       * {@link https://pptr.dev/guides/page-interactions#xpath-selectors--p-xpath | xpath}
+       * and
+       * {@link https://pptr.dev/guides/page-interactions#querying-elements-in-shadow-dom | combining these queries across shadow roots}.
+       * Alternatively, you can specify the selector type using a
+       * {@link https://pptr.dev/guides/page-interactions#prefixed-selector-syntax | prefix}.
        * @returns A {@link ElementHandle | element handle} to the first element
        * matching the given selector. Otherwise, `null`.
        */
@@ -24483,7 +24559,21 @@
       /**
        * Queries the current element for all elements matching the given selector.
        *
-       * @param selector - The selector to query for.
+       * @param selector -
+       * {@link https://pptr.dev/guides/page-interactions#selectors | selector}
+       * to query page for.
+       * {@link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors | CSS selectors}
+       * can be passed as-is and a
+       * {@link https://pptr.dev/guides/page-interactions#non-css-selectors | Puppeteer-specific selector syntax}
+       * allows quering by
+       * {@link https://pptr.dev/guides/page-interactions#text-selectors--p-text | text},
+       * {@link https://pptr.dev/guides/page-interactions#aria-selectors--p-aria | a11y role and name},
+       * and
+       * {@link https://pptr.dev/guides/page-interactions#xpath-selectors--p-xpath | xpath}
+       * and
+       * {@link https://pptr.dev/guides/page-interactions#querying-elements-in-shadow-dom | combining these queries across shadow roots}.
+       * Alternatively, you can specify the selector type using a
+       * {@link https://pptr.dev/guides/page-interactions#prefixed-selector-syntax | prefix}.
        * @returns An array of {@link ElementHandle | element handles} that point to
        * elements matching the given selector.
        */
@@ -24529,7 +24619,21 @@
        * );
        * ```
        *
-       * @param selector - The selector to query for.
+       * @param selector -
+       * {@link https://pptr.dev/guides/page-interactions#selectors | selector}
+       * to query page for.
+       * {@link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors | CSS selectors}
+       * can be passed as-is and a
+       * {@link https://pptr.dev/guides/page-interactions#non-css-selectors | Puppeteer-specific selector syntax}
+       * allows quering by
+       * {@link https://pptr.dev/guides/page-interactions#text-selectors--p-text | text},
+       * {@link https://pptr.dev/guides/page-interactions#aria-selectors--p-aria | a11y role and name},
+       * and
+       * {@link https://pptr.dev/guides/page-interactions#xpath-selectors--p-xpath | xpath}
+       * and
+       * {@link https://pptr.dev/guides/page-interactions#querying-elements-in-shadow-dom | combining these queries across shadow roots}.
+       * Alternatively, you can specify the selector type using a
+       * {@link https://pptr.dev/guides/page-interactions#prefixed-selector-syntax | prefix}.
        * @param pageFunction - The function to be evaluated in this element's page's
        * context. The first element matching the selector will be passed in as the
        * first argument.
@@ -24578,7 +24682,21 @@
        * ).toEqual(['Hello!', 'Hi!']);
        * ```
        *
-       * @param selector - The selector to query for.
+       * @param selector -
+       * {@link https://pptr.dev/guides/page-interactions#selectors | selector}
+       * to query page for.
+       * {@link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors | CSS selectors}
+       * can be passed as-is and a
+       * {@link https://pptr.dev/guides/page-interactions#non-css-selectors | Puppeteer-specific selector syntax}
+       * allows quering by
+       * {@link https://pptr.dev/guides/page-interactions#text-selectors--p-text | text},
+       * {@link https://pptr.dev/guides/page-interactions#aria-selectors--p-aria | a11y role and name},
+       * and
+       * {@link https://pptr.dev/guides/page-interactions#xpath-selectors--p-xpath | xpath}
+       * and
+       * {@link https://pptr.dev/guides/page-interactions#querying-elements-in-shadow-dom | combining these queries across shadow roots}.
+       * Alternatively, you can specify the selector type using a
+       * {@link https://pptr.dev/guides/page-interactions#prefixed-selector-syntax | prefix}.
        * @param pageFunction - The function to be evaluated in the element's page's
        * context. An array of elements matching the given selector will be passed to
        * the function as its first argument.
@@ -24645,9 +24763,9 @@
        * @throws Throws if an element matching the given selector doesn't appear.
        */
       async waitForSelector(selector, options = {}) {
-        const { updatedSelector, QueryHandler: QueryHandler2, selectorHasPseudoClasses } = getQueryHandlerAndSelector(selector);
+        const { updatedSelector, QueryHandler: QueryHandler2, polling } = getQueryHandlerAndSelector(selector);
         return await QueryHandler2.waitFor(this, updatedSelector, {
-          polling: selectorHasPseudoClasses ? "raf" : void 0,
+          polling,
           ...options
         });
       }
@@ -24659,15 +24777,32 @@
         }), visibility);
       }
       /**
-       * Checks if an element is visible using the same mechanism as
-       * {@link ElementHandle.waitForSelector}.
+       * An element is considered to be visible if all of the following is
+       * true:
+       *
+       * - the element has
+       *   {@link https://developer.mozilla.org/en-US/docs/Web/API/Window/getComputedStyle | computed styles}.
+       *
+       * - the element has a non-empty
+       *   {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/getBoundingClientRect | bounding client rect}.
+       *
+       * - the element's {@link https://developer.mozilla.org/en-US/docs/Web/CSS/visibility | visibility}
+       *   is not `hidden` or `collapse`.
        */
       async isVisible() {
         return await this.#checkVisibility(true);
       }
       /**
-       * Checks if an element is hidden using the same mechanism as
-       * {@link ElementHandle.waitForSelector}.
+       * An element is considered to be hidden if at least one of the following is true:
+       *
+       * - the element has no
+       *   {@link https://developer.mozilla.org/en-US/docs/Web/API/Window/getComputedStyle | computed styles}.
+       *
+       * - the element has an empty
+       *   {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/getBoundingClientRect | bounding client rect}.
+       *
+       * - the element's {@link https://developer.mozilla.org/en-US/docs/Web/CSS/visibility | visibility}
+       *   is `hidden` or `collapse`.
        */
       async isHidden() {
         return await this.#checkVisibility(false);
@@ -26791,7 +26926,7 @@ ${sourceUrlComment}
     async #waitForExecutionContext() {
       const result = await firstValueFrom(fromEmitterEvent(this.#emitter, "context").pipe(raceWith(fromEmitterEvent(this.#emitter, "disposed").pipe(map(() => {
         throw new Error("Execution context was destroyed");
-      })))));
+      })), timeout(this.timeoutSettings.timeout()))));
       return result;
     }
     async evaluateHandle(pageFunction, ...args) {
@@ -28975,7 +29110,7 @@ ${sourceUrlComment}
         }
         if (contextPayload.auxData && contextPayload.auxData["isDefault"]) {
           world = frame.worlds[MAIN_WORLD];
-        } else if (contextPayload.name === UTILITY_WORLD_NAME && !frame.worlds[PUPPETEER_WORLD].hasContext()) {
+        } else if (contextPayload.name === UTILITY_WORLD_NAME) {
           world = frame.worlds[PUPPETEER_WORLD];
         }
       }