comets/README.md

# comets

[![npm version][npm-src]][npm-href]
[![Bundle size][bundlephobia-src]][bundlephobia-href]

Create a one-off server for testing http request listener.

## Usage

```bash
npm install comets
```

```js
import assert from 'assert'
import fetch from 'node-fetch'
import { createServer } from 'comets'

async function test () {
  // The handler to test
  const requestHandler = (req, res) => res.end('yo')

  // Create a one-off server for testing
  const address = await createServer(requestHandler)

  // Send test request, the server will close after this request
  const result = await fetch(address).then(res => res.text())

  assert.equal(result, 'yo')
}
```

## API

### `createServer()`

```typescript
async function createServer (handler: http.RequestListener, count: number = 1)
```

- __`handler`__ the request listener to test
- __`count`__ the server will close after given requests count (default: `1`)

## License

[![License][license-src]][license-href]


[npm-src]: https://badgen.net/npm/v/comets
[npm-href]: https://www.npmjs.com/package/comets
[bundlephobia-src]: https://badgen.net/bundlephobia/minzip/comets
[bundlephobia-href]: https://bundlephobia.com/result?p=comets
[license-src]: https://badgen.net/badge/license/MIT
[license-href]: LICENSE.md