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
		
			
				
	
	
		
			62 lines
		
	
	
		
			2.5 KiB
		
	
	
	
		
			JavaScript
		
	
	
	
	
	
			
		
		
	
	
			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);
 | |
|   });
 | |
| });
 | |
| 
 | |
| 
 |