angular-docs-cn/modules/@angular/compiler/test/test_component_builder_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 {beforeEach, ddescribe, xdescribe, describe, expect, iit, inject, beforeEachProviders, it, xit,} from '@angular/core/testing/testing_internal';
import {TestComponentBuilder, ComponentFixtureAutoDetect, ComponentFixtureNoNgZone} from '@angular/core/testing';
import {AsyncTestCompleter} from '@angular/core/testing/testing_internal';
import {Injectable, Component, Input, ViewMetadata} from '@angular/core';
import {NgIf} from '@angular/common';
import {TimerWrapper} from '../src/facade/async';
import {IS_DART} from '../src/facade/lang';
import {PromiseWrapper} from '../src/facade/promise';
import {dispatchEvent} from '@angular/platform-browser/testing/browser_util';
import {withProviders} from '@angular/core/testing/test_injector';

@Component(
    {selector: 'child-comp', template: `<span>Original {{childBinding}}</span>`, directives: []})
@Injectable()
class ChildComp {
  childBinding: string;
  constructor() { this.childBinding = 'Child'; }
}

@Component({selector: 'child-comp', template: `<span>Mock</span>`})
@Injectable()
class MockChildComp {
}

@Component({
  selector: 'parent-comp',
  template: `Parent(<child-comp></child-comp>)`,
  directives: [ChildComp]
})
@Injectable()
class ParentComp {
}

@Component({
  selector: 'my-if-comp',
  template: `MyIf(<span *ngIf="showMore">More</span>)`,
  directives: [NgIf]
})
@Injectable()
class MyIfComp {
  showMore: boolean = false;
}

@Component({selector: 'child-child-comp', template: `<span>ChildChild</span>`})
@Injectable()
class ChildChildComp {
}

@Component({
  selector: 'child-comp',
  template: `<span>Original {{childBinding}}(<child-child-comp></child-child-comp>)</span>`,
  directives: [ChildChildComp]
})
@Injectable()
class ChildWithChildComp {
  childBinding: string;
  constructor() { this.childBinding = 'Child'; }
}

@Component({selector: 'child-child-comp', template: `<span>ChildChild Mock</span>`})
@Injectable()
class MockChildChildComp {
}

@Component({selector: 'autodetect-comp', template: `<span (click)='click()'>{{text}}</span>`})
class AutoDetectComp {
  text: string = '1';

  click() { this.text += '1'; }
}

@Component({selector: 'async-comp', template: `<span (click)='click()'>{{text}}</span>`})
class AsyncComp {
  text: string = '1';

  click() {
    PromiseWrapper.resolve(null).then((_) => { this.text += '1'; });
  }
}

@Component({selector: 'async-child-comp', template: '<span>{{localText}}</span>'})
class AsyncChildComp {
  localText: string = '';

  @Input()
  set text(value: string) {
    PromiseWrapper.resolve(null).then((_) => { this.localText = value; });
  }
}

@Component({
  selector: 'async-change-comp',
  template: `<async-child-comp (click)='click()' [text]="text"></async-child-comp>`,
  directives: [AsyncChildComp]
})
class AsyncChangeComp {
  text: string = '1';

  click() { this.text += '1'; }
}

@Component({selector: 'async-timeout-comp', template: `<span (click)='click()'>{{text}}</span>`})
class AsyncTimeoutComp {
  text: string = '1';

  click() {
    TimerWrapper.setTimeout(() => { this.text += '1'; }, 10);
  }
}

@Component(
    {selector: 'nested-async-timeout-comp', template: `<span (click)='click()'>{{text}}</span>`})
class NestedAsyncTimeoutComp {
  text: string = '1';

  click() {
    TimerWrapper.setTimeout(
        () => { TimerWrapper.setTimeout(() => { this.text += '1'; }, 10); }, 10);
  }
}

class FancyService {
  value: string = 'real value';
}

class MockFancyService extends FancyService {
  value: string = 'mocked out value';
}

@Component({
  selector: 'my-service-comp',
  providers: [FancyService],
  template: `injected value: {{fancyService.value}}`
})
class TestBindingsComp {
  constructor(private fancyService: FancyService) {}
}

