1.4 KiB
1.4 KiB
stubs
It's a simple stubber.
About
For when you don't want to write the same thing over and over to cache a method and call an override, then revert it, and blah blah.
Use
$ npm install --save-dev stubs
var mylib = require('./lib/index.js')
var stubs = require('stubs')
// make it a noop
stubs(mylib, 'create')
// stub it out
stubs(mylib, 'create', function() {
// calls this instead
})
// stub it out, but call the original first
stubs(mylib, 'create', { callthrough: true }, function() {
// call original method, then call this
})
// use the stub for a while, then revert
stubs(mylib, 'create', { calls: 3 }, function() {
// call this 3 times, then use the original method
})
API
stubs(object, method[[, opts], stub])
object
- Type: Object
method
- Type: String
Name of the method to stub.
opts
- (optional)
- Type: Object
opts.callthrough
- (optional)
- Type: Boolean
- Default:
false
Call the original method as well as the stub (if a stub is provided).
opts.calls
- (optional)
- Type: Number
- Default:
0
(never revert)
Number of calls to allow the stub to receive until reverting to the original.
stub
- (optional)
- Type: Function
- Default:
function() {}
This method is called in place of the original method. If opts.callthrough
is true
, this method is called after the original method is called as well.