kenjiqq / ng-mocks

Angular 5+ component, directive, and pipe mocking library

ngMocks

Helper function for creating angular mocks for test.

Why use this?

Sure, you could flip a flag on schema errors to make your component dependencies not matter. Or you could use this to mock them out and have the ability to assert on their inputs or emit on an output to assert on a side effect.

MockComponent(s)

• Mocked component with the same selector
• Inputs and Outputs with alias support
• Each component instance has its own EventEmitter instances for outputs
• Mocked component templates are ng-content tags to allow transclusion
• Allows ng-model binding (You will have to add FormsModule to TestBed imports)
• Mocks Reactive Forms (You will have to add ReactiveFormsModule to TestBed imports)
  • __simulateChange - calls onChanged on the mocked component bound to a FormControl
  • __simulateTouch - calls onToched on the mocked component bound to a FormControl
• exportAs support

Usage Example

import { async, TestBed } from '@angular/core/testing';
import { By } from '@angular/platform-browser';
import { MockComponent } from 'ng-mocks';
import { DependencyComponent } from './dependency.component';
import { TestedComponent } from './tested.component';

describe('TestedComponent', () => {
  let fixture: ComponentFixture<TestedComponent>;

  beforeEach(async() => {
    TestBed.configureTestingModule({
      declarations: [
        TestedComponent,
        MockComponent(DependencyComponent)
      ]
    })
    .compileComponents();
    .then(() => {
      fixture = TestBed.createComponent(TestedComponent);
      component = fixture.componentInstance;
      fixture.detectChanges();
    });
  }));

  it('should send the correct value to the dependency component input', () => {
    // let's pretend Dependency Component (unmocked) has 'someInput' as an  input
    // the input value will be passed into the mocked component so you can assert on it
    const mockedComponent = fixture.debugElement
                                   .query(By.css('dependency-component-selector'))
                                   .componentInstance as DependencyComponent; // casting to retain type safety
    expect(mockedComponent.someInput).toEqual('foo'); if you casted mockedComponent as the original component type then this is type safe
  });

  it('should do something when the dependency component emits on its output', () => {
    const mockedComponent = fixture.debugElement
                                   .query(By.directive(MockComponent(DependencyComponent)))
                                   .componentInstance as DependencyComponent; // casting to retain type safety
    // again, let's pretend DependencyComponent has an output called 'someOutput'
    // emit on the output that MockComponent setup when generating the mock of Dependency Component
    mockedComponent.someOutput.emit(new Foo()); if you casted mockedComponent as the original component type then this is type safe
    fixture.detectChanges();
    // assert on some side effect
  });
});

MockDirective(s)

• Mocked directive with the same selector
• Inputs and Outputs with alias support
• Each directive instance has its own EventEmitter instances for outputs
• exportAs support

Usage Example

import { async, TestBed } from '@angular/core/testing';
import { By } from '@angular/platform-browser';
import { MockComponent } from 'ng-mocks';
import { DependencyDirective } from './dependency.directive';
import { TestedComponent } from './tested.component';

describe('TestedComponent', () => {
  let fixture: ComponentFixture<TestedComponent>;

  beforeEach(async() => {
    TestBed.configureTestingModule({
      declarations: [
        TestedComponent,
        MockDirective(DependencyDirective)
      ]
    })
    .compileComponents();
    .then(() => {
      fixture = TestBed.createComponent(TestedComponent);
      component = fixture.componentInstance;
      fixture.detectChanges();
    });
  }));

  it('should send the correct value to the dependency component input', () => {
    // let's pretend Dependency Directive (unmocked) has 'someInput' as an input
    // the input value will be passed into the mocked directive so you can assert on it
    const debugElement = fixture.debugElement.query(By.directive(MockDirective(DependencyDirective)));
    const mockedDirectiveInstance = debugElement.injector
                                                .get(MockDirective(DependencyDirective)) as DependencyDirective; // casting to retain type safety
    expect(mockedDirectiveInstance.someInput).toEqual('foo');
  });

  it('should do something when the dependency directive emits on its output', () => {
    const debugElement = fixture.debugElement.query(By.directive(MockDirective(DependencyDirective)));
    const mockedDirectiveInstance = debugElement.injector
                                                .get(MockDirective(DependencyDirective)) as DependencyDirective; // casting to retain type safety
    // again, let's pretend DependencyDirective has an output called 'someOutput'
    // emit on the output that MockDirective setup when generating the mock of Dependency Directive
    mockedDirectiveInstance.someOutput.emit(new Foo()); if you casted mockedDirective as the original component type then this is type safe
    fixture.detectChanges();
    // assert on some side effect
  });
});

