Node.js Test Runner க்கு அறிமுகம்
உள்ளமைக்கப்பட்ட node:test தொகுதி Node.js இல் நேரடியாக JavaScript சோதனைகளை எழுதவும் இயக்கவும் ஒரு இலகுவான, சார்பு-இல்லாத கட்டமைப்பை வழங்குகிறது.
Node.js 20 இல் ஒரு நிலையான API ஆக அறிமுகப்படுத்தப்பட்டது, இது வெளிப்புற சோதனை கட்டமைப்புகளுக்கு ஒரு வேகமான, நவீன மாற்றாக வடிவமைக்கப்பட்டுள்ளது.
குறிப்பு:
Node.js Test Runner என்பது Node.js v20 இலிருந்து நிலையானதாகும். சில மேம்பட்ட அம்சங்கள் முந்தைய பதிப்புகளில் சோதனைக்குரியதாக இருக்கலாம்.
முக்கிய அம்சங்கள்
முக்கிய திறன்கள்
பூஜ்ஜிய கட்டமைப்பு
அமைப்பு இல்லாமல் பெட்டியிலிருந்து வேலை செய்கிறது
இரட்டை தொகுதி ஆதரவு
சொந்த ESM மற்றும் CommonJS இணக்கத்தன்மை
இணை செயலாக்கம்
இயல்பாக ஒரே நேரத்தில் சோதனைகள் இயங்கும்
சோதனை தனிமைப்படுத்தல்
ஒவ்வொரு சோதனையும் அதன் சொந்த சூழலில் இயங்கும்
மேம்பட்ட அம்சங்கள்
தொடங்குவது எப்படி
உங்கள் முதல் சோதனையை எழுதுதல்
Node.js Test Runner ஐப் பயன்படுத்தி ஒரு அடிப்படை சோதனையை உருவாக்கி இயக்குவோம்.
உங்களுக்கு Node.js 16.17.0 அல்லது அதற்கு மேல் நிறுவப்பட்டிருக்க வேண்டும்.
1. ஒரு சோதனை கோப்பை உருவாக்கவும் (test/example.test.js)
// Load the test module
const test = require('node:test');
// Use strict assertion mode for better error messages
const assert = require('node:assert/strict');
// Simple synchronous test
test('basic arithmetic', (t) => {
// Assert that 1 + 1 equals 2
assert.equal(1 + 1, 2, '1 + 1 should equal 2');
// Deep equality check for objects/arrays
assert.deepEqual(
{ a: 1, b: { c: 2 } },
{ a: 1, b: { c: 2 } }
);
});
// Asynchronous test with async/await
test('async test', async (t) => {
const result = await Promise.resolve('async result');
assert.strictEqual(result, 'async result');
});
2. சோதனையை இயக்கவும்
# Run all test files in the test directory
node --test
# Run a specific test file
node --test test/example.test.js
# Run with coverage reporting
NODE_V8_COVERAGE=coverage node --test
சோதனை கட்டமைப்பு மற்றும் அமைப்பு
பெரிய திட்டங்களுக்கு, உங்கள் சோதனைகளை ஒரு கட்டமைக்கப்பட்ட வழியில் அமைக்கவும்:
project/
├── src/
│ ├── math.js
│ └── utils.js
└── test/
├── unit/
│ ├── math.test.js
│ └── utils.test.js
└── integration/
└── api.test.js
சோதனை கொக்கிகள்
சோதனை சூழல்களை அமைக்கவும் சுத்தம் செய்யவும் கொக்கிகளைப் பயன்படுத்தவும்:
const { test, describe, before, after, beforeEach, afterEach } = require('node:test');
const assert = require('node:assert/strict');
describe('Test Suite with Hooks', (t) => {
let testData = [];
// Runs once before all tests
before(() => {
console.log('Running before all tests');
testData = [1, 2, 3];
});
// Runs before each test
beforeEach((t) => {
console.log('Running before each test');
});
test('array length', () => {
assert.strictEqual(testData.length, 3);
});
// Runs after each test
afterEach(() => {
console.log('Running after each test');
});
// Runs once after all tests
after(() => {
console.log('Running after all tests');
testData = [];
});
});
சோதனைகளை எழுதுதல்
அசிங்க்ரோனஸ் சோதனைகள்
அசிங்க்ரோனஸ் குறியீட்டிற்கு, ஒரு async சோதனை செயல்பாட்டைப் பயன்படுத்தவும்:
import test from 'node:test';
import assert from 'node:assert/strict';
// Using async/await
test('async test', async () => {
// Simulate async operation
const result = await Promise.resolve(42);
assert.equal(result, 42);
});
// Using callbacks with done (older style)
test('callback test', (t, done) => {
setTimeout(() => {
assert.equal(1 + 1, 2);
done();
}, 100);
});
துணை சோதனைகள் (Nested Tests)
தொடர்புடைய சோதனைகளை ஒழுங்கமைக்க துணை சோதனைகளைப் பயன்படுத்தலாம்:
import test from 'node:test';
import assert from 'node:assert/strict';
test('math operations', async (t) => {
await t.test('addition', () => {
assert.equal(1 + 1, 2);
});
await t.test('multiplication', () => {
assert.equal(2 * 3, 6);
});
await t.test('division', () => {
assert.equal(10 / 2, 5);
});
});
தவிர்க்கும் மற்றும் TODO சோதனைகள்
சோதனைகளை தவிர்க்க அல்லது TODO ஆக குறிக்கலாம்:
import test from 'node:test';
// Skip this test
test('skipped test', { skip: true }, () => {
// This won't run
});
// Skip with a reason
test('skipped with reason', { skip: 'working on this later' }, () => {
// This won't run
});
// Mark as TODO
test('todo test', { todo: true }, () => {
// This won't run, but will be reported as TODO
});
// Conditional skip
test('conditional skip', { skip: process.platform === 'win32' }, () => {
// This will be skipped on Windows
});
உறுதிப்படுத்தல்கள்
Node.js Test Runner உள்ளமைக்கப்பட்ட assert தொகுதியுடன் வேலை செய்கிறது. கடுமையான சமத்துவ சரிபார்ப்புகளுக்கு, assert/strict ஐப் பயன்படுத்தவும்.
பொதுவான உறுதிப்படுத்தல்கள்
import assert from 'node:assert/strict';
// Equality checks
assert.equal(1, 1); // Loose equality (==)
assert.strictEqual(1, 1); // Strict equality (===)
assert.deepEqual({a: 1}, {a: 1}); // Deep equality for objects
assert.deepStrictEqual({a: 1}, {a: 1}); // Strict deep equality
// Truthiness checks
assert.ok(true); // Checks if value is truthy
assert.ok(1); // Also truthy
// Comparing values
assert.notEqual(1, 2); // Check inequality
assert.notStrictEqual(1, '1'); // Check strict inequality
// Throwing errors
assert.throws(() => { throw new Error('Boom!'); }); // Check if function throws
assert.doesNotThrow(() => { return 42; }); // Check if no error thrown
// Async assertions
await assert.rejects( // Check if Promise rejects
async () => { throw new Error('Async boom!'); }
);
மோக்குகளுடன் பணிபுரிதல்
Node.js Test Runner உள்ளமைக்கப்பட்ட மோக்கிங்கை உள்ளடக்கவில்லை, ஆனால் நீங்கள்:
எளிய மோக் எடுத்துக்காட்டு
import test from 'node:test';
import assert from 'node:assert/strict';
// Function we want to test
function processUser(user, logger) {
if (!user.name) {
logger.error('User has no name');
return false;
}
logger.info(`Processing user: ${user.name}`);
return true;
}
// Test with a mock logger
test('processUser logs correctly', () => {
// Create a mock logger
const mockCalls = [];
const mockLogger = {
error: (msg) => mockCalls.push(['error', msg]),
info: (msg) => mockCalls.push(['info', msg])
};
// Test with valid user
const validResult = processUser({name: 'Alice'}, mockLogger);
assert.strictEqual(validResult, true);
assert.deepStrictEqual(mockCalls[0], ['info', 'Processing user: Alice']);
// Reset mock calls
mockCalls.length = 0;
// Test with invalid user
const invalidResult = processUser({}, mockLogger);
assert.strictEqual(invalidResult, false);
assert.deepStrictEqual(mockCalls[0], ['error', 'User has no name']);
});
உண்மையான எடுத்துக்காட்டுகளை சோதித்தல்
ஒரு பயன்பாட்டு செயல்பாட்டை சோதித்தல்
utils.js
exports.formatPrice = function(price) {
if (typeof price !== 'number' || isNaN(price)) {
throw new Error('Price must be a valid number');
}
return `$${price.toFixed(2)}`;
};
utils.test.js
const test = require('node:test');
const assert = require('node:assert/strict');
const { formatPrice } = require('./utils');
// Test cases
test('formatPrice formats numbers as currency strings', (t) => {
assert.equal(formatPrice(10), '$10.00');
assert.equal(formatPrice(10.5), '$10.50');
assert.equal(formatPrice(0), '$0.00');
});
// Test for error
test('formatPrice throws error for invalid inputs', (t) => {
assert.throws(() => formatPrice('not a number'), {
message: 'Price must be a valid number'
});
assert.throws(() => formatPrice(NaN));
assert.throws(() => formatPrice());
});
மேம்பட்ட கட்டமைப்பு
தனிப்பட்ட அறிக்கையாளர்கள்
சோதனை முடிவுகளுக்கு வெவ்வேறு வெளியீட்டு வடிவங்களைக் குறிப்பிடலாம்:
node --test --test-reporter=spec
கிடைக்கக்கூடிய அறிக்கையாளர்கள்:
சோதனைகளை வடிகட்டுதல்
இயக்க வேண்டிய சோதனைகளை வடிகட்டலாம்:
node --test --test-name-pattern="user"
இது அவற்றின் பெயரில் "user" உள்ள சோதனைகளை மட்டும் இயக்கும்.
பார்க்கும் முறை
மேம்பாட்டிற்காக, கோப்புகள் மாறும்போது தானாகவே மீண்டும் இயக்குவதற்கு பார்க்கும் முறையில் சோதனைகளை இயக்கலாம்:
node --test --watch
மற்ற சோதனை கட்டமைப்புகளுடன் ஒப்பீடு
| அம்சம் | Node.js Test Runner | Jest | Mocha | Vitest |
|---|---|---|---|---|
| உள்ளமைக்கப்பட்ட | ✅ ஆம் (Node.js 16.17.0+) | ❌ இல்லை | ❌ இல்லை | ❌ இல்லை |
| பூஜ்ஜிய கட்டமைப்பு | ✅ ஆம் | ✅ ஆம் | ❌ அமைப்பு தேவை | ✅ ஆம் |
| சோதனை இயக்கி | Node.js உள்ளமைக்கப்பட்ட | Jest | Mocha | Vite |
| உறுதிப்படுத்தல் நூலகம் | node:assert | Jest Expect | Chai/Sinon | Jest-இணக்கமான |
| இணை சோதனைகள் | ✅ ஆம் | ✅ ஆம் | ✅ --parallel உடன் | ✅ ஆம் |
| குறியீட்டு கவரேஜ் | ✅ NODE_V8_COVERAGE உடன் | ✅ உள்ளமைக்கப்பட்ட | ❌ nyc/istanbul தேவை | ✅ உள்ளமைக்கப்பட்ட |
| மோக்கிங் | ✅ அடிப்படை | ✅ மேம்பட்ட | ❌ Sinon தேவை | ✅ மேம்பட்ட |
| பார்க்கும் முறை | ✅ ஆம் (--watch) | ✅ ஆம் | ✅ --watch உடன் | ✅ வேகமான HMR |
| சிறந்தது | உள்ளமைக்கப்பட்ட தீர்வு, எளிய திட்டங்கள் | முழு அம்ச சோதனை | நெகிழ்வான சோதனை | Vite திட்டங்கள், ESM |
குறிப்பு:
Node.js Test Runner என்பது இலகுவான, சார்பு-இல்லாத சோதனை தீர்வை விரும்பும் திட்டங்களுக்கு ஏற்றது, இது Node.js இல் உள்ளமைக்கப்பட்டுள்ளது. மிகவும் சிக்கலான சோதனை தேவைகளுக்கு, Jest அல்லது Mocha சிறந்த தேர்வுகளாக இருக்கலாம்.