jsdoc/test/specs/documentation/modules.js

/*global beforeEach: true, describe: true, env: true, expect: true, it: true */
describe("module names", function() {
    var runtime = require('jsdoc/util/runtime');
    var parser = require( runtime.getModulePath('jsdoc/src/parser') );
    var srcParser = null;
    var doclets;

    beforeEach(function() {
        env.opts._ = [__dirname + '/test/fixtures/modules/'];
        srcParser = new parser.Parser();
        require('jsdoc/src/handlers').attachTo(srcParser);
    });

    it("should create a name from the file path when no documented module name exists", function() {
        doclets = srcParser.parse(__dirname + '/test/fixtures/modules/data/mod-1.js');
        expect(doclets.length).toBeGreaterThan(1);
        expect(doclets[0].longname).toEqual('module:data/mod-1');
    });

    it("should use the documented module name if available", function() {
        doclets = srcParser.parse(__dirname + '/test/fixtures/modules/data/mod-2.js');
        expect(doclets.length).toBeGreaterThan(1);
        expect(doclets[0].longname).toEqual('module:my/module/name');
    });
});