MockPipe(s)

• Mocked pipe with the same name.
• Ability to override the transform function with a type-safe function
• Default transform is () => undefined to prevent problems with chaining

Personally, I found the best thing to do for assertions is to override the transform to write the args so that I can assert on the arguments.

Usage Example

import { async, TestBed } from '@angular/core/testing';
import { By } from '@angular/platform-browser';
import { MockComponent } from 'ng-mocks';
import { DependencyPipe } from './dependency.pipe';
import { TestedComponent } from './tested.component';

describe('TestedComponent', () => {
  let fixture: ComponentFixture<TestedComponent>;

  beforeEach(async() => {
    TestBed.configureTestingModule({
      declarations: [
        TestedComponent,
        MockPipe(DependencyPipe, (...args) => JSON.stringify(args)), // alternatively you can use MockPipes to mock multiple but you lose the ability to override
      ]
    })
    .compileComponents();
    .then(() => {
      fixture = TestBed.createComponent(TestedComponent);
      component = fixture.componentInstance;
      fixture.detectChanges();
    });
  }));

  describe('with transform override', () => {
    it('should return the result of the provided transform function', () => {
      expect(fixture.debugElement.query(By.css('#elementUsingPipe')).nativeElement.innerHTML).toEqual('foo');
    });
  });
});

Mocked Reactive Forms Components

• Set value on the formControl by calling __simulateChange
• Set touched on the formControl by calling __simulateTouch
• Use the MockedComponent type to stay typesafe: MockedComponent<YourReactiveFormComponent>

Usage Example

import { async, TestBed } from '@angular/core/testing';
import { By } from '@angular/platform-browser';
import { MockComponent, MockedComponent } from 'ng-mocks';
import { ReactiveFormComponent } from './dependency.component';
import { TestedComponent } from './tested.component';

describe('TestedComponent', () => {
  let fixture: ComponentFixture<TestedComponent>;

  beforeEach(async() => {
    TestBed.configureTestingModule({
      declarations: [
        TestedComponent,
        MockComponent(DependencyComponent)
      ]
    })
    .compileComponents();
    .then(() => {
      fixture = TestBed.createComponent(TestedComponent);
      component = fixture.componentInstance;
      fixture.detectChanges();
    });
  }));

  it('should send the correct value to the dependency component input', () => {
    const mockedReactiveFormComponent = fixture.debugElement
                                               .query(By.css('dependency-component-selector'))
                                               .componentInstance as MockedComponent<ReactiveFormComponent>; // casting to retain type safety
                                   
    mockedReactiveFormComponent.__simulateChange('foo');                               
    expect(component.formControl.value).toBe('foo')
  });
});

MockDeclaration(s)

It figures out if it is a component, directive, or pipe and mocks it for you

MockModule

• Mocks all components, directives, and pipes using MockDeclaration
• Providers are all mocked as empty objects
• Module Dependencies are also mocked

For providers I typically will use TestBed.get(SomeProvider) and extend it using a library like ts-mocks.

Usage Example

describe('MockModule', () => {
  let fixture: ComponentFixture<ComponentSubject>;

  beforeEach(async(() => {
    TestBed.configureTestingModule({
      declarations: [
        ComponentSubject
      ],
      imports: [
        MockModule(DependencyModule)
      ],
    })
    .compileComponents()
    .then(() => {
      fixture = TestBed.createComponent(ComponentSubject);
      fixture.detectChanges();
    });
  }));
});

Find an issue or have a request?

Report it as an issue or submit at PR. I'm open to contributions.

https://github.com/ike18t/ng-mocks