Function VitestPlugin

packages/vitest/src/node/plugins/index.ts:26–291

(
  options: UserConfig = {},
  vitest: Vitest = new Vitest('test', deepClone(options)),
)

import { VitestCoreResolver } from './vitestResolver'

export async function VitestPlugin(
  options: UserConfig = {},
  vitest: Vitest = new Vitest('test', deepClone(options)),
): Promise<VitePlugin[]> {
  const userConfig = deepMerge({}, options) as UserConfig

  async function UIPlugin() {
    await vitest.packageInstaller.ensureInstalled('@vitest/ui', resolve(options.root || process.cwd()), vitest.version)
    return (await import('@vitest/ui')).default(vitest)
  }

  return [
    <VitePlugin>{
      name: 'vitest',
      enforce: 'pre',
      options() {
        this.meta.watchMode = false
      },
      async config(viteConfig) {
        if (options.watch) {
          // Earlier runs have overwritten values of the `options`.
          // Reset it back to initial user config before setting up the server again.
          options = deepMerge({}, userConfig) as UserConfig
        }

        // preliminary merge of options to be able to create server options for vite
        // however to allow vitest plugins to modify vitest config values
        // this is repeated in configResolved where the config is final
        const testConfig = deepMerge(
          {} as UserConfig,
          configDefaults,
          viteConfig.test ?? {},
          options,
        )
        testConfig.api = resolveApiServerConfig(testConfig, defaultPort)

        // store defines for globalThis to make them
        // reassignable when running in worker in src/runtime/setup.ts
        const originalDefine = { ...viteConfig.define } // stash original defines for browser mode
        const defines: Record<string, any> = deleteDefineConfig(viteConfig)

        ;(options as unknown as ResolvedConfig).defines = defines
        ;(options as unknown as ResolvedConfig).viteDefine = originalDefine

        let open: string | boolean | undefined = false

        if (testConfig.ui && testConfig.open) {
          open = testConfig.uiBase ?? '/__vitest__/'
        }

        const resolveOptions = getDefaultResolveOptions()

        let config: ViteConfig = {
          base: '/',
          root: viteConfig.test?.root || options.root,
          define: {
            // disable replacing `process.env.NODE_ENV` with static string by vite:client-inject
            'process.env.NODE_ENV': 'process.env.NODE_ENV',