❤
npm
Sign UpSign In

jenkins-js-test

1.0.1 • Public • Published

Jenkins JS Test

This package provides some test utilities.

Install Package:

npm install --save-dev jenkins-js-test

Also see jenkins-js-modules and jenkins-js-builder.

onPage

This utility allows you to test some content using jsdom (a lightweight "headless" browser).

Here's an example from the Twitter Bootstrap Framework lib.

var jsTest = require("jenkins-js-test");
 
var JENKINS_PAGE = '<html><head resURL="/jenkins"></head><body><div id="divOnPage">Bootstrap is everywhere</div></body></html>';
 
describe("bootstrap3.js", function () {
 
    it("- test", function (done) {
        jsTest.onPage(function() {
            var bootstrap3 = require("../js/bootstrap3");
            var $bootstrap = bootstrap3.getBootstrap();
 
            expect($bootstrap('#divOnPage').text()).toBe('Bootstrap is everywhere');
            
            done();
        }, JENKINS_PAGE);
    });
});

Note the call to done();. This is a Jasmine "thing". It marks the end of an async test flow.

requireSrcModule

This utility makes it a bit easier to load the modules under test.

Without using requireSrcModule, tests would need to load source modules in an ugly/brittle path (like in the above Bootstrap example) e.g.

var mathUtil = require('../../../src/js/utils/mathUtil');

Using requireSrcModule, the above code would be:

var jsTest = require("jenkins-js-test");
 
var mathUtil = jsTest.requireSrcModule('utils/mathUtil');

NOTE: This is integrated with jenkins-js-builder. It will resolve the module being required based on src/test builder configuration.

Examples

See the examples in js-samples, especially step-07-jsdom-tests and step-08-zombie-tests.

Dependencies (13)

Dev Dependencies (0)

    Package Sidebar

    Install

    npm i jenkins-js-test

    Repository

    github.com/jenkinsci/js-test

    Homepage

    github.com/jenkinsci/js-test#readme

    Weekly Downloads

    314

    Version

    1.0.1

    License

    MIT

    Last publish

    Collaborators

    • tfennelly
    Try on RunKit
    Report malware