angular-docs-cn/packages/compiler-cli/ngcc/test/dependencies/dependency_resolver_spec.ts

/**
 * @license
 * Copyright Google Inc. All Rights Reserved.
 *
 * Use of this source code is governed by an MIT-style license that can be
 * found in the LICENSE file at https://angular.io/license
 */

import {DepGraph} from 'dependency-graph';

import {FileSystem, absoluteFrom, getFileSystem} from '../../../src/ngtsc/file_system';
import {runInEachFileSystem} from '../../../src/ngtsc/file_system/testing';
import {DependencyResolver, SortedEntryPointsInfo} from '../../src/dependencies/dependency_resolver';
import {EsmDependencyHost} from '../../src/dependencies/esm_dependency_host';
import {ModuleResolver} from '../../src/dependencies/module_resolver';
import {EntryPoint} from '../../src/packages/entry_point';
import {MockLogger} from '../helpers/mock_logger';


interface DepMap {
  [path: string]: {resolved: string[], missing: string[]};
}

runInEachFileSystem(() => {
  describe('DependencyResolver', () => {
    let _: typeof absoluteFrom;
    let host: EsmDependencyHost;
    let resolver: DependencyResolver;
    let fs: FileSystem;
    let moduleResolver: ModuleResolver;

    beforeEach(() => {
      _ = absoluteFrom;
      fs = getFileSystem();
      moduleResolver = new ModuleResolver(fs);
      host = new EsmDependencyHost(fs, moduleResolver);
      resolver = new DependencyResolver(fs, new MockLogger(), {esm5: host, esm2015: host});
    });

    describe('sortEntryPointsByDependency()', () => {
      let first: EntryPoint;
      let second: EntryPoint;
      let third: EntryPoint;
      let fourth: EntryPoint;
      let fifth: EntryPoint;
      let dependencies: DepMap;

      beforeEach(() => {
        first = {
          path: _('/first'),
          packageJson: {esm5: './index.js'},
          compiledByAngular: true
        } as EntryPoint;
        second = {
          path: _('/second'),
          packageJson: {esm2015: './sub/index.js'},
          compiledByAngular: true
        } as EntryPoint;
        third = {
          path: _('/third'),
          packageJson: {fesm5: './index.js'},
          compiledByAngular: true
        } as EntryPoint;
        fourth = {
          path: _('/fourth'),
          packageJson: {fesm2015: './sub2/index.js'},
          compiledByAngular: true
        } as EntryPoint;
        fifth = {
          path: _('/fifth'),
          packageJson: {module: './index.js'},
          compiledByAngular: true
        } as EntryPoint;

        dependencies = {
          [_('/first/index.js')]: {resolved: [second.path, third.path, '/ignored-1'], missing: []},
          [_('/second/sub/index.js')]: {resolved: [third.path, fifth.path], missing: []},
          [_('/third/index.js')]: {resolved: [fourth.path, '/ignored-2'], missing: []},
          [_('/fourth/sub2/index.js')]: {resolved: [fifth.path], missing: []},
          [_('/fifth/index.js')]: {resolved: [], missing: []},
        };
      });

      it('should order the entry points by their dependency on each other', () => {
        spyOn(host, 'findDependencies').and.callFake(createFakeComputeDependencies(dependencies));
        const result = resolver.sortEntryPointsByDependency([fifth, first, fourth, second, third]);
        expect(result.entryPoints).toEqual([fifth, fourth, third, second, first]);
      });

      it('should remove entry-points that have missing direct dependencies', () => {
        spyOn(host, 'findDependencies').and.callFake(createFakeComputeDependencies({
          [_('/first/index.js')]: {resolved: [], missing: ['/missing']},
          [_('/second/sub/index.js')]: {resolved: [], missing: []},
        }));
        const result = resolver.sortEntryPointsByDependency([first, second]);
        expect(result.entryPoints).toEqual([second]);
        expect(result.invalidEntryPoints).toEqual([
          {entryPoint: first, missingDependencies: ['/missing']},
        ]);
      });

      it('should remove entry points that depended upon an invalid entry-point', () => {
        spyOn(host, 'findDependencies').and.callFake(createFakeComputeDependencies({
          [_('/first/index.js')]: {resolved: [second.path, third.path], missing: []},
          [_('/second/sub/index.js')]: {resolved: [], missing: ['/missing']},
          [_('/third/index.js')]: {resolved: [], missing: []},
        }));
        // Note that we will process `first` before `second`, which has the missing dependency.
        const result = resolver.sortEntryPointsByDependency([first, second, third]);
        expect(result.entryPoints).toEqual([third]);
        expect(result.invalidEntryPoints).toEqual([
          {entryPoint: second, missingDependencies: ['/missing']},
          {entryPoint: first, missingDependencies: ['/missing']},
        ]);
      });

      it('should remove entry points that will depend upon an invalid entry-point', () => {
        spyOn(host, 'findDependencies').and.callFake(createFakeComputeDependencies({
          [_('/first/index.js')]: {resolved: [second.path, third.path], missing: []},
          [_('/second/sub/index.js')]: {resolved: [], missing: ['/missing']},
          [_('/third/index.js')]: {resolved: [], missing: []},
        }));
        // Note that we will process `first` after `second`, which has the missing dependency.
        const result = resolver.sortEntryPointsByDependency([second, first, third]);
        expect(result.entryPoints).toEqual([third]);
        expect(result.invalidEntryPoints).toEqual([
          {entryPoint: second, missingDependencies: ['/missing']},
          {entryPoint: first, missingDependencies: [second.path]},
        ]);
      });

      it('should cope with entry points having multiple indirect missing dependencies', () => {
        spyOn(host, 'findDependencies').and.callFake(createFakeComputeDependencies({
          [_('/first/index.js')]: {resolved: [], missing: ['/missing1']},
          [_('/second/sub/index.js')]: {resolved: [], missing: ['/missing2']},
          [_('/third/index.js')]: {resolved: [first.path, second.path], missing: []},
        }));
        const result = resolver.sortEntryPointsByDependency([first, second, third]);
        expect(result.entryPoints).toEqual([]);
        expect(result.invalidEntryPoints).toEqual([
          {entryPoint: first, missingDependencies: ['/missing1']},
          {entryPoint: second, missingDependencies: ['/missing2']},
          {entryPoint: third, missingDependencies: [first.path]},
        ]);
      });

      it('should error if the entry point does not have a suitable format', () => {
        expect(() => resolver.sortEntryPointsByDependency([
          { path: '/first', packageJson: {}, compiledByAngular: true } as EntryPoint
        ])).toThrowError(`There is no appropriate source code format in '/first' entry-point.`);
      });

      it('should error if there is no appropriate DependencyHost for the given formats', () => {
        resolver = new DependencyResolver(fs, new MockLogger(), {esm2015: host});
        expect(() => resolver.sortEntryPointsByDependency([first]))
            .toThrowError(
                `Could not find a suitable format for computing dependencies of entry-point: '${first.path}'.`);
      });

      it('should capture any dependencies that were ignored', () => {
        spyOn(host, 'findDependencies').and.callFake(createFakeComputeDependencies(dependencies));
        const result = resolver.sortEntryPointsByDependency([fifth, first, fourth, second, third]);
        expect(result.ignoredDependencies).toEqual([
          {entryPoint: first, dependencyPath: '/ignored-1'},
          {entryPoint: third, dependencyPath: '/ignored-2'},
        ]);
      });

      it('should return the computed dependency graph', () => {
        spyOn(host, 'findDependencies').and.callFake(createFakeComputeDependencies(dependencies));
        const result = resolver.sortEntryPointsByDependency([fifth, first, fourth, second, third]);

        expect(result.graph).toEqual(jasmine.any(DepGraph));
        expect(result.graph.size()).toBe(5);
        expect(result.graph.dependenciesOf(third.path)).toEqual([fifth.path, fourth.path]);
      });

      it('should only return dependencies of the target, if provided', () => {
        spyOn(host, 'findDependencies').and.callFake(createFakeComputeDependencies(dependencies));
        const entryPoints = [fifth, first, fourth, second, third];
        let sorted: SortedEntryPointsInfo;

        sorted = resolver.sortEntryPointsByDependency(entryPoints, first);
        expect(sorted.entryPoints).toEqual([fifth, fourth, third, second, first]);
        sorted = resolver.sortEntryPointsByDependency(entryPoints, second);
        expect(sorted.entryPoints).toEqual([fifth, fourth, third, second]);
        sorted = resolver.sortEntryPointsByDependency(entryPoints, third);
        expect(sorted.entryPoints).toEqual([fifth, fourth, third]);
        sorted = resolver.sortEntryPointsByDependency(entryPoints, fourth);
        expect(sorted.entryPoints).toEqual([fifth, fourth]);
        sorted = resolver.sortEntryPointsByDependency(entryPoints, fifth);
        expect(sorted.entryPoints).toEqual([fifth]);
      });

      it('should not process the provided target if it has missing dependencies', () => {
        spyOn(host, 'findDependencies').and.callFake(createFakeComputeDependencies({
          [_('/first/index.js')]: {resolved: [], missing: ['/missing']},
        }));
        const entryPoints = [first];
        let sorted: SortedEntryPointsInfo;

        sorted = resolver.sortEntryPointsByDependency(entryPoints, first);
        expect(sorted.entryPoints).toEqual([]);
        expect(sorted.invalidEntryPoints[0].entryPoint).toEqual(first);
        expect(sorted.invalidEntryPoints[0].missingDependencies).toEqual(['/missing']);
      });

      it('should not consider builtin NodeJS modules as missing dependency', () => {
        spyOn(host, 'findDependencies').and.callFake(createFakeComputeDependencies({
          [_('/first/index.js')]: {resolved: [], missing: ['fs']},
        }));
        const entryPoints = [first];
        let sorted: SortedEntryPointsInfo;

        sorted = resolver.sortEntryPointsByDependency(entryPoints, first);
        expect(sorted.entryPoints).toEqual([first]);
        expect(sorted.invalidEntryPoints).toEqual([]);
        expect(sorted.ignoredDependencies).toEqual([]);
      });

      it('should use the appropriate DependencyHost for each entry-point', () => {
        const esm5Host = new EsmDependencyHost(fs, moduleResolver);
        const esm2015Host = new EsmDependencyHost(fs, moduleResolver);
        resolver =
            new DependencyResolver(fs, new MockLogger(), {esm5: esm5Host, esm2015: esm2015Host});
        spyOn(esm5Host, 'findDependencies')
            .and.callFake(createFakeComputeDependencies(dependencies));
        spyOn(esm2015Host, 'findDependencies')
            .and.callFake(createFakeComputeDependencies(dependencies));
        const result = resolver.sortEntryPointsByDependency([fifth, first, fourth, second, third]);
        expect(result.entryPoints).toEqual([fifth, fourth, third, second, first]);

        expect(esm5Host.findDependencies).toHaveBeenCalledWith(fs.resolve(first.path, 'index.js'));
        expect(esm5Host.findDependencies)
            .not.toHaveBeenCalledWith(fs.resolve(second.path, 'sub/index.js'));
        expect(esm5Host.findDependencies).toHaveBeenCalledWith(fs.resolve(third.path, 'index.js'));
        expect(esm5Host.findDependencies)
            .not.toHaveBeenCalledWith(fs.resolve(fourth.path, 'sub2/index.js'));
        expect(esm5Host.findDependencies).toHaveBeenCalledWith(fs.resolve(fifth.path, 'index.js'));

        expect(esm2015Host.findDependencies)
            .not.toHaveBeenCalledWith(fs.resolve(first.path, 'index.js'));
        expect(esm2015Host.findDependencies)
            .toHaveBeenCalledWith(fs.resolve(second.path, 'sub/index.js'));
        expect(esm2015Host.findDependencies)
            .not.toHaveBeenCalledWith(fs.resolve(third.path, 'index.js'));
        expect(esm2015Host.findDependencies)
            .toHaveBeenCalledWith(fs.resolve(fourth.path, 'sub2/index.js'));
        expect(esm2015Host.findDependencies)
            .not.toHaveBeenCalledWith(fs.resolve(fifth.path, 'index.js'));
      });

      function createFakeComputeDependencies(deps: DepMap) {
        return (entryPoint: string) => {
          const dependencies = new Set();
          const missing = new Set();
          const deepImports = new Set();
          deps[entryPoint].resolved.forEach(dep => dependencies.add(dep));
          deps[entryPoint].missing.forEach(dep => missing.add(dep));
          return {dependencies, missing, deepImports};
        };
      }
    });
  });
});