@vitest/browser 4.1.0-beta.5 → 4.1.0

package/README.md

@@ -1,11 +1,11 @@
 # @vitest/browser
 
-[![NPM version](https://img.shields.io/npm/v/@vitest/browser?color=a1b858&label=)](https://www.npmjs.com/package/@vitest/browser)
+[![NPM version](https://img.shields.io/npm/v/@vitest/browser?color=a1b858&label=)](https://npmx.dev/package/@vitest/browser)
 
 This package exposes utilities to make your own browser provider. If you just need to run tests in the browser, consider installing one of these packages instead:
 
-- [@vitest/browser-playwright](https://www.npmjs.com/package/@vitest/browser-playwright) - run tests using [playwright](https://playwright.dev/)
-- [@vitest/browser-webdriverio](https://www.npmjs.com/package/@vitest/browser-webdriverio) - run tests using [webdriverio](https://webdriver.io/)
-- [@vitest/browser-preview](https://www.npmjs.com/package/@vitest/browser-preview) to see how your tests look like in a real browser.
+- [@vitest/browser-playwright](https://npmx.dev/package/@vitest/browser-playwright) - run tests using [playwright](https://playwright.dev/)
+- [@vitest/browser-webdriverio](https://npmx.dev/package/@vitest/browser-webdriverio) - run tests using [webdriverio](https://webdriver.io/)
+- [@vitest/browser-preview](https://npmx.dev/package/@vitest/browser-preview) to see how your tests look like in a real browser.
 
 [GitHub](https://github.com/vitest-dev/vitest) | [Documentation](https://vitest.dev/guide/browser/)

package/context.d.ts

@@ -1,5 +1,5 @@
 import { SerializedConfig } from 'vitest'
-import { StringifyOptions, BrowserCommands } from 'vitest/internal/browser'
+import { StringifyOptions, CDPSession, BrowserCommands } from 'vitest/internal/browser'
 import { ARIARole } from './aria-role.js'
 import {} from './matchers.js'
 
@@ -17,9 +17,7 @@ export type BufferEncoding =
   | 'binary'
   | 'hex'
 
-export interface CDPSession {
-  // methods are defined by the provider type augmentation
-}
+export { CDPSession };
 
 export interface ScreenshotOptions extends SelectorOptions {
   /**
@@ -43,6 +41,14 @@ export interface ScreenshotOptions extends SelectorOptions {
   save?: boolean
 }
 
+export interface MarkOptions {
+  /**
+   * Optional stack string used to resolve marker location.
+   * Useful for wrapper libraries that need to forward the end-user callsite.
+   */
+  stack?: string
+}
+
 interface StandardScreenshotComparators {
   pixelmatch: {
     /**
@@ -489,7 +495,7 @@ export interface LocatorByRoleOptions extends LocatorOptions {
   selected?: boolean
 }
 
-interface LocatorScreenshotOptions extends Omit<ScreenshotOptions, 'element'> {}
+export interface LocatorScreenshotOptions extends Omit<ScreenshotOptions, 'element'> {}
 
 export interface LocatorSelectors {
   /**
@@ -653,6 +659,12 @@ export interface Locator extends LocatorSelectors {
   }>
   screenshot(options?: LocatorScreenshotOptions): Promise<string>
 
+  /**
+   * Add a trace marker for this locator when browser tracing is enabled.
+   * @see {@link https://vitest.dev/api/browser/locators#mark}
+   */
+  mark(name: string, options?: MarkOptions): Promise<void>
+
   /**
    * Returns an element matching the selector.
    *
@@ -816,6 +828,16 @@ export interface BrowserPage extends LocatorSelectors {
     path: string
     base64: string
   }>
+  /**
+   * Add a trace marker when browser tracing is enabled.
+   * @see {@link https://vitest.dev/api/browser/context#mark}
+   */
+  mark(name: string, options?: MarkOptions): Promise<void>
+  /**
+   * Group multiple operations under a trace marker when browser tracing is enabled.
+   * @see {@link https://vitest.dev/api/browser/context#mark}
+   */
+  mark<T>(name: string, body: () => T | Promise<T>, options?: MarkOptions): Promise<T>
   /**
    * Extend default `page` object with custom methods.
    */

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

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