koa-kit

1.1.0 • Public • Published

koa-kit

A simple framework with functional tools for koa.

Support Koa@2.x from 1.1.0

NPM version build status Test coverage NPM Monthly Downloads Dependencies License Tips

Usage

const kk = require('koa-kit');
const app = kk();
 
app.listen();

Options

const app = kk({
  body: {formidable: {uploadDir: path.join(__dirname, '..', 'public/upload')}}, // <- by default, see https://github.com/dlau/koa-body
  error: undefined, // <- by default, see https://github.com/zedgu/koa-http-errors
  csrf: undefined, // <- by default, false for not setting, see https://github.com/pillarjs/csrf
  xss: '1; mode=block', // <- by default, false for not setting
  xtype: 'nosniff', // <- by default, false for not setting
  xframe: 'SAMEORIGIN', // <- by default, false for not setting
  hsts: false, // <- by default, true for set('Strict-Transport-Security', 'max-age=7776000; includeSubDomains'). But setting this in nginx is better.
  context: true, // <- by default, false for not using
  session: ['kk-key'], // <- by default, session secret keys, false for not using
  etag: true, // <- by default, false for not using
  logger: true, // <- by default, false for not using, only for 'development' env
  debug: 'koa:kit', // <- by default, name for debug (https://www.npmjs.com/package/debug)
  assertOK: 'assertOK', // <- by default, false for not using, see APIs - ctx.assertOK
  assertEqual: 'assertEqual' // <- by default, false for not using, see APIs - ctx.assertEqual
  assertQuery: 'assertQuery' // <- by default, false for not using, see APIs - ctx.assertQuery
});

APIs

app.listen

app.listen([port], [callback], [onException]); Deprecated

  • port: 9030 by default, or set process.env.PORT;
  • callback: call by http.Server.listen;
  • onException: handler for Event: 'uncaughtException'.

app.listen();

  • Same as koa.listen;

ctx.assertOK

ctx.assertOK(value[, statusCode][, statusMeassage][, errorProperties])

Just like the ctx.assert, but throw error when value instanceof Error;

ctx.assertEqual

ctx.assertEqual(actual, expected[, statusCode][, statusMeassage][, errorProperties])

Throw HTTPError if actual is not match the type or value of expected.

  • actual: required, throw error when it is undefined;
  • expected:
    • RegExp
      • return expected.test(actual)
    • Function
      • return expected(actual);
      • expected must return a Boolean.
    • Object
      • Wrapper Object, check the type of the actual. (For example, {userName: String, age: Number}.)
      • Normal Object, deeply checking by expected. (For example, {userName: 'abc', age: 18, address: /^No\./i}.)
var obj = {
  userName: 'abc',
  age: 18,
  address: 'No.123 xyz Road.'
};
 
this.assertEqual(obj.age, 19);
// => HTTPError, 18 != 19
this.assertEqual(obj.address, /^No\./i);
// => true, /^No\./i.test('No.123 xyz Road.')
this.assertEqual(obj, {userName: String, age: Number});
// => Do nothing, type matched.
// String, Number, Array, Object, Boolean, Function
this.assertEqual(obj, {userName: 'abc', age: '18', address: /^No\./i});
// => HTTPError, using Strict Equal, 18 !== '18'.
this.assertEqual(obj, {userName: 'abc', age: function (value){ return value > 17 && value < 25; }});
// => Do nothing, age function return true.

ctx.assertQuery

ctx.assertQuery(actual, expected[, statusCode][, statusMeassage][, errorProperties])

Almost the same as ctx.assertEqual, but:

  • actual:
    • undefined
      • return HTTP 400 by default
  • expected:
    • String
      • Tests required properties when actual is an object, property names should set off by ONE (space) . (For example, "userName aget".)
var obj = {
  userName: 'abc',
  age: 18,
  address: 'No.123 xyz Road.'
};
 
this.assertEqual(obj, 'userName age');
// => Do nothing.
this.assertEqual(obj, 'userName fullName');
// => HTTPError, fullName was missing.

Package Sidebar

Install

npm i koa-kit

Weekly Downloads

8

Version

1.1.0

License

MIT

Last publish

Collaborators

  • zedgu