Getting Started

Overview

Vitest (pronounced as "veetest") เป็น testing framework รุ่นใหม่ที่ขับเคลื่อนด้วย Vite

สามารถเรียนรู้เพิ่มเติมเกี่ยวกับเหตุผลเบื้องหลังโครงการนี้ได้ในส่วน Why Vitest

ทดลองใช้ Vitest ออนไลน์

สามารถทดลองใช้ Vitest ออนไลน์บน StackBlitz มันทำงาน Vitest โดยตรงในเบราว์เซอร์ และมันเกือบจะเหมือนกับการตั้งค่าในเครื่อง แต่ไม่จำเป็นต้องติดตั้งอะไรในเครื่อง

การเพิ่ม Vitest ในโครงการ

TIP

เรียนรู้วิธีการติดตั้งผ่าน วิดีโอ

npm

npm install -D vitest

yarn

yarn add -D vitest

pnpm

pnpm add -D vitest

bun

bun add -D vitest

TIP

Vitest ต้องการ Vite >=v5.0.0 และ Node >=v18.0.0

แนะนำให้ติดตั้ง vitest ในไฟล์ package.json โดยใช้วิธีการใดวิธีหนึ่งที่ระบุไว้ข้างต้น อย่างไรก็ตาม หากต้องการรัน vitest โดยตรง สามารถใช้ npx vitest ได้ (เครื่องมือ npx มาพร้อมกับ npm และ Node.js)

เครื่องมือ npx จะดำเนินการคำสั่งที่ระบุ โดยค่าเริ่มต้น npx จะตรวจสอบก่อนว่าคำสั่งมีอยู่ใน binaries ของโครงการท้องถิ่นหรือไม่ หากไม่พบที่นั่น npx จะมองหาในระบบ $PATH และดำเนินการหากพบ หากไม่พบคำสั่งในทั้งสองตำแหน่ง npx จะติดตั้งในตำแหน่งชั่วคราวก่อนการดำเนินการ

การเขียนการทดสอบ

ยกตัวอย่างเช่น เราจะเขียนการทดสอบอย่างง่ายที่ตรวจสอบผลลัพธ์ของฟังก์ชันที่บวกเลขสองจำนวน

sum.js

export function sum(a, b) {
  return a + b;
}

sum.test.js

import { expect, test } from "vitest";
import { sum } from "./sum.js";

test("adds 1 + 2 to equal 3", () => {
  expect(sum(1, 2)).toBe(3);
});

TIP

โดยค่าเริ่มต้น การทดสอบจะต้องมี .test. หรือ .spec. ในชื่อไฟล์

ต่อไป เพื่อดำเนินการทดสอบ ให้เพิ่มส่วนต่อไปนี้ในไฟล์ package.json:

package.json

{
	"scripts": {
		"test": "vitest"
	}
}

สุดท้าย รัน npm run test, yarn test หรือ pnpm test ขึ้นอยู่กับตัวจัดการแพ็คเกจ และ Vitest จะแสดงข้อความนี้:

✓ sum.test.js (1)
  ✓ adds 1 + 2 to equal 3

Test Files  1 passed (1)
     Tests  1 passed (1)
  Start at  02:15:44
  Duration  311ms