Pete Bacon Darwin d509bd6849 build(aio): improve the API Pipe pages (#22702)
This change adds:

* an impure badge for Pipes that are marked as  `pure: false`
* a pipe specific overview that shows the syntax for using a pipe in a template.
* an "input value" section describing the type of the value that the pipe expects.
* a "pipe params" section describing any additional params that a pipe expects.

PR Close #22702
2018-03-14 14:21:11 -07:00

62 lines
2.5 KiB
JavaScript

const testPackage = require('../../helpers/test-package');
const Dgeni = require('dgeni');
describe('extractPipeParams processor', () => {
let processor;
beforeEach(() => {
const dgeni = new Dgeni([testPackage('angular-api-package')]);
const injector = dgeni.configureInjector();
processor = injector.get('extractPipeParams');
});
it('should be available on the injector', () => {
expect(processor.$process).toBeDefined();
});
it('should run before the correct processor', () => {
expect(processor.$runBefore).toEqual(['docs-processed']);
});
it('should run after the correct processor', () => {
expect(processor.$runAfter).toEqual(['extractDecoratedClassesProcessor']);
});
it('should throw an error if the pipe document does not contain a `transform` method', () => {
expect(() => processor.$process([{ docType: 'pipe' }])).toThrowError('Missing `transform` method - pipes must implement PipeTransform interface - doc (pipe) ');
expect(() => processor.$process([{ docType: 'pipe', members: [] }])).toThrowError('Missing `transform` method - pipes must implement PipeTransform interface - doc (pipe) ');
expect(() => processor.$process([{ docType: 'pipe', members: [ { name: 'notTransform' }] }])).toThrowError('Missing `transform` method - pipes must implement PipeTransform interface - doc (pipe) ');
});
it('should extract the pipe name', () => {
const docs = [ { docType: 'pipe', pipeOptions: { name: 'testPipe' }, members: [ { name: 'transform', parameterDocs: [] }] } ];
processor.$process(docs);
expect(docs[0].pipeName).toEqual('testPipe');
});
it('should extract the value parameter', () => {
const valueParam = {};
const pipeParam1 = {};
const pipeParam2 = {};
const docs = [ { docType: 'pipe', pipeOptions: { name: 'testPipe' }, members: [
{ name: 'transform', parameterDocs: [valueParam, pipeParam1, pipeParam2] }
] } ];
processor.$process(docs);
expect(docs[0].valueParam).toBe(valueParam);
});
it('should extract the pipe parameters', () => {
const valueParam = {};
const pipeParam1 = {};
const pipeParam2 = {};
const docs = [ { docType: 'pipe', pipeOptions: { name: 'testPipe' }, members: [
{ name: 'transform', parameterDocs: [valueParam, pipeParam1, pipeParam2] }
] } ];
processor.$process(docs);
expect(docs[0].pipeParams.length).toEqual(2);
expect(docs[0].pipeParams[0]).toBe(pipeParam1);
expect(docs[0].pipeParams[1]).toBe(pipeParam2);
});
});