Ujian unit adalah penting kerana ia menyemak bahagian kecil kod untuk memastikan ia berfungsi dengan betul dan menemui pepijat lebih awal. Adalah penting untuk melakukan ujian ini sebelum mengeluarkan apl. Panduan ini akan merangkumi ujian unit dengan Mocha dan Chai.
Mocha ialah rangka kerja ujian JavaScript yang kaya dengan ciri yang berjalan pada Node.js, menjadikan ujian tak segerak mudah dan menyeronokkan. Ia menyediakan fungsi yang dilaksanakan dalam susunan tertentu, mengumpul keputusan ujian dan menawarkan pelaporan yang tepat.
Chai ialah perpustakaan penegasan BDD/TDD yang boleh digunakan dengan mana-mana rangka kerja ujian JavaScript. Ia menawarkan beberapa antara muka, membolehkan pembangun memilih gaya penegasan yang mereka rasa paling selesa.
Ketegasan yang boleh dibaca dan ekspresif
Chai menyediakan gaya penegasan dan pilihan sintaks berbeza yang berfungsi dengan baik dengan Mocha, membolehkan anda memilih gaya yang sesuai dengan keperluan anda untuk kejelasan dan kebolehbacaan.
Sokongan untuk ujian tak segerak
Mocha mengendalikan ujian tak segerak dengan mudah, membolehkan anda menguji kod tak segerak dalam aplikasi Node.js tanpa memerlukan perpustakaan tambahan atau persediaan yang kompleks.
Pertama, mari kita sediakan projek Node.js baharu dan pasang kebergantungan yang diperlukan:
mkdir auth-api-testing cd auth-api-testing npm init -y # Install production dependencies npm install express jsonwebtoken mongoose bcryptjs dotenv # Install development dependencies npm install --save-dev mocha chai chai-http supertest nyc
Tambahkan skrip berikut pada package.json anda:
{ "scripts": { "test": "NODE_ENV=test mocha --timeout 10000 --exit", "test:coverage": "nyc npm test" } }
Sebelum terjun ke dalam ujian, mari kita fahami aplikasi yang akan kita uji. Kami sedang membina API pengesahan yang mudah tetapi selamat dengan ciri berikut.
src/ ├── models/ │ └── user.model.js # User schema and model ├── routes/ │ ├── auth.routes.js # Authentication routes │ └── user.routes.js # User management routes ├── middleware/ │ ├── auth.middleware.js # JWT verification middleware │ └── validate.js # Request validation middleware ├── controllers/ │ ├── auth.controller.js # Authentication logic │ └── user.controller.js # User management logic └── app.js # Express application setup
POST /api/auth/register - Registers new user - Accepts: { email, password, name } - Returns: { token, user } POST /api/auth/login - Authenticates existing user - Accepts: { email, password } - Returns: { token, user }
GET /api/users/profile - Gets current user profile - Requires: JWT Authentication - Returns: User object PUT /api/users/profile - Updates user profile - Requires: JWT Authentication - Accepts: { name, email } - Returns: Updated user object
Buat fail .env.test untuk konfigurasi khusus ujian:
PORT=3001 MONGODB_URI=mongodb://localhost:27017/auth-api-test JWT_SECRET=your-test-secret-key
Mari buat ujian fail pertama kami test/auth.test.js
const chai = require('chai'); const chaiHttp = require('chai-http'); const app = require('../src/app'); const User = require('../src/models/user.model'); chai.use(chaiHttp); const expect = chai.expect; describe('Auth API Tests', () => { // Runs before all tests before(async () => { await User.deleteMany({}); }); // Runs after each test afterEach(async () => { await User.deleteMany({}); }); // Test suites will go here });
Mocha menyediakan beberapa cangkuk untuk persediaan ujian dan pembersihan:
before(): Berjalan sekali sebelum semua ujian
after(): Berjalan sekali selepas semua ujian
beforeEach(): Berjalan sebelum setiap ujian
afterEach(): Berjalan selepas setiap ujian
Ujian diatur menggunakan blok describe() untuk mengumpulkan ujian yang berkaitan dan blok it() untuk kes ujian individu:
mkdir auth-api-testing cd auth-api-testing npm init -y # Install production dependencies npm install express jsonwebtoken mongoose bcryptjs dotenv # Install development dependencies npm install --save-dev mocha chai chai-http supertest nyc
{ "scripts": { "test": "NODE_ENV=test mocha --timeout 10000 --exit", "test:coverage": "nyc npm test" } }
src/ ├── models/ │ └── user.model.js # User schema and model ├── routes/ │ ├── auth.routes.js # Authentication routes │ └── user.routes.js # User management routes ├── middleware/ │ ├── auth.middleware.js # JWT verification middleware │ └── validate.js # Request validation middleware ├── controllers/ │ ├── auth.controller.js # Authentication logic │ └── user.controller.js # User management logic └── app.js # Express application setup
POST /api/auth/register - Registers new user - Accepts: { email, password, name } - Returns: { token, user } POST /api/auth/login - Authenticates existing user - Accepts: { email, password } - Returns: { token, user }
GET /api/users/profile - Gets current user profile - Requires: JWT Authentication - Returns: User object PUT /api/users/profile - Updates user profile - Requires: JWT Authentication - Accepts: { name, email } - Returns: Updated user object
Setiap ujian harus berdiri sendiri dan tidak bergantung pada ujian lain
Ujian seharusnya boleh dijalankan dalam sebarang urutan
Gunakan cangkuk sebelum, selepas, sebelumSetiap dan selepasSetiap untuk persediaan dan pembersihan yang betul
PORT=3001 MONGODB_URI=mongodb://localhost:27017/auth-api-test JWT_SECRET=your-test-secret-key
const chai = require('chai'); const chaiHttp = require('chai-http'); const app = require('../src/app'); const User = require('../src/models/user.model'); chai.use(chaiHttp); const expect = chai.expect; describe('Auth API Tests', () => { // Runs before all tests before(async () => { await User.deleteMany({}); }); // Runs after each test afterEach(async () => { await User.deleteMany({}); }); // Test suites will go here });
Uji keadaan sempadan, senario ralat, input tidak sah dan nilai kosong atau batal.
describe('Auth API Tests', () => { describe('POST /api/auth/register', () => { it('should register a new user successfully', async () => { // Test implementation }); it('should return error when email already exists', async () => { // Test implementation }); }); });
Nama ujian hendaklah menerangkan dengan jelas senario yang diuji, mengikut konvensyen penamaan yang konsisten dan menyertakan gelagat yang dijangkakan.
describe('POST /api/auth/register', () => { it('should register a new user successfully', async () => { const res = await chai .request(app) .post('/api/auth/register') .send({ email: 'test@example.com', password: 'Password123!', name: 'Test User' }); expect(res).to.have.status(201); expect(res.body).to.have.property('token'); expect(res.body).to.have.property('user'); expect(res.body.user).to.have.property('email', 'test@example.com'); }); it('should return 400 when email already exists', async () => { // First create a user await chai .request(app) .post('/api/auth/register') .send({ email: 'test@example.com', password: 'Password123!', name: 'Test User' }); // Try to create another user with same email const res = await chai .request(app) .post('/api/auth/register') .send({ email: 'test@example.com', password: 'Password123!', name: 'Test User 2' }); expect(res).to.have.status(400); expect(res.body).to.have.property('error'); }); });
describe('Protected Routes', () => { let token; let userId; beforeEach(async () => { // Create a test user and get token const res = await chai .request(app) .post('/api/auth/register') .send({ email: 'test@example.com', password: 'Password123!', name: 'Test User' }); token = res.body.token; userId = res.body.user._id; }); it('should get user profile with valid token', async () => { const res = await chai .request(app) .get('/api/users/profile') .set('Authorization', `Bearer ${token}`); expect(res).to.have.status(200); expect(res.body).to.have.property('email', 'test@example.com'); }); it('should return 401 with invalid token', async () => { const res = await chai .request(app) .get('/api/users/profile') .set('Authorization', 'Bearer invalid-token'); expect(res).to.have.status(401); }); });
const mongoose = require('mongoose'); before(async () => { await mongoose.connect(process.env.MONGODB_URI_TEST); }); after(async () => { await mongoose.connection.dropDatabase(); await mongoose.connection.close(); });
describe('User CRUD Operations', () => { it('should update user profile', async () => { const res = await chai .request(app) .put(`/api/users/${userId}`) .set('Authorization', `Bearer ${token}`) .send({ name: 'Updated Name' }); expect(res).to.have.status(200); expect(res.body).to.have.property('name', 'Updated Name'); }); it('should delete user account', async () => { const res = await chai .request(app) .delete(`/api/users/${userId}`) .set('Authorization', `Bearer ${token}`); expect(res).to.have.status(200); // Verify user is deleted const user = await User.findById(userId); expect(user).to.be.null; }); });
Menulis kes ujian manual untuk mocha dengan chai, walaupun berkesan, selalunya mempunyai beberapa cabaran:
Memakan masa: Membuat set ujian terperinci dengan tangan boleh mengambil banyak masa, terutamanya untuk pangkalan kod yang besar.
Sukar untuk diselenggara: Apabila aplikasi anda berubah, mengemas kini dan menyelenggara ujian manual menjadi lebih kompleks dan terdedah kepada ralat.
Liputan tidak konsisten: Pembangun mungkin menumpukan pada laluan utama, kes kelebihan yang hilang atau senario ralat yang boleh menyebabkan pepijat dalam pengeluaran.
Bergantung kepada kemahiran: Kualiti dan keberkesanan ujian manual sangat bergantung pada kemahiran ujian dan kebiasaan pembangun dengan pangkalan kod.
Berulang-ulang dan membosankan: Menulis struktur ujian yang serupa untuk berbilang komponen atau fungsi boleh membosankan, mungkin menyebabkan kurang perhatian terhadap perincian.
Maklum balas tertunda: Masa yang diperlukan untuk menulis ujian manual boleh melambatkan pembangunan, menangguhkan maklum balas penting tentang kualiti dan fungsi kod.
Untuk menangani isu ini, Keploy telah memperkenalkan ut-gen yang menggunakan AI untuk mengautomasikan dan menambah baik proses ujian, yang merupakan pelaksanaan pertama kertas penyelidikan Meta LLM yang memahami semantik kod dan mencipta ujian unit yang bermakna.
Ia bertujuan untuk mengautomasikan penjanaan ujian unit (UTG) dengan cepat menghasilkan ujian unit yang menyeluruh. Ini mengurangkan keperluan untuk kerja manual yang berulang, menambah baik kes tepi dengan mengembangkan ujian untuk merangkumi senario yang lebih kompleks yang sering terlepas secara manual dan meningkatkan liputan ujian untuk memastikan liputan lengkap apabila pangkalan kod berkembang.
%[https://marketplace.visualstudio.com/items?itemName=Keploy.keployio]
Automasikan penjanaan ujian unit (UTG): Cepat hasilkan ujian unit komprehensif dan kurangkan usaha manual yang berlebihan.
Tingkatkan kes tepi: Lanjutkan dan tingkatkan skop ujian untuk merangkumi senario yang lebih kompleks yang sering terlepas secara manual.
Tingkatkan liputan ujian: Apabila pangkalan kod berkembang, memastikan liputan menyeluruh dapat dilaksanakan.
Kesimpulannya, menguasai ujian backend Node.js dengan Mocha dan Chai adalah penting untuk pembangun yang mahukan aplikasi mereka boleh dipercayai dan kukuh. Dengan menggunakan rangka kerja ujian Mocha dan pustaka penegasan Chai yang jelas, pembangun boleh mencipta suite ujian terperinci yang merangkumi banyak bahagian kod mereka, daripada ujian unit mudah kepada operasi async yang kompleks. Mengikuti amalan terbaik seperti mengekalkan fokus ujian, menggunakan nama yang jelas dan mengendalikan janji dengan betul boleh meningkatkan proses ujian anda. Dengan menggunakan alatan dan teknik ini dalam aliran kerja pembangunan anda, anda boleh menemui pepijat lebih awal, meningkatkan kualiti kod dan menyampaikan aplikasi yang lebih selamat dan cekap.
Walaupun kedua-duanya adalah alat ujian, ia mempunyai tujuan yang berbeza. Mocha ialah rangka kerja ujian yang menyediakan struktur untuk mengatur dan menjalankan ujian (menggunakan blok describe() dan it(). Chai ialah perpustakaan penegasan yang menyediakan fungsi untuk mengesahkan hasil (seperti jangkakan(), harus dan tegaskan). Walaupun anda boleh menggunakan Mocha tanpa Chai, menggunakannya bersama-sama memberikan anda penyelesaian ujian yang lebih lengkap dan ekspresif.
Mocha menyediakan beberapa cangkuk kitaran hayat untuk mengurus data ujian:
sebelum(): Jalankan sekali sebelum semua ujian
beforeEach(): Berlari sebelum setiap ujian
afterEach(): Jalankan selepas setiap ujian
selepas(): Jalankan sekali selepas semua ujian
Contoh:
mkdir auth-api-testing cd auth-api-testing npm init -y # Install production dependencies npm install express jsonwebtoken mongoose bcryptjs dotenv # Install development dependencies npm install --save-dev mocha chai chai-http supertest nyc
Ujian berkaitan kumpulan menggunakan blok describe()
Gunakan nama ujian deskriptif yang menyatakan dengan jelas tingkah laku yang diharapkan
Ikuti corak AAA (Arrange-Act-Assert) dalam setiap ujian
Pastikan ujian atom dan bebas
Atur fail ujian untuk mencerminkan struktur kod sumber anda
Contoh:
{ "scripts": { "test": "NODE_ENV=test mocha --timeout 10000 --exit", "test:coverage": "nyc npm test" } }
'before' dijalankan sekali sebelum semua ujian, 'beforeEach' dijalankan sebelum setiap ujian individu, 'afterEach' dijalankan selepas setiap ujian individu dan 'after' dijalankan sekali selepas semua ujian selesai. Ini berguna untuk menyediakan dan membersihkan data ujian.
Anda boleh menggunakan async/menunggu atau mengembalikan janji dalam ujian anda. Cuma tambah 'async' sebelum fungsi ujian anda dan gunakan 'menunggu' apabila memanggil operasi async. Pastikan anda menetapkan tamat masa yang sesuai untuk operasi yang lebih lama.
Atas ialah kandungan terperinci Ujian unit untuk NodeJS menggunakan Mocha dan Chai. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!