/** * @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 {Rule, SchematicContext, SchematicsException, Tree} from '@angular-devkit/schematics'; import {dirname, relative} from 'path'; import * as ts from 'typescript'; import {getProjectTsConfigPaths} from '../../utils/project_tsconfig_paths'; import {createMigrationCompilerHost} from '../../utils/typescript/compiler_host'; import {parseTsconfigFile} from '../../utils/typescript/parse_tsconfig'; import {HelperFunction, getHelper} from './helpers'; import {migrateExpression, replaceImport} from './migration'; import {findCoreImport, findRendererReferences} from './util'; /** * Migration that switches from `Renderer` to `Renderer2`. More information on how it works: * https://hackmd.angular.io/UTzUZTnPRA-cSa_4mHyfYw */ export default function(): Rule { return (tree: Tree, context: SchematicContext) => { const {buildPaths, testPaths} = getProjectTsConfigPaths(tree); const basePath = process.cwd(); const allPaths = [...buildPaths, ...testPaths]; const logger = context.logger; logger.info('------ Renderer to Renderer2 Migration ------'); logger.info('As of Angular 9, the Renderer class is no longer available. '); logger.info('Renderer2 should be used instead. Read more about this in '); logger.info('the dedicated guide: '); logger.info('https://v9.angular.io/guide/migration-renderer'); if (!allPaths.length) { throw new SchematicsException( 'Could not find any tsconfig file. Cannot migrate Renderer usages to Renderer2.'); } for (const tsconfigPath of allPaths) { runRendererToRenderer2Migration(tree, tsconfigPath, basePath); } }; } function runRendererToRenderer2Migration(tree: Tree, tsconfigPath: string, basePath: string) { const parsed = parseTsconfigFile(tsconfigPath, dirname(tsconfigPath)); const host = createMigrationCompilerHost(tree, parsed.options, basePath); const program = ts.createProgram(parsed.fileNames, parsed.options, host); const typeChecker = program.getTypeChecker(); const printer = ts.createPrinter(); const sourceFiles = program.getSourceFiles().filter( f => !f.isDeclarationFile && !program.isSourceFileFromExternalLibrary(f)); sourceFiles.forEach(sourceFile => { const rendererImport = findCoreImport(sourceFile, 'Renderer'); // If there are no imports for the `Renderer`, we can exit early. if (!rendererImport) { return; } const {typedNodes, methodCalls, forwardRefs} = findRendererReferences(sourceFile, typeChecker, rendererImport); const update = tree.beginUpdate(relative(basePath, sourceFile.fileName)); const helpersToAdd = new Set(); // Change the `Renderer` import to `Renderer2`. update.remove(rendererImport.getStart(), rendererImport.getWidth()); update.insertRight( rendererImport.getStart(), printer.printNode( ts.EmitHint.Unspecified, replaceImport(rendererImport, 'Renderer', 'Renderer2'), sourceFile)); // Change the method parameter and property types to `Renderer2`. typedNodes.forEach(node => { const type = node.type; if (type) { update.remove(type.getStart(), type.getWidth()); update.insertRight(type.getStart(), 'Renderer2'); } }); // Change all identifiers inside `forwardRef` referring to the `Renderer`. forwardRefs.forEach(identifier => { update.remove(identifier.getStart(), identifier.getWidth()); update.insertRight(identifier.getStart(), 'Renderer2'); }); // Migrate all of the method calls. methodCalls.forEach(call => { const {node, requiredHelpers} = migrateExpression(call, typeChecker); if (node) { // If we migrated the node to a new expression, replace only the call expression. update.remove(call.getStart(), call.getWidth()); update.insertRight( call.getStart(), printer.printNode(ts.EmitHint.Unspecified, node, sourceFile)); } else if (call.parent && ts.isExpressionStatement(call.parent)) { // Otherwise if the call is inside an expression statement, drop the entire statement. // This takes care of any trailing semicolons. We only need to drop nodes for cases like // `setBindingDebugInfo` which have been noop for a while so they can be removed safely. update.remove(call.parent.getStart(), call.parent.getWidth()); } if (requiredHelpers) { requiredHelpers.forEach(helperName => helpersToAdd.add(helperName)); } }); // Some of the methods can't be mapped directly to `Renderer2` and need extra logic around them. // The safest way to do so is to declare helper functions similar to the ones emitted by TS // which encapsulate the extra "glue" logic. We should only emit these functions once per file. helpersToAdd.forEach(helperName => { update.insertLeft( sourceFile.endOfFileToken.getStart(), getHelper(helperName, sourceFile, printer)); }); tree.commitUpdate(update); }); }