Nanoprogrammed Penultimate Musicianship

    sutabu

    0.0.3 • Public • Published

    sutabu

    Build Status

    A minimalist AMD stubbing library for use in testing.

    This requires ES5 support. Therefore IE8 and prior are not supported.

    Usage

    The main way to use sutabu is to generate stub functions. Generating a new stub function looks like this:

    define([ 'sutabu/stub' ], function (stub) {
        var stubFunc = stub();
        var result = stubFunc();
     
        console.log(stubFunc.callCount); // outputs: 1
    });

    Each generated stub function contains 3 non-emurable properties that dictate how the stub behaves. If any of these are set, they will be processed when the function is invoked and returned:

    Property Description
    .throws If not undefined, this will be thrown when the stub function is called.
    .calls Assumed to be a function, it will be called with the same scope and arguments as the stub function.
    .returns Whatever is assigned here is returned, which defaults to undefined, which means stub functions return by default undefined

    When a new stub function is created, you can pass a single argument that will define how the stub behaves when called. If you pass an instance of Error it will assigned to .throws, if you pass a function, it will be assigned to .calls and if you pass any other type of argument, it is assigned to .returns.

    Stubbing Functions

    If you want to specifically stub a function, you can call stub.func(). Basic usage is something like this:

    define([ 'sutabu/stub' ], function (stub) {
        var obj = {};
     
        var handle = stub.func(obj, 'foo', function () {
            return 'bar';
        });
     
        console.log(obj.foo()); // outputs: 'bar'
        console.log(obj.foo.callCount); // outputs: 1
     
        handle.remove(); // removes the stub
    });

    Testing

    Testing is done via The Intern and uses Grunt for task automation. To run the unit tests, first install the prerequisites via npm:

    npm install

    To run the unit tests locally, against Node:

    grunt test:node

    To run the tests using SauceLabs, assuming you have your SauceLabs credentials available in the environment:

    grunt test

    Keywords

    none

    Install

    npm i sutabu

    DownloadsWeekly Downloads

    1

    Version

    0.0.3

    License

    none

    Last publish

    Collaborators

    • kitsonk