codeceptjs 3.7.5-beta.1 → 3.7.5-beta.11

package/typings/types.d.ts

@@ -2823,8 +2823,11 @@ declare namespace CodeceptJS {
      * @property [highlightElement] - highlight the interacting elements. Default: false. Note: only activate under verbose mode (--verbose).
      * @property [recordHar] - record HAR and will be saved to `output/har`. See more of [HAR options](https://playwright.dev/docs/api/class-browser#browser-new-context-option-record-har).
      * @property [testIdAttribute = data-testid] - locate elements based on the testIdAttribute. See more of [locate by test id](https://playwright.dev/docs/locators#locate-by-test-id).
+     * @property [customLocatorStrategies] - custom locator strategies. An object with keys as strategy names and values as JavaScript functions. Example: `{ byRole: (selector, root) => { return root.querySelector(\`[role="\${selector}\"]\`) } }`
      */
     // @ts-ignore
+    // @ts-ignore
+    // @ts-ignore
     type PlaywrightConfig = {
         url?: string;
         browser?: 'chromium' | 'firefox' | 'webkit' | 'electron';
@@ -2862,6 +2865,7 @@ declare namespace CodeceptJS {
         highlightElement?: boolean;
         recordHar?: any;
         testIdAttribute?: string;
+        customLocatorStrategies?: any;
     };
     /**
      * Uses [Playwright](https://github.com/microsoft/playwright) library to run tests inside:
@@ -6353,6 +6357,8 @@ declare namespace CodeceptJS {
      * @property [highlightElement] - highlight the interacting elements. Default: false. Note: only activate under verbose mode (--verbose).
      */
     // @ts-ignore
+    // @ts-ignore
+    // @ts-ignore
     type PuppeteerConfig = {
         url: string;
         basicAuth?: any;
@@ -6792,17 +6798,6 @@ declare namespace CodeceptJS {
          * {{ react }}
          */
         _locate(): void;
-        /**
-         * Get single element by different locator types, including strict locator
-         * Should be used in custom helpers:
-         *
-         * ```js
-         * const element = await this.helpers['Puppeteer']._locateElement({name: 'password'});
-         * ```
-         *
-         * {{ react }}
-         */
-        _locateElement(): void;
         /**
          * Find a checkbox by providing human-readable text:
          * NOTE: Assumes the checkable element exists
@@ -6839,17 +6834,6 @@ declare namespace CodeceptJS {
          * @returns WebElement of being used Web helper
          */
         grabWebElements(locator: CodeceptJS.LocatorOrString): Promise<any>;
-        /**
-         * Grab WebElement for given locator
-         * Resumes test execution, so **should be used inside an async function with `await`** operator.
-         *
-         * ```js
-         * const webElement = await I.grabWebElement('#button');
-         * ```
-         * @param locator - element located by CSS|XPath|strict locator.
-         * @returns WebElement of being used Web helper
-         */
-        grabWebElement(locator: CodeceptJS.LocatorOrString): Promise<any>;
         /**
          * Switch focus to a particular tab by its number. It waits tabs loading and then switch tab
          *
@@ -8305,22 +8289,6 @@ declare namespace CodeceptJS {
          */
         flushWebSocketMessages(): void;
     }
-    /**
-     * Find elements using Puppeteer's native element discovery methods
-     * Note: Unlike Playwright, Puppeteer's Locator API doesn't have .all() method for multiple elements
-     * @param matcher - Puppeteer context to search within
-     * @param locator - Locator specification
-     * @returns Array of ElementHandle objects
-     */
-    function findElements(matcher: any, locator: any | string): Promise<any[]>;
-    /**
-     * Find a single element using Puppeteer's native element discovery methods
-     * Note: Puppeteer Locator API doesn't have .first() method like Playwright
-     * @param matcher - Puppeteer context to search within
-     * @param locator - Locator specification
-     * @returns Single ElementHandle object
-     */
-    function findElement(matcher: any, locator: any | string): Promise<object>;
     /**
      * ## Configuration
      * @property [endpoint] - API base URL
@@ -8334,6 +8302,8 @@ declare namespace CodeceptJS {
      * @property [maxUploadFileSize] - set the max content file size in MB when performing api calls.
      */
     // @ts-ignore
+    // @ts-ignore
+    // @ts-ignore
     type RESTConfig = {
         endpoint?: string;
         prettyPrintJson?: boolean;
@@ -9540,6 +9510,8 @@ declare namespace CodeceptJS {
      * @property [logLevel = silent] - level of logging verbosity. Default: silent. Options: trace | debug | info | warn | error | silent. More info: https://webdriver.io/docs/configuration/#loglevel
      */
     // @ts-ignore
+    // @ts-ignore
+    // @ts-ignore
     type WebDriverConfig = {
         url: string;
         browser: string;
@@ -10010,17 +9982,6 @@ declare namespace CodeceptJS {
          * @returns WebElement of being used Web helper
          */
         grabWebElements(locator: CodeceptJS.LocatorOrString): Promise<any>;
-        /**
-         * Grab WebElement for given locator
-         * Resumes test execution, so **should be used inside an async function with `await`** operator.
-         *
-         * ```js
-         * const webElement = await I.grabWebElement('#button');
-         * ```
-         * @param locator - element located by CSS|XPath|strict locator.
-         * @returns WebElement of being used Web helper
-         */
-        grabWebElement(locator: CodeceptJS.LocatorOrString): Promise<any>;
         /**
          * Set [WebDriver timeouts](https://webdriver.io/docs/timeouts.html) in realtime.
          *
@@ -11565,13 +11526,6 @@ declare namespace CodeceptJS {
          * Loads tests by pattern or by config.tests
          */
         loadTests(pattern?: string): void;
-        /**
-         * Apply sharding to test files based on shard configuration
-         * @param testFiles - Array of test file paths
-         * @param shardConfig - Shard configuration in format "index/total" (e.g., "1/4")
-         * @returns - Filtered array of test files for this shard
-         */
-        _applySharding(testFiles: string[], shardConfig: string): string[];
         /**
          * Run a specific test or all loaded tests.
          */
@@ -12065,10 +12019,6 @@ declare namespace CodeceptJS {
          * Get a state of current queue and tasks
          */
         toString(): string;
-        /**
-         * Get current session ID
-         */
-        getCurrentSessionId(): string | null;
     }
     interface RecorderSession {
         running: boolean;