@vitest/browser 3.2.0-beta.1 → 3.2.0-beta.3

package/context.d.ts

@@ -29,12 +29,19 @@ export interface ScreenshotOptions {
   element?: Element | Locator
   /**
    * Path relative to the current test file.
+   * @default `__screenshots__/${testFileName}/${testName}.png`
    */
   path?: string
   /**
    * Will also return the base64 encoded screenshot alongside the path.
    */
   base64?: boolean
+  /**
+   * Keep the screenshot on the file system. If file is not saved,
+   * `page.screenshot` always returns `base64` screenshot.
+   * @default true
+   */
+  save?: boolean
 }
 
 export interface BrowserCommands {
@@ -373,7 +380,7 @@ export interface Locator extends LocatorSelectors {
    */
   unhover(options?: UserEventHoverOptions): Promise<void>
   /**
-   * Sets the value of the current `input`, `textarea` or `conteneditable` element.
+   * Sets the value of the current `input`, `textarea` or `contenteditable` element.
    * @see {@link https://vitest.dev/guide/browser/interactivity-api#userevent-fill}
    */
   fill(text: string, options?: UserEventFillOptions): Promise<void>
@@ -552,11 +559,16 @@ export interface BrowserPage extends LocatorSelectors {
    * Make a screenshot of the test iframe or a specific element.
    * @returns Path to the screenshot file or path and base64.
    */
+  screenshot(options: Omit<ScreenshotOptions, 'save'> & { save: false }): Promise<string>
   screenshot(options: Omit<ScreenshotOptions, 'base64'> & { base64: true }): Promise<{
     path: string
     base64: string
   }>
-  screenshot(options?: ScreenshotOptions): Promise<string>
+  screenshot(options?: Omit<ScreenshotOptions, 'base64'>): Promise<string>
+  screenshot(options?: ScreenshotOptions): Promise<string | {
+    path: string
+    base64: string
+  }>
   /**
    * Extend default `page` object with custom methods.
    */
@@ -568,5 +580,14 @@ export interface BrowserPage extends LocatorSelectors {
   elementLocator(element: Element): Locator
 }
 
+export interface BrowserLocators {
+  createElementLocators(element: Element): LocatorSelectors
+  extend(methods: {
+    [K in keyof LocatorSelectors]?: (...args: Parameters<LocatorSelectors[K]>) => ReturnType<LocatorSelectors[K]> | string
+  }): void
+}
+
+export const locators: BrowserLocators
+
 export const page: BrowserPage
 export const cdp: () => CDPSession

package/context.js

@@ -6,6 +6,7 @@ export const server = null
 export const userEvent = null
 export const cdp = null
 export const commands = null
+export const locators = null
 
 const pool = globalThis.__vitest_worker__?.ctx?.pool
 

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

@@ -4,7 +4,7 @@
     "name": "utils"
   },
   "orchestrator.html": {
-    "file": "__vitest_browser__/orchestrator-CuTjqoE1.js",
+    "file": "__vitest_browser__/orchestrator-Bsc_nLaw.js",
     "name": "orchestrator",
     "src": "orchestrator.html",
     "isEntry": true,
@@ -13,7 +13,7 @@
     ]
   },
   "tester/tester.html": {
-    "file": "__vitest_browser__/tester-D-yxPeOx.js",
+    "file": "__vitest_browser__/tester-BV-CSJ5v.js",
     "name": "tester",
     "src": "tester/tester.html",
     "isEntry": true,