Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

koa-json-success

fabioricali9MIT1.3.2

JSON API response format for KOA 2

koa2, api, response, json, restapi, success-response

readme

koa-json-success

JSON API response format for KOA 2

This module creates a JSON response such as the following.

{
  "success": true,
  "message": "all done",
  "result": "anythings you want",
  "time": "2017-08-30T09:59:00.846Z",
  "code": 200
}

More info on JSON Success Response

Installation

npm install koa-json-success --save

Example

Basic usage

const success = require('koa-json-success');
const koa = require('koa');
const app = new koa();

success(app);

app.use(ctx=>{
    ctx.success(true);
    /* Response output example 
    {
      "success": true,
      "code": 200,
      "message": "ok",
      "result": null,
      "time": "2017-08-30T09:59:00.846Z"
    }
    */

    ctx.success(
        true,
        'message string', // default is "ok" or "failed"
        'a result that can be anythings', // default is null
        200 //status code, default 200
    );
});

app.listen(3000);

API

  • success(success, [message], [result], [code])
  • successTrue([message], [result], [code])
  • successFalse([message], [result], [code])
  • successIf(result, [opts])
  • successIfNotEmpty(result, [opts])
  • success400([message], [result])
  • success401([message], [result])
  • success402([message], [result])
  • success403([message], [result])
  • success404([message], [result])
  • success405([message], [result])
  • success406([message], [result])
  • success407([message], [result])
  • success408([message], [result])
  • success409([message], [result])
  • success410([message], [result])
  • success411([message], [result])
  • success412([message], [result])
  • success413([message], [result])
  • success414([message], [result])
  • success415([message], [result])
  • success416([message], [result])
  • success417([message], [result])
  • success418([message], [result])
  • success417([message], [result])
  • success421([message], [result])
  • success422([message], [result])
  • success423([message], [result])
  • success424([message], [result])
  • success425([message], [result])
  • success426([message], [result])
  • success428([message], [result])
  • success429([message], [result])
  • success431([message], [result])
  • success500([message], [result])
  • success501([message], [result])
  • success502([message], [result])
  • success503([message], [result])
  • success504([message], [result])
  • success505([message], [result])
  • success506([message], [result])
  • success507([message], [result])
  • success508([message], [result])
  • success509([message], [result])
  • success510([message], [result])
  • success511([message], [result])

Please see full documentation

Changelog

You can view the changelog here

License

koa-json-success is open-sourced software licensed under the MIT license

Authors

Fabio Ricali

changelog

Change Log

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

[1.3.2] - 2024-07-18

  • Fixed status message

[1.3.1] - 2019-01-25

  • Fixed possible CORB issue when use JSONP

[1.3.0] - 2018-10-15

  • Now all method returns response object

[1.2.2] - 2018-03-07

  • Improved JSONP options

[1.2.1] - 2017-09-08

  • Updated dependencies

[1.2.0] - 2017-09-08

  • Added quick status code methods

[1.1.0] - 2017-09-01

  • Added JSONP support

[1.0.0] - 2017-09-01

  • Added ctx.successIf
  • Added ctx.successIfNotEmpty
  • Added API documentation

[0.1.0] - 2017-08-31

  • First release