jsdoc/test/specs/documentation/mixins.js

'use strict';

var augment = require('jsdoc/augment');
var name = require('jsdoc/name');

describe('mixins', function() {
    describe('doclet augmentation', function() {
        var docSet = jasmine.getDocSetFromFile('test/fixtures/mixintag2.js');
        augment.augmentAll(docSet.doclets);

        it('should create doclets for mixed-in symbols', function() {
            var objectBMethod = docSet.getByLongname('module:mixy.ObjectB.method')[0];

            expect(objectBMethod).toBeDefined();
            expect(objectBMethod.memberof).toBe('module:mixy.ObjectB');
        });

        it('should set the "mixes" property correctly on first-generation mixers', function() {
            var objectBMethod = docSet.getByLongname('module:mixy.ObjectB.method')[0];

            expect(Array.isArray(objectBMethod.mixes)).toBe(true);
            expect(objectBMethod.mixes.length).toBe(1);
            expect(objectBMethod.mixes[0]).toBe('module:mixy.ObjectA.method');
        });

        it('should set the "mixes" property correctly on second-generation mixers', function() {
            var objectCMethod = docSet.getByLongname('module:mixy.ObjectC.method')[0];

            expect(Array.isArray(objectCMethod.mixes)).toBe(true);
            expect(objectCMethod.mixes.length).toBe(1);
            expect(objectCMethod.mixes[0]).toBe('module:mixy.ObjectB.method');
        });

        it('should work with mixed-in doclets whose names are specified in the comment', function() {
            var superSweetStatic = docSet.getByLongname('module:mixy.ObjectC.superSweet')[0];
            var superSweetInstance = docSet.getByLongname('module:mixy.ClassB#superSweet')[0];

            expect(superSweetInstance).toBeDefined();
            expect(superSweetInstance.comment).toBe(superSweetStatic.comment);
        });

        describe('classes and mixins', function() {
            it('should define symbols mixed into a class as instance members', function() {
                var classAMethod = docSet.getByLongname('module:mixy.ClassA#method')[0];

                expect(classAMethod).toBeDefined();
                expect(classAMethod.scope).toBe(name.SCOPE.NAMES.INSTANCE);
                expect(classAMethod.memberof).toBe('module:mixy.ClassA');
            });
        });
    });
});