README.md

AngularJS to Angular Upgrade Path

Organization

angular-v1

Basic AngularJS application from https://github.com/angular/angular-seed

angular-v1-angular-v5

Hybrid application with tests for both AngularJS and Angular

Steps taken can be found in angular-v1-angular-v5/STEPS.md

src

Collection of scripts that have been useful for upgrading AngularJS to Angular.

Notes

• AngularJS Components / Element Directives
• AngularJS Attribute Directives
• AngularJS Factory Provider for Angular
• Angular Service in AngularJS

AngularJS Components / Element Directives

• must be changed to use closing tags

  from

   <app-component />
  

  to

   <app-component></app-component>
  

  this change was done to follow how web components must be formatted.

AngularJS Attribute Directives

• currently ngUpgrade does not support upgrade or downgrade paths and must be rewritten.
• ngAdapter extends ngUpgrade to support upgrade and downgrade paths for Angular 2. But does not work for Angular 4+ yet.

AngularJS Factory Provider for Angular

  // Class with code that does stuff
  class Foo {
    constructor(
      // dependencies
    ) {}
    ...
  }

  // AngularJS Factory
  export class FooFactory {
    public static $inject: string[] = [
      // dependencies as strings
    ];

    constructor(
      // dependencies
    ) {
      return new Foo(
        // dependencies
      )
    }
  }

  // Angular Service placeholder
  @Injectable()
  export class FooService extends Foo {}

  // function for Ahead of Time (AoT) compilation for Angular 5. Angular 6 can use () => {}
  export function fooService(injector: Injector) {
    return injector.get('fooFactory'); // name of the factory in AngularJS
  }

  // provider to replace Angular Service with the AngularJS Factory
  export const fooServiceProvider = {
    deps: ['$injector'],
    provide: FooService,
    useFactory: fooService,
  }

Usage in AngularJS

  import { FooFactory } from './fooFactory';

  export const ng1app = angular.module('ng1app', []).factory('fooFactory', FooFactory);

Usage in Angular

  import { fooServiceProvider } from './foo.service.provider';

  @NgModule({
    ...
    providers: [
      fooServiceProvider,
    ],
  })
  export class AppModule {}

Angular Service in AngularJS

  @Injectable()
  export class FooService { }

  // add to Angular
  @NgModule({
    providers: [
      FooService,
    ],
  })
  export class AppModule {}

  // add to AngularJS
  import { downgradeInjectable } from '@angular/upgrade/static';

  export const ng1app = angular.module('ng1app', []).factory(downgradeInjectable(FooService))