# utest

> The minimal unit testing library.

Latest version **0.0.8** (published 2013-04-29) · 0 weekly downloads

## Install

```sh
npm install utest
pnpm add utest
yarn add utest
bun add utest
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.0.8 |
| Published | 2013-04-29 |
| First published | 2011-11-13 |
| Weekly downloads | 0 |
| TypeScript types | none |
| Module format | CommonJS |
| Node | * |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Felix Geisendörfer |
| Maintainers | felixge, mantoni |

## Links

- npm: https://www.npmjs.com/package/utest
- Homepage: https://github.com/felixge/node-utest
- npm.io page: https://npm.io/package/utest

## Recent versions

- 0.0.8 (latest) — 2013-04-29
- 0.0.7 — 2013-04-28
- 0.0.6 — 2012-04-21
- 0.0.5 — 2012-01-13
- 0.0.4 — 2011-12-25
- 0.0.3 — 2011-11-17
- 0.0.2 — 2011-11-14
- 0.0.1 — 2011-11-13

## README

# utest

[![Build Status](https://secure.travis-ci.org/felixge/node-utest.png)](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.

---
_Source: https://npm.io/package/utest · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._