Function screenshot

packages/browser/src/client/tester/context.ts:310–356

(options = {})

    })
  },
  async screenshot(options = {}) {
    const currentTest = getWorkerState().current
    if (!currentTest) {
      throw new Error('Cannot take a screenshot outside of a test.')
    }

    if (currentTest.concurrent) {
      throw new Error(
        'Cannot take a screenshot in a concurrent test because '
        + 'concurrent tests run at the same time in the same iframe and affect each other\'s environment. '
        + 'Use a non-concurrent test to take a screenshot.',
      )
    }

    const repeatCount = currentTest.result?.repeatCount ?? 0
    const taskName = getTaskFullName(currentTest)
    const number = screenshotIds[repeatCount]?.[taskName] ?? 1

    screenshotIds[repeatCount] ??= {}
    screenshotIds[repeatCount][taskName] = number + 1

    const name
      = options.path || `${taskName.replace(/[^a-z0-9]/gi, '-')}-${number}.png`

    const [element, ...mask] = await Promise.all([
      options.element ? convertToSelector(options.element, options) : undefined,
      ...('mask' in options
        ? (options.mask as Array<Element | Locator>).map(el => convertToSelector(el, options))
        : []),
    ])

    const normalizedOptions = 'mask' in options
      ? { ...options, mask }
      : options

    return ensureAwaited(error => triggerCommand(
      '__vitest_screenshot',
      [
        name,
        processTimeoutOptions({
          ...normalizedOptions,
          element,
        } as any /** TODO */),
      ],
      error,
    ))
  },
  mark<T>(
    name: string,
    bodyOrOptions?: MarkOptions | (() => T | Promise<T>),