angular-cn/aio/tools/transforms/angular-api-package/processors/processAliasDocs.spec.js

84 lines
3.3 KiB
JavaScript
Raw Normal View History

const testPackage = require('../../helpers/test-package');
const processorFactory = require('./processAliasDocs');
const Dgeni = require('dgeni');
const mockLogFactory = require('dgeni/lib/mocks/log');
const createDocMessageFactory = require('dgeni-packages/base/services/createDocMessage');
describe('processAliasDocs processor', () => {
let getDocFromAlias, log, createDocMessage, processor;
beforeEach(() => {
getDocFromAlias = jasmine.createSpy('getDocFromAlias');
log = mockLogFactory(false);
createDocMessage = createDocMessageFactory();
processor = processorFactory(getDocFromAlias, log, createDocMessage);
});
it('should be available on the injector', () => {
const dgeni = new Dgeni([testPackage('angular-api-package')]);
const injector = dgeni.configureInjector();
const processor = injector.get('processAliasDocs');
expect(processor.$process).toBeDefined();
});
it('should run before the correct processor', () => {
expect(processor.$runBefore).toEqual(['filterPrivateDocs']);
});
it('should run after the correct processor', () => {
expect(processor.$runAfter).toEqual(['tags-extracted', 'ids-computed']);
});
it('should ignore docs that do not have an `@alias` tag', () => {
const docs = [{}];
getDocFromAlias.and.returnValue([{ prop1: 'prop-1', prop2: 'prop-2', prop3: 'prop-3' }]);
processor.$process(docs);
expect(docs).toEqual([{}]);
});
it('should copy over properties from a valid alias doc', () => {
const docs = [{ aliasDocId: 'alias-doc' }];
getDocFromAlias.and.returnValue([{ prop1: 'prop-1', prop2: 'prop-2', prop3: 'prop-3' }]);
processor.$process(docs);
expect(docs).toEqual([
{ prop1: 'prop-1', prop2: 'prop-2', prop3: 'prop-3' }
]);
});
it('should error if `@alias` does not match a doc', () => {
const docs = [{ aliasDocId: 'alias-doc' }];
getDocFromAlias.and.returnValue([]);
expect(() => processor.$process(docs)).toThrowError('There is no doc that matches "@alias alias-doc" - doc');
});
it('should error if `@alias` matches more than one doc', () => {
const docs = [{ aliasDocId: 'alias-doc' }];
getDocFromAlias.and.returnValue([{id: 'alias-1'}, {id: 'alias-2'}]);
expect(() => processor.$process(docs)).toThrowError('There is more than one doc that matches "@alias alias-doc": alias-1, alias-2. - doc');
});
it('should remove all but the specified properties from the original doc', () => {
processor.propertiesToKeep = ['x', 'y'];
const docs = [{ aliasDocId: 'alias-doc', x: 'original-x', z: 'original-z' }];
getDocFromAlias.and.returnValue([{}]);
processor.$process(docs);
expect(docs).toEqual([{ x: 'original-x' }]);
});
it('should copy over all but the specified properties from the aliased doc', () => {
processor.propertiesToKeep = ['x', 'y'];
const docs = [{ aliasDocId: 'alias-doc', x: 'original-x', z: 'original-z' }];
getDocFromAlias.and.returnValue([{ x: 'alias-x', y: 'alias-y', z: 'alias-z' }]);
processor.$process(docs);
expect(docs).toEqual([{ x: 'original-x', z: 'alias-z' }]);
});
it('should have default properties to keep', () => {
expect(processor.propertiesToKeep).toEqual([
'name', 'id', 'aliases', 'fileInfo', 'startingLine', 'endingLine',
'path', 'originalModule', 'outputPath', 'privateExport', 'moduleDoc'
]);
});
});