npm - @vitest/browser - Versions diffs - 2.1.0-beta.3 → 2.1.0-beta.4 - Mend

@vitest/browser 2.1.0-beta.3 → 2.1.0-beta.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (13) hide show

package/dist/client/.vite/manifest.json +1 -1
package/dist/client/__vitest_browser__/{tester-CRcWWhrn.js → tester-CuCeoNqh.js} +13 -1
package/dist/client/tester/tester.html +2 -2
package/dist/index-BHQhKvO1.js +207 -0
package/dist/locators/index.d.ts +1 -1
package/dist/locators/index.js +3 -1
package/dist/locators/playwright.js +14 -6
package/dist/locators/preview.js +15 -7
package/dist/locators/webdriverio.js +8 -6
package/dist/{index-BHH2eSIh.js → public-utils-D6S2-5kI.js} +42 -201
package/dist/utils.js +3 -0
package/package.json +11 -7
package/utils.d.ts +21 -0

package/dist/client/.vite/manifest.json CHANGED Viewed

@@ -13,7 +13,7 @@
     ]
   },
   "tester/tester.html": {
-    "file": "__vitest_browser__/tester-CRcWWhrn.js",
+    "file": "__vitest_browser__/tester-CuCeoNqh.js",
     "name": "tester",
     "src": "tester/tester.html",
     "isEntry": true,

package/dist/client/__vitest_browser__/{tester-CRcWWhrn.js → tester-CuCeoNqh.js} RENAMED Viewed

@@ -3,10 +3,10 @@ var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { en
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 import { a as getConfig, i as importFs, b as importId, e as extname, g as getBrowserState, _ as __vitePreload, j as join, c as getWorkerState } from "./preload-helper-Btt6SgIy.js";
 import { loadDiffConfig, loadSnapshotSerializers, takeCoverageInsideWorker, setupCommonEnv, startTests, collectTests, SpyModule } from "vitest/browser";
+import { page } from "@vitest/browser/context";
 import { globalChannel, channel, waitForChannel, client, onCancel } from "@vitest/browser/client";
 import { getSafeTimers, stringify, format, TraceMap, originalPositionFor } from "vitest/utils";
 import { VitestTestRunner, NodeBenchmarkRunner } from "vitest/runners";
-import { page } from "@vitest/browser/context";
 import { expect } from "vitest";
 function getType(value) {
   return Object.prototype.toString.apply(value).slice(8, -1);
@@ -11892,6 +11892,7 @@ async function setupExpectDom() {
     }, options);
   };
 }
