@vitest/browser 5.0.0-beta.1 → 5.0.0-beta.2

package/context.d.ts

@@ -539,6 +539,11 @@ export interface LocatorSelectors {
 
 export interface FrameLocator extends LocatorSelectors {}
 
+export interface SerializedLocator {
+  selector: string
+  locator: string
+}
+
 export interface SelectorOptions {
   /**
    * How long to wait until a single element is found. By default, this has the same timeout as the test.
@@ -579,6 +584,32 @@ export interface Locator extends LocatorSelectors {
    */
   readonly length: number
 
+  /**
+   * Returns a JSON-serializable representation of the locator with two fields:
+   * - `selector`: the provider-specific selector string used to query the element at runtime.
+   * - `locator`: a human-readable description of the locator (e.g. `getByRole('button')`),
+   *   used for error messages and tracing.
+   *
+   * Use this to forward a locator to a [browser command](https://vitest.dev/api/browser/commands),
+   * which runs in Node and cannot receive a live `Locator` instance. Vitest also auto-serializes
+   * any `Locator` argument passed to a command, so calling `serialize()` explicitly is rarely necessary.
+   *
+   * @see {@link https://vitest.dev/api/browser/locators#serialize}
+   */
+  serialize(): SerializedLocator
+  /**
+   * Alias of {@link serialize}. Defined so that `JSON.stringify(locator)` and
+   * structured-clone-based transports return a {@link SerializedLocator} object.
+   *
+   * @see {@link https://vitest.dev/api/browser/locators#tojson}
+   */
+  toJSON(): SerializedLocator
+  /**
+   * A human-readable description of the locator (e.g. `getByRole('button')`).
+   *
+   * @see {@link https://vitest.dev/api/browser/locators#aslocator}
+   */
+  asLocator(): string
   /**
    * Click on an element. You can use the options to set the cursor position.
    * @see {@link https://vitest.dev/api/browser/interactivity#userevent-click}
@@ -934,7 +965,7 @@ export const utils: {
   /**
    * Creates "Cannot find element" error. Useful for custom locators.
    */
-  getElementError(selector: string, container?: Element): Error
+  getElementError(selector: string | Locator, container?: Element): Error
 
   /**
    * Utilities for generating and working with ARIA trees and templates.

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

@@ -5,26 +5,26 @@
     "src": "../../../../node_modules/.pnpm/rrweb-snapshot@2.0.0-alpha.20_patch_hash=d11ec9bd9b66247ba493ab5fd117fbf0b4cb6e5d0a6a7c600d1d844bfa3d3044/node_modules/rrweb-snapshot/dist/rrweb-snapshot.js",
     "isDynamicEntry": true
   },
-  "_utils-BYUpz6v6.js": {
-    "file": "__vitest_browser__/utils-BYUpz6v6.js",
+  "_utils-Nd8hqrhP.js": {
+    "file": "__vitest_browser__/utils-Nd8hqrhP.js",
     "name": "utils"
   },
   "orchestrator.html": {
-    "file": "__vitest_browser__/orchestrator-pTEf6o0n.js",
+    "file": "__vitest_browser__/orchestrator-BfoS0x4w.js",
     "name": "orchestrator",
     "src": "orchestrator.html",
     "isEntry": true,
     "imports": [
-      "_utils-BYUpz6v6.js"
+      "_utils-Nd8hqrhP.js"
     ]
   },
   "tester/tester.html": {
-    "file": "__vitest_browser__/tester-CIKiUsoz.js",
+    "file": "__vitest_browser__/tester-BJtW9QqZ.js",
     "name": "tester",
     "src": "tester/tester.html",
     "isEntry": true,
     "imports": [
-      "_utils-BYUpz6v6.js"
+      "_utils-Nd8hqrhP.js"
     ],
     "dynamicImports": [
       "../../../../node_modules/.pnpm/rrweb-snapshot@2.0.0-alpha.20_patch_hash=d11ec9bd9b66247ba493ab5fd117fbf0b4cb6e5d0a6a7c600d1d844bfa3d3044/node_modules/rrweb-snapshot/dist/rrweb-snapshot.js"