@Component({
  selector: 'my-service-comp',
  viewProviders: [FancyService],
  template: `injected value: {{fancyService.value}}`
})
class TestViewBindingsComp {
  constructor(private fancyService: FancyService) {}
}

@Component({selector: 'li1', template: `<span>One</span>`})
class ListDir1 {
}

@Component({selector: 'li1', template: `<span>Alternate One</span>`})
class ListDir1Alt {
}

@Component({selector: 'li2', template: `<span>Two</span>`})
class ListDir2 {
}

const LIST_CHILDREN = /*@ts2dart_const*/[ListDir1, ListDir2];

@Component({
  selector: 'directive-list-comp',
  template: `(<li1></li1>)(<li2></li2>)`,
  directives: [LIST_CHILDREN]
})
class DirectiveListComp {
}


export function main() {
  describe('test component builder', function() {
    it('should instantiate a component with valid DOM',
       inject(
           [TestComponentBuilder, AsyncTestCompleter],
           (tcb: TestComponentBuilder, async: AsyncTestCompleter) => {

             tcb.createAsync(ChildComp).then((componentFixture) => {
               componentFixture.detectChanges();

               expect(componentFixture.nativeElement).toHaveText('Original Child');
               async.done();
             });
           }));

    it('should allow changing members of the component',
       inject(
           [TestComponentBuilder, AsyncTestCompleter],
           (tcb: TestComponentBuilder, async: AsyncTestCompleter) => {

             tcb.createAsync(MyIfComp).then((componentFixture) => {
               componentFixture.detectChanges();
               expect(componentFixture.nativeElement).toHaveText('MyIf()');

               componentFixture.componentInstance.showMore = true;
               componentFixture.detectChanges();
               expect(componentFixture.nativeElement).toHaveText('MyIf(More)');

               async.done();
             });
           }));

    it('should override a template',
       inject(
           [TestComponentBuilder, AsyncTestCompleter],
           (tcb: TestComponentBuilder, async: AsyncTestCompleter) => {

             tcb.overrideTemplate(MockChildComp, '<span>Mock</span>')
                 .createAsync(MockChildComp)
                 .then((componentFixture) => {
                   componentFixture.detectChanges();
                   expect(componentFixture.nativeElement).toHaveText('Mock');

                   async.done();
                 });
           }));

    it('should override a view',
       inject(
           [TestComponentBuilder, AsyncTestCompleter],
           (tcb: TestComponentBuilder, async: AsyncTestCompleter) => {

             tcb.overrideView(
                    ChildComp,
                    new ViewMetadata({template: '<span>Modified {{childBinding}}</span>'}))
                 .createAsync(ChildComp)
                 .then((componentFixture) => {
                   componentFixture.detectChanges();
                   expect(componentFixture.nativeElement).toHaveText('Modified Child');

                   async.done();
                 });
           }));

    it('should override component dependencies',
       inject(
           [TestComponentBuilder, AsyncTestCompleter],
           (tcb: TestComponentBuilder, async: AsyncTestCompleter) => {

             tcb.overrideDirective(ParentComp, ChildComp, MockChildComp)
                 .createAsync(ParentComp)
                 .then((componentFixture) => {
                   componentFixture.detectChanges();
                   expect(componentFixture.nativeElement).toHaveText('Parent(Mock)');

                   async.done();
                 });
           }));

    it('should override items from a list',
       inject(
           [TestComponentBuilder, AsyncTestCompleter],
           (tcb: TestComponentBuilder, async: AsyncTestCompleter) => {

             tcb.overrideDirective(DirectiveListComp, ListDir1, ListDir1Alt)
                 .createAsync(DirectiveListComp)
                 .then((componentFixture) => {
                   componentFixture.detectChanges();
                   expect(componentFixture.nativeElement).toHaveText('(Alternate One)(Two)');

                   async.done();
                 });
           }));

    it('should override child component\'s dependencies',
       inject(
           [TestComponentBuilder, AsyncTestCompleter],
           (tcb: TestComponentBuilder, async: AsyncTestCompleter) => {

             tcb.overrideDirective(ParentComp, ChildComp, ChildWithChildComp)
                 .overrideDirective(ChildWithChildComp, ChildChildComp, MockChildChildComp)
                 .createAsync(ParentComp)
                 .then((componentFixture) => {
                   componentFixture.detectChanges();
                   expect(componentFixture.nativeElement)
                       .toHaveText('Parent(Original Child(ChildChild Mock))');

                   async.done();
                 });
           }));

    it('should override a provider',
       inject(
           [TestComponentBuilder, AsyncTestCompleter],
           (tcb: TestComponentBuilder, async: AsyncTestCompleter) => {

             tcb.overrideProviders(
                    TestBindingsComp, [{provide: FancyService, useClass: MockFancyService}])
                 .createAsync(TestBindingsComp)
                 .then((componentFixture) => {
                   componentFixture.detectChanges();
                   expect(componentFixture.nativeElement)
                       .toHaveText('injected value: mocked out value');
                   async.done();
                 });
           }));


    it('should override a viewBinding',
       inject(
           [TestComponentBuilder, AsyncTestCompleter],
           (tcb: TestComponentBuilder, async: AsyncTestCompleter) => {

             tcb.overrideViewProviders(
                    TestViewBindingsComp, [{provide: FancyService, useClass: MockFancyService}])
                 .createAsync(TestViewBindingsComp)
                 .then((componentFixture) => {
                   componentFixture.detectChanges();
                   expect(componentFixture.nativeElement)
                       .toHaveText('injected value: mocked out value');
                   async.done();
                 });
           }));

    it('should create components synchronously',
       inject([TestComponentBuilder], (tcb: TestComponentBuilder) => {

         let componentFixture =
             tcb.overrideTemplate(MockChildComp, '<span>Mock</span>').createSync(MockChildComp);
         componentFixture.detectChanges();
         expect(componentFixture.nativeElement).toHaveText('Mock');
       }));

    if (!IS_DART) {
      describe('ComponentFixture', () => {
        it('should auto detect changes if autoDetectChanges is called',
           inject(
               [TestComponentBuilder, AsyncTestCompleter],
               (tcb: TestComponentBuilder, async: AsyncTestCompleter) => {

                 tcb.createAsync(AutoDetectComp).then((componentFixture) => {
                   expect(componentFixture.ngZone).not.toBeNull();
                   componentFixture.autoDetectChanges();
                   expect(componentFixture.nativeElement).toHaveText('1');

                   let element = componentFixture.debugElement.children[0];
                   dispatchEvent(element.nativeElement, 'click');

                   expect(componentFixture.isStable()).toBe(true);
                   expect(componentFixture.nativeElement).toHaveText('11');
                   async.done();
                 });
               }));

        it('should auto detect changes if ComponentFixtureAutoDetect is provided as true',
           withProviders(() => [{provide: ComponentFixtureAutoDetect, useValue: true}])
               .inject(
                   [TestComponentBuilder, AsyncTestCompleter],
                   (tcb: TestComponentBuilder, async: AsyncTestCompleter) => {

                     tcb.createAsync(AutoDetectComp).then((componentFixture) => {
                       expect(componentFixture.nativeElement).toHaveText('1');

                       let element = componentFixture.debugElement.children[0];
                       dispatchEvent(element.nativeElement, 'click');

                       expect(componentFixture.nativeElement).toHaveText('11');
                       async.done();
                     });
                   }));

        it('should signal through whenStable when the fixture is stable (autoDetectChanges)',
           inject(
               [TestComponentBuilder, AsyncTestCompleter],
               (tcb: TestComponentBuilder, async: AsyncTestCompleter) => {

                 tcb.createAsync(AsyncComp).then((componentFixture) => {
                   componentFixture.autoDetectChanges();
                   expect(componentFixture.nativeElement).toHaveText('1');

                   let element = componentFixture.debugElement.children[0];
                   dispatchEvent(element.nativeElement, 'click');
                   expect(componentFixture.nativeElement).toHaveText('1');

                   // Component is updated asynchronously. Wait for the fixture to become stable
                   // before checking for new value.
                   expect(componentFixture.isStable()).toBe(false);
                   componentFixture.whenStable().then((waited) => {
                     expect(waited).toBe(true);
                     expect(componentFixture.nativeElement).toHaveText('11');
                     async.done();
                   });
                 });
               }));

        it('should signal through isStable when the fixture is stable (no autoDetectChanges)',
           inject(
               [TestComponentBuilder, AsyncTestCompleter],
               (tcb: TestComponentBuilder, async: AsyncTestCompleter) => {

                 tcb.createAsync(AsyncComp).then((componentFixture) => {
                   componentFixture.detectChanges();
                   expect(componentFixture.nativeElement).toHaveText('1');

                   let element = componentFixture.debugElement.children[0];
                   dispatchEvent(element.nativeElement, 'click');
                   expect(componentFixture.nativeElement).toHaveText('1');

                   // Component is updated asynchronously. Wait for the fixture to become stable
                   // before checking.
                   componentFixture.whenStable().then((waited) => {
                     expect(waited).toBe(true);
                     componentFixture.detectChanges();
                     expect(componentFixture.nativeElement).toHaveText('11');
                     async.done();
                   });
                 });
               }));

        it('should wait for macroTask(setTimeout) while checking for whenStable ' +
               '(autoDetectChanges)',
           inject(
               [TestComponentBuilder, AsyncTestCompleter],
               (tcb: TestComponentBuilder, async: AsyncTestCompleter) => {

                 tcb.createAsync(AsyncTimeoutComp).then((componentFixture) => {
                   componentFixture.autoDetectChanges();
                   expect(componentFixture.nativeElement).toHaveText('1');

                   let element = componentFixture.debugElement.children[0];
                   dispatchEvent(element.nativeElement, 'click');
                   expect(componentFixture.nativeElement).toHaveText('1');

                   // Component is updated asynchronously. Wait for the fixture to become
                   // stable before checking for new value.
                   expect(componentFixture.isStable()).toBe(false);
                   componentFixture.whenStable().then((waited) => {
                     expect(waited).toBe(true);
                     expect(componentFixture.nativeElement).toHaveText('11');
                     async.done();
                   });
                 });
               }));

        it('should wait for macroTask(setTimeout) while checking for whenStable ' +
               '(no autoDetectChanges)',
           inject(
               [TestComponentBuilder, AsyncTestCompleter],
               (tcb: TestComponentBuilder, async: AsyncTestCompleter) => {

                 tcb.createAsync(AsyncTimeoutComp).then((componentFixture) => {
                   componentFixture.detectChanges();
                   expect(componentFixture.nativeElement).toHaveText('1');

                   let element = componentFixture.debugElement.children[0];
                   dispatchEvent(element.nativeElement, 'click');
                   expect(componentFixture.nativeElement).toHaveText('1');

                   // Component is updated asynchronously. Wait for the fixture to become
                   // stable before checking for new value.
                   expect(componentFixture.isStable()).toBe(false);
                   componentFixture.whenStable().then((waited) => {
                     expect(waited).toBe(true);
                     componentFixture.detectChanges();
                     expect(componentFixture.nativeElement).toHaveText('11');
                     async.done();
                   });
                 });
               }));

        it('should wait for nested macroTasks(setTimeout) while checking for whenStable ' +
               '(autoDetectChanges)',
           inject(
               [TestComponentBuilder, AsyncTestCompleter],
               (tcb: TestComponentBuilder, async: AsyncTestCompleter) => {

                 tcb.createAsync(NestedAsyncTimeoutComp).then((componentFixture) => {
                   componentFixture.autoDetectChanges();
                   expect(componentFixture.nativeElement).toHaveText('1');

                   let element = componentFixture.debugElement.children[0];
                   dispatchEvent(element.nativeElement, 'click');
                   expect(componentFixture.nativeElement).toHaveText('1');

                   // Component is updated asynchronously. Wait for the fixture to become
                   // stable before checking for new value.
                   expect(componentFixture.isStable()).toBe(false);
                   componentFixture.whenStable().then((waited) => {
                     expect(waited).toBe(true);
                     expect(componentFixture.nativeElement).toHaveText('11');
                     async.done();
                   });
                 });
               }));

        it('should wait for nested macroTasks(setTimeout) while checking for whenStable ' +
               '(no autoDetectChanges)',
           inject(
               [TestComponentBuilder, AsyncTestCompleter],
               (tcb: TestComponentBuilder, async: AsyncTestCompleter) => {

                 tcb.createAsync(NestedAsyncTimeoutComp).then((componentFixture) => {
                   componentFixture.detectChanges();
                   expect(componentFixture.nativeElement).toHaveText('1');

                   let element = componentFixture.debugElement.children[0];
                   dispatchEvent(element.nativeElement, 'click');
                   expect(componentFixture.nativeElement).toHaveText('1');

                   // Component is updated asynchronously. Wait for the fixture to become
                   // stable before checking for new value.
                   expect(componentFixture.isStable()).toBe(false);
                   componentFixture.whenStable().then((waited) => {
                     expect(waited).toBe(true);
                     componentFixture.detectChanges();
                     expect(componentFixture.nativeElement).toHaveText('11');
                     async.done();
                   });
                 });
               }));

        it('should stabilize after async task in change detection (autoDetectChanges)',
           inject(
               [TestComponentBuilder, AsyncTestCompleter],
               (tcb: TestComponentBuilder, async: AsyncTestCompleter) => {

                 tcb.createAsync(AsyncChangeComp).then((componentFixture) => {
                   componentFixture.autoDetectChanges();
                   componentFixture.whenStable().then((_) => {
                     expect(componentFixture.nativeElement).toHaveText('1');

                     let element = componentFixture.debugElement.children[0];
                     dispatchEvent(element.nativeElement, 'click');

                     componentFixture.whenStable().then((_) => {
                       expect(componentFixture.nativeElement).toHaveText('11');
                       async.done();
                     });
                   });
                 });
               }));

        it('should stabilize after async task in change detection(no autoDetectChanges)',
           inject(
               [TestComponentBuilder, AsyncTestCompleter],
               (tcb: TestComponentBuilder, async: AsyncTestCompleter) => {

                 tcb.createAsync(AsyncChangeComp).then((componentFixture) => {
                   componentFixture.detectChanges();
                   componentFixture.whenStable().then((_) => {
                     // Run detectChanges again so that stabilized value is reflected in the
                     // DOM.
                     componentFixture.detectChanges();
                     expect(componentFixture.nativeElement).toHaveText('1');

                     let element = componentFixture.debugElement.children[0];
                     dispatchEvent(element.nativeElement, 'click');
                     componentFixture.detectChanges();

                     componentFixture.whenStable().then((_) => {
                       // Run detectChanges again so that stabilized value is reflected in
                       // the DOM.
                       componentFixture.detectChanges();
                       expect(componentFixture.nativeElement).toHaveText('11');
                       async.done();
                     });
                   });
                 });
               }));

        describe('No NgZone', () => {
          beforeEachProviders(() => [{provide: ComponentFixtureNoNgZone, useValue: true}]);

          it('calling autoDetectChanges raises an error', () => {
            inject(
                [TestComponentBuilder, AsyncTestCompleter],
                (tcb: TestComponentBuilder, async: AsyncTestCompleter) => {
                  tcb.createAsync(ChildComp).then((componentFixture) => {
                    expect(() => { componentFixture.autoDetectChanges(); })
                        .toThrow(
                            'Cannot call autoDetectChanges when ComponentFixtureNoNgZone is set!!');
                    async.done();
                  });
                });
          });

          it('should instantiate a component with valid DOM',
             inject(
                 [TestComponentBuilder, AsyncTestCompleter],
                 (tcb: TestComponentBuilder, async: AsyncTestCompleter) => {

                   tcb.createAsync(ChildComp).then((componentFixture) => {
                     expect(componentFixture.ngZone).toBeNull();
                     componentFixture.detectChanges();
                     expect(componentFixture.nativeElement).toHaveText('Original Child');
                     async.done();
                   });
                 }));

          it('should allow changing members of the component',
             inject(
                 [TestComponentBuilder, AsyncTestCompleter],
                 (tcb: TestComponentBuilder, async: AsyncTestCompleter) => {

                   tcb.createAsync(MyIfComp).then((componentFixture) => {
                     componentFixture.detectChanges();
                     expect(componentFixture.nativeElement).toHaveText('MyIf()');

                     componentFixture.componentInstance.showMore = true;
                     componentFixture.detectChanges();
                     expect(componentFixture.nativeElement).toHaveText('MyIf(More)');

                     async.done();
                   });
                 }));
        });

      });
    }
  });
}