restspec

3.2.1 • Public • Published

restspec rest-api test

usage

  • npm install restspec --save-dev
var Restspec = require('restspec');
new Restspec(options);

options

  • name String, This test's name.
  • urlRoot String, Url root eg. http://127.0.0.1
  • cases Array, Test cases.
  • hooks Object, Hooks function.
    • done Function, Called when test cases exec done.
  • globals.request.headers Object,

case

  • name String, This is name of case
  • uri String, Request url is urlRoot concat uri. eg. /session
  • verb String, Enum get, post, put, patch, delete default get
  • headers Object, Request customer headers.
  • data Fixed, Request send data.
  • expects
    • Status response.statusCode
    • JSON assert response.body
//case1. assert body
JSON: {
  id: 1,
  name: 'Hello'
}

//case2. body is an array, assert one
JSON: ['0', {
  id: 1,
  name: 'Hello'
}]

//case2. body is an array, assert all
JSON: ['*', {
  id: 1,
  name: 'Hello'
}]
  • JSONTypes assert response.body type
  • JSONLength assert response.body length
  • Header assert one response.headers
Header: ['x-content-record-total', '2']
  • Headers assert some response.headers
Headers: [
  ['x-content-record-total', '2'],
  ['content-type', 'application/json']
]

Advanced Usage

JSON: {
  // assert is require('assert')
  id: function(actual, assert) {
    assert.equal(typeof actual, 'number');
    assert.equal(actual, 20);
  }
var case = {
  name: 'This is name of case',
  uri: '/session',
  expects: {
    Status: 201,
    JSON: {
      id: 1,
      name: 'Hello world'
    },
    JSONTypes: ['parent', {
      id: Number,
      name: String
    }]
  }
}
var case = function(lastBody, lastRes) {
  return {
    name: 'This is function return case'
    uri: '/session',
    expects: {
      Status: 201,
      JSON: {
        id: 1,
        name: 'Hello world'
      },
      JSONTypes: ['parent', {
        id: Number,
        name: String
      }]
    }
  }
};
var case = function(lastBody, lastRes) {
  return new Promise(function(resolve, reject) {
    return resolve({
      name: 'This is function return case with promise'
      uri: '/session',
      expects: {
        Status: 201,
        JSON: {
          id: 1,
          name: 'Hello world'
        },
        JSONTypes: ['parent', {
          id: Number,
          name: String
        }]
      }
    })
  };
};
var case = async () => {
  const user = await Model.findOne({ where: { id: 1 } });

    // If the function is returned, it will be called.
    return () => {
      const { age } = user;

      if (age <= 18) return new Error(`Adult only: ${age}`);

      return null;
    };
  };
};
var case = () => {
  const age = 17;
  // Error instances can be returned directly.
  if (age <= 18) return new Error(`Adult only: ${age}`);

  return null;
};

Comment

  • cases run one by one

Readme

Keywords

Package Sidebar

Install

npm i restspec

Weekly Downloads

5

Version

3.2.1

License

MIT

Unpacked Size

11.8 kB

Total Files

3

Last publish

Collaborators

  • stonephp