egg-response v1.8.1

egg-response

English|中文

Dependency Description

Dependent egg version

Installation

$ npm i egg-response --save
or
$ yarn add egg-response

Open the plugin

// config/plugin.js
exports.response = {
  enable: true,
  package: 'egg-response',
};

Where to use

// {app_root}/app/controller/post.js

ctx.successful(data[,options]);

// or

ctx.failed([options]);

API

ctx.successful(data,options)

Create a successful response

Parameter

• data - the data returned by the response
• options (optional) -Object with the following optional attributes:
  • isData -boolean, whether to return data, the default value is true,If set to false, the returned json field data will be replaced by message
  • code -int, response status code, default value is 200
  • extra -Object, additional information

Example

ctx.successful([1,2,3],{
  extra: {
    xxx: 'Additional message'
  }
});

• Returns the result, will be in json format, as follows:

{
  "success": true,
  "code": 200,
  "data": [1,2,3],
  "xxx": "Additional message"
}

ctx.failed(options)

Create a failed response

Parameter

• options (optional) -Object with the following optional attributes:
  • message - error message, default value is 'Request error'
  • code - response status code, default value is 500
  • extra - append message

Example

ctx.failed({ message: 'There is no such category' });

• Returns the result,will be in json format, as follows:

{
  "code": 500,
  "success": false,
  "message": "There is no such category"
}

Outdated (v1.1.0)

ctx.createSuccessResponse(data,code)

with

ctx.createFailedResponse([message,code])

Detailed configuration

Go to config/config.default.js for detailed configuration item descriptions.

Asking questions

Please go to egg issues for asynchronous communication.

License

MIT