80 lines
3.9 KiB
Markdown
80 lines
3.9 KiB
Markdown
# tapbundle
|
|
tap bundled for tapbuffer
|
|
|
|
## Availabililty
|
|
[](https://www.npmjs.com/package/tapbundle)
|
|
[](https://GitLab.com/pushrocks/tapbundle)
|
|
[](https://github.com/pushrocks/tapbundle)
|
|
[](https://pushrocks.gitlab.io/tapbundle/)
|
|
|
|
## Status for master
|
|
[](https://GitLab.com/pushrocks/tapbundle/commits/master)
|
|
[](https://GitLab.com/pushrocks/tapbundle/commits/master)
|
|
[](https://www.npmjs.com/package/tapbundle)
|
|
[](https://david-dm.org/pushrocks/tapbundle)
|
|
[](https://www.bithound.io/github/pushrocks/tapbundle/master/dependencies/npm)
|
|
[](https://www.bithound.io/github/pushrocks/tapbundle)
|
|
[](https://nodejs.org/dist/latest-v6.x/docs/api/)
|
|
[](https://nodejs.org/dist/latest-v6.x/docs/api/)
|
|
[](http://standardjs.com/)
|
|
|
|
## Usage
|
|
Use TypeScript for best in class instellisense.
|
|
|
|
This package includes
|
|
|
|
* tap compatible testing framework written in TypeScript
|
|
* npm package chai (through smartchai)
|
|
* npm package chai-as-promised (through smartchai)
|
|
* npm package chai-string (through smartchai)
|
|
* npm package @types/chai (through smartchai)
|
|
* npm package @types/chai-as-promised (through smartchai)
|
|
* npm package @types/chai-string (through smartchai)
|
|
|
|
It also implements its own tap testing engine, that is fully typed.
|
|
|
|
In other words: This package is fully typed :)
|
|
|
|
|
|
### Get started with writing your first test file.
|
|
```javascript
|
|
import {tap, expect} from 'tapbundle' // has typings in place
|
|
|
|
import * as myAwesomeModuleToTest from '../dist/index' // '../dist/index' is the standard path for npmts modules
|
|
|
|
tap.test('my awesome description', async (tools) => { // tools are optional parameter
|
|
tools.timeout(2000) // test will fail if it takes longer than 2000 millisenconds
|
|
})
|
|
|
|
let myTest2 = tap.test('my awesome test 2', async (tools) => {
|
|
myAwsomeModuleToTest.doSomethingAsync() // we don't wait here
|
|
await tools.delayFor(3000) // yay! :) promise based timeouts :)
|
|
console.log('This gets logged 3000 ms into the test')
|
|
})
|
|
|
|
tap.test('my awesome test 3', async (tools) => {
|
|
expect(true).to.be.true // will not throw
|
|
await expect(tools.delayFor(2000)).to.eventually.be.fulfilled // yay expect promises :)
|
|
expect((await myTest2.promise).hrtMeasurement.milliSeconds > 1000).to.be.true // access other tests metadata :)
|
|
})
|
|
|
|
let myTest4 = tap.testParallel('my awesome test 4', async (tools) => {
|
|
await tools.delayFor(4000)
|
|
console.log('logs to console after 4 seconds into this test')
|
|
})
|
|
|
|
tap.test('my awesome test 5', async () => {
|
|
expect(myTest4.status).to.equal('pending') // since this test will likely finish before myTest4.
|
|
})
|
|
|
|
tap.start() // start the test, will automtically plan tests for you (so the tap parser knows when tests exit bofore they are finished)
|
|
|
|
```
|
|
|
|
For further information read the linked docs at the top of this README.
|
|
|
|
> MIT licensed | **©** [Lossless GmbH](https://lossless.gmbh)
|
|
| By using this npm module you agree to our [privacy policy](https://lossless.gmbH/privacy.html)
|
|
|
|
[](https://push.rocks)
|