/** * @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 {AbsoluteFsPath} from '../../../src/ngtsc/path'; import {ModuleResolver, ResolvedDeepImport, ResolvedExternalModule, ResolvedRelativeModule} from '../../src/dependencies/module_resolver'; import {MockFileSystem} from '../helpers/mock_file_system'; const _ = AbsoluteFsPath.from; function createMockFileSystem() { return new MockFileSystem({ '/libs': { 'local-package': { 'package.json': 'PACKAGE.JSON for local-package', 'index.js': `import {X} from './x';`, 'x.js': `export class X {}`, 'sub-folder': { 'index.js': `import {X} from '../x';`, }, 'node_modules': { 'package-1': { 'sub-folder': {'index.js': `export class Z {}`}, 'package.json': 'PACKAGE.JSON for package-1', }, }, }, 'node_modules': { 'package-2': { 'package.json': 'PACKAGE.JSON for package-2', 'node_modules': { 'package-3': { 'package.json': 'PACKAGE.JSON for package-3', }, }, }, }, }, '/dist': { 'package-4': { 'x.js': `export class X {}`, 'package.json': 'PACKAGE.JSON for package-4', 'sub-folder': {'index.js': `import {X} from '@shared/package-4/x';`}, }, 'sub-folder': { 'package-4': { 'package.json': 'PACKAGE.JSON for package-4', }, 'package-5': { 'package.json': 'PACKAGE.JSON for package-5', 'post-fix': { 'package.json': 'PACKAGE.JSON for package-5/post-fix', } }, } }, '/node_modules': { 'top-package': { 'package.json': 'PACKAGE.JSON for top-package', } } }); } describe('ModuleResolver', () => { describe('resolveModule()', () => { describe('with relative paths', () => { it('should resolve sibling, child and aunt modules', () => { const resolver = new ModuleResolver(createMockFileSystem()); expect(resolver.resolveModuleImport('./x', _('/libs/local-package/index.js'))) .toEqual(new ResolvedRelativeModule(_('/libs/local-package/x.js'))); expect(resolver.resolveModuleImport('./sub-folder', _('/libs/local-package/index.js'))) .toEqual(new ResolvedRelativeModule(_('/libs/local-package/sub-folder/index.js'))); expect(resolver.resolveModuleImport('../x', _('/libs/local-package/sub-folder/index.js'))) .toEqual(new ResolvedRelativeModule(_('/libs/local-package/x.js'))); }); it('should return `null` if the resolved module relative module does not exist', () => { const resolver = new ModuleResolver(createMockFileSystem()); expect(resolver.resolveModuleImport('./y', _('/libs/local-package/index.js'))).toBe(null); }); }); describe('with non-mapped external paths', () => { it('should resolve to the package.json of a local node_modules package', () => { const resolver = new ModuleResolver(createMockFileSystem()); expect(resolver.resolveModuleImport('package-1', _('/libs/local-package/index.js'))) .toEqual(new ResolvedExternalModule(_('/libs/local-package/node_modules/package-1'))); expect( resolver.resolveModuleImport('package-1', _('/libs/local-package/sub-folder/index.js'))) .toEqual(new ResolvedExternalModule(_('/libs/local-package/node_modules/package-1'))); expect(resolver.resolveModuleImport('package-1', _('/libs/local-package/x.js'))) .toEqual(new ResolvedExternalModule(_('/libs/local-package/node_modules/package-1'))); }); it('should resolve to the package.json of a higher node_modules package', () => { const resolver = new ModuleResolver(createMockFileSystem()); expect(resolver.resolveModuleImport('package-2', _('/libs/local-package/index.js'))) .toEqual(new ResolvedExternalModule(_('/libs/node_modules/package-2'))); expect(resolver.resolveModuleImport('top-package', _('/libs/local-package/index.js'))) .toEqual(new ResolvedExternalModule(_('/node_modules/top-package'))); }); it('should return `null` if the package cannot be found', () => { const resolver = new ModuleResolver(createMockFileSystem()); expect(resolver.resolveModuleImport('missing-2', _('/libs/local-package/index.js'))) .toBe(null); }); it('should return `null` if the package is not accessible because it is in a inner node_modules package', () => { const resolver = new ModuleResolver(createMockFileSystem()); expect(resolver.resolveModuleImport('package-3', _('/libs/local-package/index.js'))) .toBe(null); }); it('should identify deep imports into an external module', () => { const resolver = new ModuleResolver(createMockFileSystem()); expect( resolver.resolveModuleImport('package-1/sub-folder', _('/libs/local-package/index.js'))) .toEqual( new ResolvedDeepImport(_('/libs/local-package/node_modules/package-1/sub-folder'))); }); }); describe('with mapped path external modules', () => { it('should resolve to the package.json of simple mapped packages', () => { const resolver = new ModuleResolver( createMockFileSystem(), {baseUrl: '/dist', paths: {'*': ['*', 'sub-folder/*']}}); expect(resolver.resolveModuleImport('package-4', _('/libs/local-package/index.js'))) .toEqual(new ResolvedExternalModule(_('/dist/package-4'))); expect(resolver.resolveModuleImport('package-5', _('/libs/local-package/index.js'))) .toEqual(new ResolvedExternalModule(_('/dist/sub-folder/package-5'))); }); it('should select the best match by the length of prefix before the *', () => { const resolver = new ModuleResolver(createMockFileSystem(), { baseUrl: '/dist', paths: { '@lib/*': ['*'], '@lib/sub-folder/*': ['*'], } }); // We should match the second path (e.g. `'@lib/sub-folder/*'`), which will actually map to // `*` and so the final resolved path will not include the `sub-folder` segment. expect(resolver.resolveModuleImport( '@lib/sub-folder/package-4', _('/libs/local-package/index.js'))) .toEqual(new ResolvedExternalModule(_('/dist/package-4'))); }); it('should follow the ordering of `paths` when matching mapped packages', () => { let resolver: ModuleResolver; const fs = createMockFileSystem(); resolver = new ModuleResolver(fs, {baseUrl: '/dist', paths: {'*': ['*', 'sub-folder/*']}}); expect(resolver.resolveModuleImport('package-4', _('/libs/local-package/index.js'))) .toEqual(new ResolvedExternalModule(_('/dist/package-4'))); resolver = new ModuleResolver(fs, {baseUrl: '/dist', paths: {'*': ['sub-folder/*', '*']}}); expect(resolver.resolveModuleImport('package-4', _('/libs/local-package/index.js'))) .toEqual(new ResolvedExternalModule(_('/dist/sub-folder/package-4'))); }); it('should resolve packages when the path mappings have post-fixes', () => { const resolver = new ModuleResolver( createMockFileSystem(), {baseUrl: '/dist', paths: {'*': ['sub-folder/*/post-fix']}}); expect(resolver.resolveModuleImport('package-5', _('/libs/local-package/index.js'))) .toEqual(new ResolvedExternalModule(_('/dist/sub-folder/package-5/post-fix'))); }); it('should match paths against complex path matchers', () => { const resolver = new ModuleResolver( createMockFileSystem(), {baseUrl: '/dist', paths: {'@shared/*': ['sub-folder/*']}}); expect(resolver.resolveModuleImport('@shared/package-4', _('/libs/local-package/index.js'))) .toEqual(new ResolvedExternalModule(_('/dist/sub-folder/package-4'))); expect(resolver.resolveModuleImport('package-5', _('/libs/local-package/index.js'))) .toBe(null); }); it('should resolve path as "relative" if the mapped path is inside the current package', () => { const resolver = new ModuleResolver( createMockFileSystem(), {baseUrl: '/dist', paths: {'@shared/*': ['*']}}); expect(resolver.resolveModuleImport( '@shared/package-4/x', _('/dist/package-4/sub-folder/index.js'))) .toEqual(new ResolvedRelativeModule(_('/dist/package-4/x.js'))); }); it('should resolve paths where the wildcard matches more than one path segment', () => { const resolver = new ModuleResolver( createMockFileSystem(), {baseUrl: '/dist', paths: {'@shared/*/post-fix': ['*/post-fix']}}); expect( resolver.resolveModuleImport( '@shared/sub-folder/package-5/post-fix', _('/dist/package-4/sub-folder/index.js'))) .toEqual(new ResolvedExternalModule(_('/dist/sub-folder/package-5/post-fix'))); }); }); }); });