Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 1,000,000+ packages pre-installed, including reflector with all npm packages installed. Try it out:

var reflector = require("reflector")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

reflector v0.0.4

Simple http server used as a stub for testing, will return any parameters sent (with errors if needed).


Build Status

Simple http server used as a stub for testing, will return any (GET/POST) parameters sent with some meta data as JSON. This allows you to define API calls on the fly, running requests through http, while controlling the expected output.

The server may optionally be configured to send some http errors at times replacing the expected response.


  • errors If the server should return errors randomly (~5% of the time), defaults to false.
  • port Port server should use for listening, defaults to 80.

Meta Data

Meta data is helpful for informing tests and debugging. The returned JSON object will also have a property '_meta'. This property contains three values:

  • date When this response was generated.
  • path The request path for this response.
  • count Number of times this path has been requested during the lifetime of the server.


Here is reflector being used in a mocha/should/request test (see a more in-depth example at retainer):

describe('example test', function(){
  var reflector = require('reflector'),
  request = require('request');
  var server = reflector({port : 8001});
  it('should return name-value pairs', function(done){
      url : 'http://localhost:8001/some/path?someproperty=somevalue&anotherproperty=anothervalue',
      json : true}, function(err, response, json){
      if(err) return done(err);'count', 'date', 'path');
// Returned object is:
// { _meta: 
//  { date: '2014-02-16T17:53:27.624Z', // whatever the request time is
//    path: '/some/path', // arbritary path used
//    count: 1 }, // first time this path was used
//  someproperty: 'somevalue',
//  anotherproperty: 'anothervalue' }

      return done();

RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free