Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/felixge/node-utest
The minimal unit testing library.
https://github.com/felixge/node-utest
Last synced: about 2 months ago
JSON representation
The minimal unit testing library.
- Host: GitHub
- URL: https://github.com/felixge/node-utest
- Owner: felixge
- Created: 2011-11-10T08:59:45.000Z (about 13 years ago)
- Default Branch: master
- Last Pushed: 2013-04-29T20:28:12.000Z (over 11 years ago)
- Last Synced: 2024-10-11T15:18:48.962Z (2 months ago)
- Language: JavaScript
- Homepage:
- Size: 136 KB
- Stars: 42
- Watchers: 5
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: Readme.md
Awesome Lists containing this project
README
# utest
[](http://travis-ci.org/felixge/node-utest)
The minimal unit testing library.
## Why yet another test library?
I wanted something simple, that just does unit tests (no async) and where each
test is a standalone UNIX program. Now it exists.
## How do I run async tests?
Currently there is only one sane way: Do not use a framework. Instead use one
file per test.
If that becomes an issue, you should write more unit tests. (It is not a unit
test if it does I/O).
## Install
```
npm install utest
```
## Usage
Running a test with utest is very simple:
```js
var test = require('utest');
var assert = require('assert');
test('Number#toFixed', {
'returns a string': function() {
assert.equal(typeof (5).toFixed(), 'string');
},
'takes number of decimal places': function() {
assert.equal((5).toFixed(1), '5.0');
},
'does not round': function() {
assert.equal((5.55).toFixed(1), '5.5');
},
});
```
It is also possible to define a before/after method:
```js
var test = require('utest');
var assert = require('assert');
test('Date', {
before: function() {
this.date = new Date;
},
after: function() {
this.date = null;
},
'lets you manipulate the year': function() {
this.date.setYear(2012);
assert.equal(this.date.getFullYear(), 2012);
},
'can be coerced into a number': function() {
assert.equal(typeof +this.date, 'number');
},
});
```
Last but not least, you can run individual tests by prefixing them with an
exclamation mark. This is useful when putting debug statements into the subject
under test:
```js
var test = require('utest');
var assert = require('assert');
test('MyTest', {
'!will be executed': function() {
// ...
},
'will not be exectuted': function() {
// ...
},
});
```
## Future Features
I want to keep this library as minimal as possible, but I do consider the
addition of the following features:
* Nested test cases
* TAP output (if TAP=1 in the environment, switch to TapReporter class)
* Leak detection (automatically add a final test that fails if there are global
leaks).
## License
This module is licensed under the MIT license.