nuxt · danielroe · Apr 28, 2025 · Apr 28, 2025 · Apr 28, 2025
@@ -59,6 +59,11 @@ jobs:
         with:
           node-version: lts/*
           cache: "pnpm"
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@735343b667d3e6f658f44d0eca948eb6282f2b76 # v2.0.2
+        with:
+          bun-version: latest
 
       - name: Install dependencies
         run: pnpm install

@@ -16,6 +16,7 @@ export default defineBuildConfig({
   ],
   externals: [
     '#dirs',
+    'bun:test',
     '#app/entry',
     '#build/root-component.mjs',
     '#imports',

@@ -0,0 +1,5 @@
+<template>
+  <div>
+    <NuxtWelcome />
+  </div>
+</template>
@@ -0,0 +1,7 @@
+import { defineNuxtConfig } from 'nuxt/config'
+
+// https://nuxt.com/docs/api/configuration/nuxt-config
+export default defineNuxtConfig({
+  devtools: { enabled: true },
+  compatibilityDate: '2024-04-03',
+})
@@ -0,0 +1,22 @@
+{
+  "name": "example-app-jest",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "build": "nuxt build",
+    "dev": "nuxt dev",
+    "generate": "nuxt generate",
+    "preview": "nuxt preview",
+    "postinstall": "nuxt prepare",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "nuxt": "^3.17.0"
+  },
+  "devDependencies": {
+    "@nuxt/test-utils": "latest",
+    "@types/bun": "1.2.10",
+    "playwright-core": "1.52.0",
+    "typescript": "5.8.3"
+  }
+}
@@ -0,0 +1,18 @@
+import { fileURLToPath } from 'node:url'
+import { describe, it, expect } from 'bun:test'
+import { createPage, setup } from '@nuxt/test-utils/e2e'
+import { isWindows } from 'std-env'
+
+await setup({
+  rootDir: fileURLToPath(new URL('../', import.meta.url)),
+  browser: true,
+})
+
+describe('browser', () => {
+  it('runs a test', async () => {
+    const page = await createPage('/')
+    const text = await page.getByRole('heading', { name: 'Welcome to Nuxt!' }).textContent()
+    expect(text).toContain('Welcome to Nuxt!')
+    await page.close()
+  }, isWindows ? 120000 : 20000)
+})
@@ -0,0 +1,15 @@
+import { fileURLToPath } from 'node:url'
+import { describe, it, expect } from 'bun:test'
+import { $fetch, setup } from '@nuxt/test-utils/e2e'
+
+await setup({
+  rootDir: fileURLToPath(new URL('../', import.meta.url)),
+  dev: true,
+})
+
+describe('server (dev)', () => {
+  it('runs a test', async () => {
+    const html = await $fetch('/')
+    expect(html.slice(0, 15)).toMatchInlineSnapshot(`"<!DOCTYPE html>"`)
+  })
+})
@@ -0,0 +1,14 @@
+import { fileURLToPath } from 'node:url'
+import { describe, it, expect } from 'bun:test'
+import { $fetch, setup } from '@nuxt/test-utils/e2e'
+
+await setup({
+  rootDir: fileURLToPath(new URL('../', import.meta.url)),
+})
+
+describe('app', () => {
+  it('runs a test', async () => {
+    const html = await $fetch('/')
+    expect(html.slice(0, 15)).toMatchInlineSnapshot(`"<!DOCTYPE html>"`)
+  })
+})
@@ -0,0 +1,14 @@
+{
+  "extends": "./.nuxt/tsconfig.json",
+  "compilerOptions": {
+    "module": "ESNext",
+    "esModuleInterop": true,
+    "moduleResolution": "Bundler",
+    "verbatimModuleSyntax": false,
+    "target": "ESNext",
+    "types": [
+      "bun"
+    ],
+    "resolveJsonModule": true
+  }
+}
@@ -97,6 +97,7 @@
     "@nuxt/eslint-config": "1.3.0",
     "@playwright/test": "1.52.0",
     "@testing-library/vue": "8.1.0",
+    "@types/bun": "1.2.10",
     "@types/estree": "1.0.7",
     "@types/jsdom": "21.1.7",
     "@types/node": "22.15.3",

@@ -2,7 +2,7 @@ import { resolve } from 'node:path'
 import { defu } from 'defu'
 import { withTrailingSlash } from 'ufo'
 import type { DateString } from 'compatx'
-import { isWindows } from 'std-env'
+import { isBun, isWindows } from 'std-env'
 import type { TestContext, TestOptions } from './types'
 
 let currentContext: TestContext | undefined
@@ -44,6 +44,9 @@ export function createTestContext(options: Partial<TestOptions>): TestContext {
   else if (process.env.JEST_WORKER_ID) {
     _options.runner ||= 'jest'
   }
+  else if (isBun) {
+    _options.runner ||= 'bun'
+  }
 
   return setTestContext({
     options: _options as TestOptions,

@@ -0,0 +1,14 @@
+import type { TestHooks } from '../types'
+
+export default async function setupBun(hooks: TestHooks) {
+  // @ts-expect-error we do not want bun types present in global context
+  const bunTest = await import('bun:test')
+
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  hooks.ctx.mockFn = bunTest.mock as any
+
+  bunTest.beforeAll(hooks.beforeAll)
+  bunTest.beforeEach(hooks.beforeEach)
+  bunTest.afterEach(hooks.afterEach)
+  bunTest.afterAll(hooks.afterAll)
+}
@@ -3,11 +3,13 @@ import { buildFixture, loadFixture } from '../nuxt'
 import { startServer, stopServer } from '../server'
 import { createBrowser } from '../browser'
 import type { TestHooks, TestOptions } from '../types'
+import setupBun from './bun'
 import setupCucumber from './cucumber'
 import setupJest from './jest'
 import setupVitest from './vitest'
 
 export const setupMaps = {
+  bun: setupBun,
   cucumber: setupCucumber,
   jest: setupJest,
   vitest: setupVitest,

@@ -3,7 +3,7 @@ import type { Browser, LaunchOptions } from 'playwright-core'
 import type { exec } from 'tinyexec'
 import type { StartServerOptions } from './server'
 
-export type TestRunner = 'vitest' | 'jest' | 'cucumber'
+export type TestRunner = 'vitest' | 'jest' | 'cucumber' | 'bun'
 
 export interface TestOptions {
   testDir: string
@@ -43,7 +43,7 @@ export interface TestOptions {
    */
   browser: boolean
   /**
-   * Specify the runner for the test suite. One of `'vitest' | 'jest' | 'cucumber'`.
+   * Specify the runner for the test suite. One of `'vitest' | 'jest' | 'cucumber' | 'bun'`.
    * @default `vitest`
    */
   runner: TestRunner

@@ -1,7 +1,7 @@
 {
   "extends": "./.nuxt/tsconfig.json",
   "compilerOptions": {
-    "moduleResolution": "Bundler",
+    "moduleResolution": "Bundler"
   },
   "exclude": [
     "config.d.ts",