+const cleanupSymbol = Symbol.for("vitest:component-cleanup");
 const url = new URL(location.href);
 const reloadStart = url.searchParams.get("__reloadStart");
 function debug(...args) {
@@ -11975,6 +11976,17 @@ async function executeTests(method, files) {
       }
     }
   } finally {
+    try {
+      if (cleanupSymbol in page) {
+        page[cleanupSymbol]();
+      }
+    } catch (error) {
+      await client.rpc.onUnhandledError({
+        name: error.name,
+        message: error.message,
+        stack: String(error.stack)
+      }, "Cleanup Error");
+    }
     state.environmentTeardownRun = true;
     debug("finished running tests");
     done(files);

package/dist/client/tester/tester.html CHANGED Viewed

@@ -20,10 +20,10 @@
     <script>{__VITEST_STATE__}</script>
     {__VITEST_INTERNAL_SCRIPTS__}
     {__VITEST_SCRIPTS__}
-    <script type="module" crossorigin src="/__vitest_browser__/tester-CRcWWhrn.js"></script>
+    <script type="module" crossorigin src="/__vitest_browser__/tester-CuCeoNqh.js"></script>
     <link rel="modulepreload" crossorigin href="/__vitest_browser__/preload-helper-Btt6SgIy.js">
   </head>
-  <body data-vitest-body>
+  <body>
     {__VITEST_APPEND__}
   </body>
 </html>

package/dist/index-BHQhKvO1.js ADDED Viewed

@@ -0,0 +1,207 @@
+import { server, page } from '@vitest/browser/context';
+import { I as Ivya, a as getByRoleSelector, c as getByAltTextSelector, g as getByLabelSelector, d as getByPlaceholderSelector, b as getByTestIdSelector, e as getByTextSelector, f as getByTitleSelector, h as getElementError } from './public-utils-D6S2-5kI.js';
+// @__NO_SIDE_EFFECTS__
+function getBrowserState() {
+  return window.__vitest_browser_runner__;
+}
+// @__NO_SIDE_EFFECTS__
+function getWorkerState() {
+  const state = window.__vitest_worker__;
+  if (!state) {
+    throw new Error("Worker state is not found. This is an issue with Vitest. Please, open an issue.");
+  }
+  return state;
+}
+// @__NO_SIDE_EFFECTS__
+function convertElementToCssSelector(element) {
+  if (!element || !(element instanceof Element)) {
+    throw new Error(
+      `Expected DOM element to be an instance of Element, received ${typeof element}`
+    );
+  }
+  return getUniqueCssSelector(element);
+}
+function escapeIdForCSSSelector(id) {
+  return id.split("").map((char) => {
+    const code = char.charCodeAt(0);
+    if (char === " " || char === "#" || char === "." || char === ":" || char === "[" || char === "]" || char === ">" || char === "+" || char === "~" || char === "\\") {
+      return `\\${char}`;
+    } else if (code >= 65536) {
+      return `\\${code.toString(16).toUpperCase().padStart(6, "0")} `;
+    } else if (code < 32 || code === 127) {
+      return `\\${code.toString(16).toUpperCase().padStart(2, "0")} `;
+    } else if (code >= 128) {
+      return `\\${code.toString(16).toUpperCase().padStart(2, "0")} `;
+    } else {
+      return char;
+    }
+  }).join("");
+}
+function getUniqueCssSelector(el) {
+  const path = [];
+  let parent;
+  let hasShadowRoot = false;
+  while (parent = getParent(el)) {
+    if (parent.shadowRoot) {
+      hasShadowRoot = true;
+    }
+    const tag = el.tagName;
+    if (el.id) {
+      path.push(`#${escapeIdForCSSSelector(el.id)}`);
+    } else if (!el.nextElementSibling && !el.previousElementSibling) {
+      path.push(tag.toLowerCase());
+    } else {
+      let index = 0;
+      let sameTagSiblings = 0;
+      let elementIndex = 0;
+      for (const sibling of parent.children) {
+        index++;
+        if (sibling.tagName === tag) {
+          sameTagSiblings++;
+        }
+        if (sibling === el) {
+          elementIndex = index;
+        }
+      }
+      if (sameTagSiblings > 1) {
+        path.push(`${tag.toLowerCase()}:nth-child(${elementIndex})`);
+      } else {
+        path.push(tag.toLowerCase());
+      }
+    }
+    el = parent;
+  }
+  return `${(/* @__PURE__ */ getBrowserState()).provider === "webdriverio" && hasShadowRoot ? ">>>" : ""}${path.reverse().join(" > ")}`;
+}
+function getParent(el) {
+  const parent = el.parentNode;
+  if (parent instanceof ShadowRoot) {
+    return parent.host;
+  }
+  return parent;
+}
+const selectorEngine = Ivya.create({
+  browser: ((name) => {
+    switch (name) {
+      case "edge":
+      case "chrome":
+        return "chromium";
+      case "safari":
+        return "webkit";
+      default:
+        return name;
+    }
+  })(server.config.browser.name),
+  testIdAttribute: server.config.browser.locators.testIdAttribute
+});
+class Locator {
+  _parsedSelector;
+  _container;
+  _pwSelector;
+  click(options = {}) {
+    return this.triggerCommand("__vitest_click", this.selector, options);
+  }
+  dblClick(options = {}) {
+    return this.triggerCommand("__vitest_dblClick", this.selector, options);
+  }
+  tripleClick(options = {}) {
+    return this.triggerCommand("__vitest_tripleClick", this.selector, options);
+  }
+  clear() {
+    return this.triggerCommand("__vitest_clear", this.selector);
+  }
+  hover(options) {
+    return this.triggerCommand("__vitest_hover", this.selector, options);
+  }
+  unhover(options) {
+    return this.triggerCommand("__vitest_hover", "html > body", options);
+  }
+  fill(text, options) {
+    return this.triggerCommand("__vitest_fill", this.selector, text, options);
+  }
+  dropTo(target, options = {}) {
+    return this.triggerCommand(
+      "__vitest_dragAndDrop",
+      this.selector,
+      target.selector,
+      options
+    );
+  }
+  selectOptions(value) {
+    const values = (Array.isArray(value) ? value : [value]).map((v) => {
+      if (typeof v !== "string") {
+        const selector = "element" in v ? v.selector : selectorEngine.generateSelectorSimple(v);
+        return { element: selector };
+      }
+      return v;
+    });
+    return this.triggerCommand("__vitest_selectOptions", this.selector, values);
+  }
+  screenshot(options) {
+    return page.screenshot({
+      ...options,
+      element: this
+    });
+  }
+  getByRole(role, options) {
+    return this.locator(getByRoleSelector(role, options));
+  }
+  getByAltText(text, options) {
+    return this.locator(getByAltTextSelector(text, options));
+  }
+  getByLabelText(text, options) {
+    return this.locator(getByLabelSelector(text, options));
+  }
+  getByPlaceholder(text, options) {
+    return this.locator(getByPlaceholderSelector(text, options));
+  }
+  getByTestId(testId) {
+    return this.locator(getByTestIdSelector(server.config.browser.locators.testIdAttribute, testId));
+  }
+  getByText(text, options) {
+    return this.locator(getByTextSelector(text, options));
+  }
+  getByTitle(title, options) {
+    return this.locator(getByTitleSelector(title, options));
+  }
+  query() {
+    const parsedSelector = this._parsedSelector || (this._parsedSelector = selectorEngine.parseSelector(this._pwSelector || this.selector));
+    return selectorEngine.querySelector(parsedSelector, document.documentElement, true);
+  }
+  element() {
+    const element = this.query();
+    if (!element) {
+      throw getElementError(this._pwSelector || this.selector, this._container || document.documentElement);
+    }
+    return element;
+  }
+  elements() {
+    const parsedSelector = this._parsedSelector || (this._parsedSelector = selectorEngine.parseSelector(this._pwSelector || this.selector));
+    return selectorEngine.querySelectorAll(parsedSelector, document.documentElement);
+  }
+  all() {
+    return this.elements().map((element) => this.elementLocator(element));
+  }
+  get state() {
+    return getBrowserState();
+  }
+  get worker() {
+    return getWorkerState();
+  }
+  get rpc() {
+    return this.worker.rpc;
+  }
+  triggerCommand(command, ...args) {
+    const filepath = this.worker.filepath || this.worker.current?.file?.filepath || void 0;
+    return this.rpc.triggerCommand(
+      this.state.contextId,
+      command,
+      filepath,
+      args
+    );
+  }
+}
+export { Locator as L, convertElementToCssSelector as c, selectorEngine as s };

package/dist/locators/index.d.ts CHANGED Viewed

@@ -221,8 +221,8 @@ declare const selectorEngine: Ivya;
 declare abstract class Locator {
     abstract selector: string;
     private _parsedSelector;
+    protected _container?: Element | undefined;
     protected _pwSelector?: string | undefined;
-    protected _forceElement?: Element | undefined;
     click(options?: UserEventClickOptions): Promise<void>;
     dblClick(options?: UserEventClickOptions): Promise<void>;
     tripleClick(options?: UserEventClickOptions): Promise<void>;

package/dist/locators/index.js CHANGED Viewed

@@ -1,2 +1,4 @@
 import '@vitest/browser/context';
-export { L as Locator, s as selectorEngine } from '../index-BHH2eSIh.js';
+import '../public-utils-D6S2-5kI.js';
+export { L as Locator, s as selectorEngine } from '../index-BHQhKvO1.js';
+import 'vitest/utils';

package/dist/locators/playwright.js CHANGED Viewed

@@ -1,5 +1,7 @@
 import { page, server } from '@vitest/browser/context';
-import { g as getByLabelSelector, a as getByRoleSelector, b as getByTestIdSelector, c as getByAltTextSelector, d as getByPlaceholderSelector, e as getByTextSelector, f as getByTitleSelector, s as selectorEngine, L as Locator } from '../index-BHH2eSIh.js';
+import { g as getByLabelSelector, a as getByRoleSelector, b as getByTestIdSelector, c as getByAltTextSelector, d as getByPlaceholderSelector, e as getByTextSelector, f as getByTitleSelector } from '../public-utils-D6S2-5kI.js';
+import { s as selectorEngine, L as Locator } from '../index-BHQhKvO1.js';
+import 'vitest/utils';
 page.extend({
   getByLabelText(text, options) {
@@ -24,19 +26,25 @@ page.extend({
     return new PlaywrightLocator(getByTitleSelector(title, options));
   },
   elementLocator(element) {
-    return new PlaywrightLocator(selectorEngine.generateSelectorSimple(element), element);
+    return new PlaywrightLocator(
+      selectorEngine.generateSelectorSimple(element),
+      element
+    );
   }
 });
 class PlaywrightLocator extends Locator {
-  constructor(selector, _forceElement) {
+  constructor(selector, _container) {
     super();
     this.selector = selector;
-    this._forceElement = _forceElement;
+    this._container = _container;
   }
   locator(selector) {
-    return new PlaywrightLocator(`${this.selector} >> ${selector}`);
+    return new PlaywrightLocator(`${this.selector} >> ${selector}`, this._container);
   }
   elementLocator(element) {
-    return new PlaywrightLocator(selectorEngine.generateSelectorSimple(element), element);
+    return new PlaywrightLocator(
+      selectorEngine.generateSelectorSimple(element),
+      element
+    );
   }
 }

package/dist/locators/preview.js CHANGED Viewed

@@ -1,6 +1,8 @@
 import { page, server } from '@vitest/browser/context';
 import { userEvent } from '@testing-library/user-event';
-import { g as getByLabelSelector, a as getByRoleSelector, b as getByTestIdSelector, c as getByAltTextSelector, d as getByPlaceholderSelector, e as getByTextSelector, f as getByTitleSelector, s as selectorEngine, L as Locator, h as convertElementToCssSelector } from '../index-BHH2eSIh.js';
+import { g as getByLabelSelector, a as getByRoleSelector, b as getByTestIdSelector, c as getByAltTextSelector, d as getByPlaceholderSelector, e as getByTextSelector, f as getByTitleSelector, h as getElementError } from '../public-utils-D6S2-5kI.js';
+import { s as selectorEngine, L as Locator, c as convertElementToCssSelector } from '../index-BHQhKvO1.js';
+import 'vitest/utils';
 page.extend({
   getByLabelText(text, options) {
@@ -25,19 +27,22 @@ page.extend({
     return new PreviewLocator(getByTitleSelector(title, options));
   },
   elementLocator(element) {
-    return new PreviewLocator(selectorEngine.generateSelectorSimple(element), element);
+    return new PreviewLocator(
+      selectorEngine.generateSelectorSimple(element),
+      element
+    );
   }
 });
 class PreviewLocator extends Locator {
-  constructor(_pwSelector, _forceElement) {
+  constructor(_pwSelector, _container) {
     super();
     this._pwSelector = _pwSelector;
-    this._forceElement = _forceElement;
+    this._container = _container;
   }
   get selector() {
     const selectors = this.elements().map((element) => convertElementToCssSelector(element));
     if (!selectors.length) {
-      throw new Error(`element not found: ${this._pwSelector}`);
+      throw getElementError(this._pwSelector, this._container || document.documentElement);
     }
     return selectors.join(", ");
   }
@@ -78,9 +83,12 @@ class PreviewLocator extends Locator {
     throw new Error('The "preview" provider doesn\'t support `screenshot` method.');
   }
   locator(selector) {
-    return new PreviewLocator(`${this._pwSelector} >> ${selector}`);
+    return new PreviewLocator(`${this._pwSelector} >> ${selector}`, this._container);
   }
   elementLocator(element) {
-    return new PreviewLocator(selectorEngine.generateSelectorSimple(element), element);
+    return new PreviewLocator(
+      selectorEngine.generateSelectorSimple(element),
+      element
+    );
   }
 }

package/dist/locators/webdriverio.js CHANGED Viewed

@@ -1,5 +1,7 @@
 import { page, server } from '@vitest/browser/context';
-import { g as getByLabelSelector, a as getByRoleSelector, b as getByTestIdSelector, c as getByAltTextSelector, d as getByPlaceholderSelector, e as getByTextSelector, f as getByTitleSelector, s as selectorEngine, L as Locator, h as convertElementToCssSelector } from '../index-BHH2eSIh.js';
+import { g as getByLabelSelector, a as getByRoleSelector, b as getByTestIdSelector, c as getByAltTextSelector, d as getByPlaceholderSelector, e as getByTextSelector, f as getByTitleSelector, h as getElementError } from '../public-utils-D6S2-5kI.js';
+import { s as selectorEngine, L as Locator, c as convertElementToCssSelector } from '../index-BHQhKvO1.js';
+import 'vitest/utils';
 page.extend({
   getByLabelText(text, options) {
@@ -24,19 +26,19 @@ page.extend({
     return new WebdriverIOLocator(getByTitleSelector(title, options));
   },
   elementLocator(element) {
-    return new WebdriverIOLocator(selectorEngine.generateSelectorSimple(element), element);
+    return new WebdriverIOLocator(selectorEngine.generateSelectorSimple(element));
   }
 });
 class WebdriverIOLocator extends Locator {
-  constructor(_pwSelector, _forceElement) {
+  constructor(_pwSelector, _container) {
     super();
     this._pwSelector = _pwSelector;
-    this._forceElement = _forceElement;
+    this._container = _container;
   }
   get selector() {
     const selectors = this.elements().map((element) => convertElementToCssSelector(element));
     if (!selectors.length) {
-      throw new Error(`element not found: ${this._pwSelector}`);
+      throw getElementError(this._pwSelector, this._container || document.documentElement);
     }
     return selectors.join(", ");
   }
@@ -45,7 +47,7 @@ class WebdriverIOLocator extends Locator {
     return this.triggerCommand("__vitest_selectOptions", this.selector, values);
   }
   locator(selector) {
-    return new WebdriverIOLocator(`${this._pwSelector} >> ${selector}`);
+    return new WebdriverIOLocator(`${this._pwSelector} >> ${selector}`, this._container);
   }
   elementLocator(element) {
     return new WebdriverIOLocator(selectorEngine.generateSelectorSimple(element), element);

package/dist/{index-BHH2eSIh.js → public-utils-D6S2-5kI.js} RENAMED Viewed

@@ -1,4 +1,5 @@
-import { server, page } from '@vitest/browser/context';
+import { page } from '@vitest/browser/context';
+import { stringify } from 'vitest/utils';
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
@@ -5510,213 +5511,53 @@ function getByRoleSelector(role, options = {}) {
   return `internal:role=${role}${props.map(([n, v]) => `[${n}=${v}]`).join("")}`;
 }
-// @__NO_SIDE_EFFECTS__
-function getBrowserState() {
-  return window.__vitest_browser_runner__;
+function getElementLocatorSelectors(element) {
+  const locator = page.elementLocator(element);
+  return {
+    getByAltText: (altText, options) => locator.getByAltText(altText, options),
+    getByLabelText: (labelText, options) => locator.getByLabelText(labelText, options),
+    getByPlaceholder: (placeholderText, options) => locator.getByPlaceholder(placeholderText, options),
+    getByRole: (role, options) => locator.getByRole(role, options),
+    getByTestId: (testId) => locator.getByTestId(testId),
+    getByText: (text, options) => locator.getByText(text, options),
+    getByTitle: (title, options) => locator.getByTitle(title, options)
+  };
 }
-// @__NO_SIDE_EFFECTS__
-function getWorkerState() {
-  const state = window.__vitest_worker__;
-  if (!state) {
-    throw new Error("Worker state is not found. This is an issue with Vitest. Please, open an issue.");
+function debug(el, maxLength, options) {
+  if (Array.isArray(el)) {
+    el.forEach((e) => console.log(prettyDOM(e, maxLength, options)));
+  } else {
+    console.log(prettyDOM(el, maxLength, options));
   }
-  return state;
 }
-// @__NO_SIDE_EFFECTS__
-function convertElementToCssSelector(element) {
-  if (!element || !(element instanceof Element)) {
-    throw new Error(
-      `Expected DOM element to be an instance of Element, received ${typeof element}`
-    );
+function prettyDOM(dom, maxLength = Number(import.meta.env.DEBUG_PRINT_LIMIT ?? 7e3), prettyFormatOptions = {}) {
+  if (maxLength === 0) {
+    return "";
   }
-  return getUniqueCssSelector(element);
-}
-function escapeIdForCSSSelector(id) {
-  return id.split("").map((char) => {
-    const code = char.charCodeAt(0);
-    if (char === " " || char === "#" || char === "." || char === ":" || char === "[" || char === "]" || char === ">" || char === "+" || char === "~" || char === "\\") {
-      return `\\${char}`;
-    } else if (code >= 65536) {
-      return `\\${code.toString(16).toUpperCase().padStart(6, "0")} `;
-    } else if (code < 32 || code === 127) {
-      return `\\${code.toString(16).toUpperCase().padStart(2, "0")} `;
-    } else if (code >= 128) {
-      return `\\${code.toString(16).toUpperCase().padStart(2, "0")} `;
-    } else {
-      return char;
-    }
-  }).join("");
-}
-function getUniqueCssSelector(el) {
-  const path = [];
-  let parent;
-  let hasShadowRoot = false;
-  while (parent = getParent(el)) {
-    if (parent.shadowRoot) {
-      hasShadowRoot = true;
-    }
-    const tag = el.tagName;
-    if (el.id) {
-      path.push(`#${escapeIdForCSSSelector(el.id)}`);
-    } else if (!el.nextElementSibling && !el.previousElementSibling) {
-      path.push(tag.toLowerCase());
-    } else {
-      let index = 0;
-      let sameTagSiblings = 0;
-      let elementIndex = 0;
-      for (const sibling of parent.children) {
-        index++;
-        if (sibling.tagName === tag) {
-          sameTagSiblings++;
-        }
-        if (sibling === el) {
-          elementIndex = index;
-        }
-      }
-      if (sameTagSiblings > 1) {
-        path.push(`${tag.toLowerCase()}:nth-child(${elementIndex})`);
-      } else {
-        path.push(tag.toLowerCase());
-      }
-    }
-    el = parent;
+  if (!dom) {
+    dom = document.body;
   }
-  return `${(/* @__PURE__ */ getBrowserState()).provider === "webdriverio" && hasShadowRoot ? ">>>" : ""}${path.reverse().join(" > ")}`;
-}
-function getParent(el) {
-  const parent = el.parentNode;
-  if (parent instanceof ShadowRoot) {
-    return parent.host;
+  if ("element" in dom && "all" in dom) {
+    dom = dom.element();
   }
-  return parent;
+  const type = typeof dom;
+  if (type !== "object" || !dom.outerHTML) {
+    const typeName = type === "object" ? dom.constructor.name : type;
+    throw new TypeError(`Expecting a valid DOM element, but got ${typeName}.`);
+  }
+  const pretty = stringify(dom, Number.POSITIVE_INFINITY, {
+    maxLength,
+    highlight: true,
+    ...prettyFormatOptions
+  });
+  return dom.outerHTML.length > maxLength ? `${pretty.slice(0, maxLength)}...` : pretty;
 }
+function getElementError(selector, container) {
+  const error = new Error(`Cannot find element with locator: ${asLocator("javascript", selector)}
-const selectorEngine = Ivya.create({
-  browser: ((name) => {
-    switch (name) {
-      case "edge":
-      case "chrome":
-        return "chromium";
-      case "safari":
-        return "webkit";
-      default:
-        return name;
-    }
-  })(server.config.browser.name),
-  testIdAttribute: server.config.browser.locators.testIdAttribute
-});
-class Locator {
-  _parsedSelector;
-  _pwSelector;
-  _forceElement;
-  click(options = {}) {
-    return this.triggerCommand("__vitest_click", this.selector, options);
-  }
-  dblClick(options = {}) {
-    return this.triggerCommand("__vitest_dblClick", this.selector, options);
-  }
-  tripleClick(options = {}) {
-    return this.triggerCommand("__vitest_tripleClick", this.selector, options);
-  }
-  clear() {
-    return this.triggerCommand("__vitest_clear", this.selector);
-  }
-  hover(options) {
-    return this.triggerCommand("__vitest_hover", this.selector, options);
-  }
-  unhover(options) {
-    return this.triggerCommand("__vitest_hover", "html > body", options);
-  }
-  fill(text, options) {
-    return this.triggerCommand("__vitest_fill", this.selector, text, options);
-  }
-  dropTo(target, options = {}) {
-    return this.triggerCommand(
-      "__vitest_dragAndDrop",
-      this.selector,
-      target.selector,
-      options
-    );
-  }
-  selectOptions(value) {
-    const values = (Array.isArray(value) ? value : [value]).map((v) => {
-      if (typeof v !== "string") {
-        const selector = "element" in v ? v.selector : selectorEngine.generateSelectorSimple(v);
-        return { element: selector };
-      }
-      return v;
-    });
-    return this.triggerCommand("__vitest_selectOptions", this.selector, values);
-  }
-  screenshot(options) {
-    return page.screenshot({
-      ...options,
-      element: this
-    });
-  }
-  getByRole(role, options) {
-    return this.locator(getByRoleSelector(role, options));
-  }
-  getByAltText(text, options) {
-    return this.locator(getByAltTextSelector(text, options));
-  }
-  getByLabelText(text, options) {
-    return this.locator(getByLabelSelector(text, options));
-  }
-  getByPlaceholder(text, options) {
-    return this.locator(getByPlaceholderSelector(text, options));
-  }
-  getByTestId(testId) {
-    return this.locator(getByTestIdSelector(server.config.browser.locators.testIdAttribute, testId));
-  }
-  getByText(text, options) {
-    return this.locator(getByTextSelector(text, options));
-  }
-  getByTitle(title, options) {
-    return this.locator(getByTitleSelector(title, options));
-  }
-  query() {
-    if (this._forceElement) {
-      return this._forceElement;
-    }
-    const parsedSelector = this._parsedSelector || (this._parsedSelector = selectorEngine.parseSelector(this._pwSelector || this.selector));
-    return selectorEngine.querySelector(parsedSelector, document.documentElement, true);
-  }
-  element() {
-    const element = this.query();
-    if (!element) {
-      throw new Error(`element not found: ${asLocator("javascript", this._pwSelector || this.selector)}`);
-    }
-    return element;
-  }
-  elements() {
-    if (this._forceElement) {
-      return [this._forceElement];
-    }
-    const parsedSelector = this._parsedSelector || (this._parsedSelector = selectorEngine.parseSelector(this._pwSelector || this.selector));
-    return selectorEngine.querySelectorAll(parsedSelector, document.documentElement);
-  }
-  all() {
-    return this.elements().map((element) => this.elementLocator(element));
-  }
-  get state() {
-    return getBrowserState();
-  }
-  get worker() {
-    return getWorkerState();
-  }
-  get rpc() {
-    return this.worker.rpc;
-  }
-  triggerCommand(command, ...args) {
-    const filepath = this.worker.filepath || this.worker.current?.file?.filepath || void 0;
-    return this.rpc.triggerCommand(
-      this.state.contextId,
-      command,
-      filepath,
-      args
-    );
-  }
+${prettyDOM(container)}`);
+  error.name = "VitestBrowserElementError";
+  return error;
 }
-export { Locator as L, getByRoleSelector as a, getByTestIdSelector as b, getByAltTextSelector as c, getByPlaceholderSelector as d, getByTextSelector as e, getByTitleSelector as f, getByLabelSelector as g, convertElementToCssSelector as h, selectorEngine as s };
+export { Ivya as I, getByRoleSelector as a, getByTestIdSelector as b, getByAltTextSelector as c, getByPlaceholderSelector as d, getByTextSelector as e, getByTitleSelector as f, getByLabelSelector as g, getElementError as h, getElementLocatorSelectors as i, debug as j, prettyDOM as p };

package/dist/utils.js ADDED Viewed

@@ -0,0 +1,3 @@
+import '@vitest/browser/context';
+import 'vitest/utils';
+export { j as debug, h as getElementError, i as getElementLocatorSelectors, p as prettyDOM } from './public-utils-D6S2-5kI.js';

package/package.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "@vitest/browser",
   "type": "module",
-  "version": "2.1.0-beta.3",
+  "version": "2.1.0-beta.4",
   "description": "Browser running for Vitest",
   "license": "MIT",
   "funding": "https://opencollective.com/vitest",
@@ -44,6 +44,10 @@
       "types": "./dist/locators/index.d.ts",
       "default": "./dist/locators/index.js"
     },
+    "./utils": {
+      "types": "./utils.d.ts",
+      "default": "./dist/utils.js"
+    },
     "./*": "./*"
   },
   "main": "./dist/index.js",
@@ -58,7 +62,7 @@
   "peerDependencies": {
     "playwright": "*",
     "webdriverio": "*",
-    "vitest": "2.1.0-beta.3"
+    "vitest": "2.1.0-beta.4"
   },
   "peerDependenciesMeta": {
     "playwright": {
@@ -78,7 +82,7 @@
     "msw": "^2.3.5",
     "sirv": "^2.0.4",
     "ws": "^8.18.0",
-    "@vitest/utils": "2.1.0-beta.3"
+    "@vitest/utils": "2.1.0-beta.4"
   },
   "devDependencies": {
     "@testing-library/jest-dom": "^6.4.8",
@@ -93,10 +97,10 @@
     "playwright-core": "^1.45.3",
     "safaridriver": "^0.1.2",
     "webdriverio": "^8.39.1",
-    "@vitest/runner": "2.1.0-beta.3",
-    "@vitest/ui": "2.1.0-beta.3",
-    "@vitest/ws-client": "2.1.0-beta.3",
-    "vitest": "2.1.0-beta.3"
+    "@vitest/ui": "2.1.0-beta.4",
+    "vitest": "2.1.0-beta.4",
+    "@vitest/runner": "2.1.0-beta.4",
+    "@vitest/ws-client": "2.1.0-beta.4"
   },
   "scripts": {
     "build": "rimraf dist && pnpm build:node && pnpm build:client",

package/utils.d.ts ADDED Viewed

@@ -0,0 +1,21 @@
+// should be in sync with tester/public-utils.ts
+// we cannot bundle it because vitest depend on the @vitest/browser and vise versa
+// fortunately, the file is quite small
+import { LocatorSelectors } from '@vitest/browser/context'
+import { StringifyOptions } from 'vitest/utils'
+type PrettyDOMOptions = Omit<StringifyOptions, 'maxLength'>
+export declare function getElementLocatorSelectors(element: Element): LocatorSelectors
+export declare function debug(
+  el?: Element | Locator | null | (Element | Locator)[],
+  maxLength?: number,
+  options?: PrettyDOMOptions,
+): void
+export declare function prettyDOM(
+  dom?: Element | Locator | undefined | null,
+  maxLength?: number,
+  prettyFormatOptions?: PrettyDOMOptions,
+): string
+export declare function getElementError(selector: string, container?: Element): Error