ts-http-assert

TypeScript version of http-assert with Assertion Functions.

Motivation

There are multiple attempts to give the http-assert assertion functions supports:

• https://github.com/DefinitelyTyped/DefinitelyTyped/pull/46014
• https://github.com/DefinitelyTyped/DefinitelyTyped/pull/46698
• https://github.com/DefinitelyTyped/DefinitelyTyped/pull/47557

All of these attemps are failed because @types/koa refers @types/http-assert as methods, and due to https://github.com/microsoft/TypeScript/issues/36931 methods cannot simply have assertion functions.

This package is a drop-in replacement of the http-assert package with:

• better typings, and
• assertion functions support.

Install

1npm install ts-http-assert

or

yarn add ts-http-assert

Usage

Just replace all

1import assert from 'http-assert'

with

1import assert from 'ts-http-assert`

to give the assert function and its child functions better typings.

1. All parameter combinations in createHttpError, includes:

   • assert(value, status, message, properties)
   • assert(value, status, message)
   • assert(value, status, properties)
   • assert(value, status)
   • assert(value, message, properties)
   • assert(value, message)
   • assert(value, properties)
   • assert(value)

2. assert and assert.ok have assertion signatures to assert the condition is true, for example:

   1import { IncomingMessage, ServerResponse } from 'http'
   2import assert from 'ts-http-assert'
   3
   4function controller(req: IncomingMessage, res: ServerResponse): void {
   5    const authorization = req.headers['authorization']
   6    // authorization might be string | string[] | undefined
   7    assert(typeof authorization === 'string', 401)
   8    // or `assert.ok(typeof authorization === 'string', 401)`
   9
   10    // It's OK to call the following `authorization.split` because authorization
   11    // is asserted to be string in the above line.
   12    const [method, credentials] = authorization.split(' ', 2)
   13    res.end(`You are in ${method} authorization.`)
   14}

3. assert.strictEqual has assertion signature to assert to 2 values are of the same type, for example:

   1import { IncomingMessage, ServerResponse } from 'http'
   2import assert from 'ts-http-assert'
   3
   4function controller(req: IncomingMessage, res: ServerResponse): void {
   5    const contentType = req.headers['content-type']
   6    assert.strictEqual(contentType, 'application/json')
   7
   8    // Now the contentType is asserted to be of type string
   9    res.end(`You submitted in type ${contentType.splice('/')[1]}`)
   10}

License

MIT