angular-docs-cn/modules/@angular/core/testing/testing.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
 */

/**
 * Public Test Library for unit testing Angular2 Applications. Assumes that you are running
 * with Jasmine, Mocha, or a similar framework which exports a beforeEach function and
 * allows tests to be asynchronous by either returning a promise or using a 'done' parameter.
 */

import {SchemaMetadata} from '../index';
import {TestBed, getTestBed} from './test_bed';

declare var global: any;

var _global = <any>(typeof window === 'undefined' ? global : window);

var testBed: TestBed = getTestBed();

// Reset the test providers before each test.
if (_global.beforeEach) {
  _global.beforeEach(() => { testBed.reset(); });
}

/**
 * Allows overriding default providers of the test injector,
 * which are defined in test_injector.js
 *
 * @stable
 */
export function addProviders(providers: Array<any>): void {
  if (!providers) return;
  try {
    testBed.configureModule({providers: providers});
  } catch (e) {
    throw new Error(
        'addProviders can\'t be called after the injector has been already created for this test. ' +
        'This is most likely because you\'ve already used the injector to inject a beforeEach or the ' +
        'current `it` function.');
  }
}

/**
 * Allows overriding default providers, directives, pipes, modules of the test injector,
 * which are defined in test_injector.js
 *
 * @stable
 */
export function configureModule(moduleDef: {
  providers?: any[],
  declarations?: any[],
  imports?: any[],
  entryComponents?: any[],
  schemas?: Array<SchemaMetadata|any[]>
}): void {
  if (!moduleDef) return;
  try {
    testBed.configureModule(moduleDef);
  } catch (e) {
    throw new Error(
        'configureModule can\'t be called after the injector has been already created for this test. ' +
        'This is most likely because you\'ve already used the injector to inject a beforeEach or the ' +
        'current `it` function.');
  }
}

/**
 * Allows overriding default compiler providers and settings
 * which are defined in test_injector.js
 *
 * @stable
 */
export function configureCompiler(config: {providers?: any[], useJit?: boolean}): void {
  if (!config) return;
  try {
    testBed.configureCompiler(config);
  } catch (e) {
    throw new Error(
        'configureCompiler can\'t be called after the injector has been already created for this test. ' +
        'This is most likely because you\'ve already used the injector to inject a beforeEach or the ' +
        'current `it` function.');
  }
}