Vitest

Open in Playground Source

使用 Vitest 和 serverFetch 测试服务器路由。

api

hello.ts

visits.ts

test

api.test.ts

nitro.config.ts

package.json

tsconfig.json

vite.config.ts

import { beforeEach, expect, test } from "vitest";
import { serverFetch } from "nitro";
import { useKV } from "nitro/kv";

beforeEach(async () => {
  await useKV().removeItem("visits");
});

test("GET /api/hello", async () => {
  const res = await serverFetch("/api/hello");
  expect(res.status).toBe(200);
  expect(await res.json()).toEqual({ message: "Hello from Nitro!" });
});

test("GET /api/visits", async () => {
  await serverFetch("/api/visits");
  const res = await serverFetch("/api/visits");
  expect(await res.json()).toEqual({ visits: 2 });
  expect(await useKV().getItem("visits")).toBe(2);
});

使用 Vitest 测试服务器路由。Vitest 会从 vite.config.ts 中获取 nitro() 插件，因此测试文件可以使用与服务器相同的路由、运行时配置和存储，而无需启动开发服务器。

#路由

import { defineHandler } from "nitro";
import { useRuntimeConfig } from "nitro/runtime-config";

export default defineHandler(() => {
  const { greeting } = useRuntimeConfig();
  return { message: `${greeting} from Nitro!` };
});

#测试

test/api.test.ts

import { beforeEach, expect, test } from "vitest";
import { serverFetch } from "nitro";
import { useKV } from "nitro/kv";

beforeEach(async () => {
  await useKV().removeItem("visits");
});

test("GET /api/hello", async () => {
  const res = await serverFetch("/api/hello");
  expect(res.status).toBe(200);
  expect(await res.json()).toEqual({ message: "Hello from Nitro!" });
});

test("GET /api/visits", async () => {
  await serverFetch("/api/visits");
  const res = await serverFetch("/api/visits");
  expect(await res.json()).toEqual({ visits: 2 });
  expect(await useKV().getItem("visits")).toBe(2);
});

serverFetch 会在进程内通过 Nitro 应用发送请求。useKV 等运行时工具也可在测试中使用，因此你可以直接准备或检查状态。

运行 vitest 执行测试，或使用 vitest run 仅运行一次。

#了解更多

Edit this page

Previous Vite + tRPC Next WebSocket

On this page