@angular/core 13.0.0-next.8 → 13.0.0-rc.2

package/testing/testing.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v13.0.0-next.8
+ * @license Angular v13.0.0-rc.2
  * (c) 2010-2021 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -13,6 +13,7 @@ import { ComponentRef } from '@angular/core';
 import { DebugElement } from '@angular/core';
 import { Directive } from '@angular/core';
 import { ElementRef } from '@angular/core';
+import * as i0 from '@angular/core';
 import { InjectFlags } from '@angular/core';
 import { InjectionToken } from '@angular/core';
 import { Injector } from '@angular/core';
@@ -232,7 +233,7 @@ export declare type MetadataOverride<T> = {
 };
 
 /**
- * Object used to configure the test module teardown behavior in `TestBed`.
+ * Configures the test module teardown behavior in `TestBed`.
  * @publicApi
  */
 export declare interface ModuleTeardownOptions {
@@ -268,6 +269,20 @@ export declare interface TestBed {
      * '@angular/<platform_name>/testing'.
      */
     initTestEnvironment(ngModule: Type<any> | Type<any>[], platform: PlatformRef, options?: TestEnvironmentOptions): void;
+    /**
+     * Initialize the environment for testing with a compiler factory, a PlatformRef, and an
+     * angular module. These are common to every test in the suite.
+     *
+     * This may only be called once, to set up the common providers for the current test
+     * suite on the current platform. If you absolutely need to change the providers,
+     * first use `resetTestEnvironment`.
+     *
+     * Test modules and platforms for individual platforms are available from
+     * '@angular/<platform_name>/testing'.
+     *
+     * @deprecated This API that allows providing AOT summaries is deprecated, since summary files are
+     *     unused in Ivy.
+     */
     initTestEnvironment(ngModule: Type<any> | Type<any>[], platform: PlatformRef, aotSummaries?: () => any[]): void;
     /**
      * Reset the providers for the test injector.
@@ -331,9 +346,32 @@ export declare const TestBed: TestBedStatic;
  */
 export declare interface TestBedStatic {
     new (...args: any[]): TestBed;
-    initTestEnvironment(ngModule: Type<any> | Type<any>[], platform: PlatformRef, options?: {
-        teardown?: ModuleTeardownOptions;
-    }): TestBed;
+    /**
+     * Initialize the environment for testing with a compiler factory, a PlatformRef, and an
+     * angular module. These are common to every test in the suite.
+     *
+     * This may only be called once, to set up the common providers for the current test
+     * suite on the current platform. If you absolutely need to change the providers,
+     * first use `resetTestEnvironment`.
+     *
+     * Test modules and platforms for individual platforms are available from
+     * '@angular/<platform_name>/testing'.
+     */
+    initTestEnvironment(ngModule: Type<any> | Type<any>[], platform: PlatformRef, options?: TestEnvironmentOptions): TestBed;
+    /**
+     * Initialize the environment for testing with a compiler factory, a PlatformRef, and an
+     * angular module. These are common to every test in the suite.
+     *
+     * This may only be called once, to set up the common providers for the current test
+     * suite on the current platform. If you absolutely need to change the providers,
+     * first use `resetTestEnvironment`.
+     *
+     * Test modules and platforms for individual platforms are available from
+     * '@angular/<platform_name>/testing'.
+     *
+     * @deprecated This API that allows providing AOT summaries is deprecated, since summary files are
+     *     unused in Ivy.
+     */
     initTestEnvironment(ngModule: Type<any> | Type<any>[], platform: PlatformRef, aotSummaries?: () => any[]): TestBed;
     /**
      * Reset the providers for the test injector.
@@ -411,7 +449,16 @@ export declare class TestComponentRenderer {
  * @publicApi
  */
 export declare interface TestEnvironmentOptions {
+    /**
+     * Provides a way to specify AOT summaries to use in TestBed.
+     * This parameter is unused and deprecated in Ivy.
+     *
+     * @deprecated With Ivy, AOT summary files are unused.
+     */
     aotSummaries?: () => any[];
+    /**
+     * Configures the test module teardown behavior in `TestBed`.
+     */
     teardown?: ModuleTeardownOptions;
 }
 
@@ -423,6 +470,9 @@ export declare type TestModuleMetadata = {
     declarations?: any[];
     imports?: any[];
     schemas?: Array<SchemaMetadata | any[]>;
+    /**
+     * @deprecated With Ivy, AOT summary files are unused.
+     */
     aotSummaries?: () => any[];
     teardown?: ModuleTeardownOptions;
 };
@@ -522,340 +572,6 @@ export declare function withModule(moduleDef: TestModuleMetadata): InjectSetupWr
 
 export declare function withModule(moduleDef: TestModuleMetadata, fn: Function): () => any;
 
-/**
- * @description
- * Configures and initializes environment for unit testing and provides methods for
- * creating components and services in unit tests.
- *
- * `TestBed` is the primary api for writing unit tests for Angular applications and libraries.
- *
- * Note: Use `TestBed` in tests. It will be set to either `TestBedViewEngine` or `TestBedRender3`
- * according to the compiler used.
- */
-export declare class ɵangular_packages_core_testing_testing_a implements TestBed {
-    /**
-     * Teardown options that have been configured at the environment level.
-     * Used as a fallback if no instance-level options have been provided.
-     */
-    private static _environmentTeardownOptions;
-    /**
-     * Teardown options that have been configured at the `TestBed` instance level.
-     * These options take precedence over the environemnt-level ones.
-     */
-    private _instanceTeardownOptions;
-    /**
-     * Initialize the environment for testing with a compiler factory, a PlatformRef, and an
-     * angular module. These are common to every test in the suite.
-     *
-     * This may only be called once, to set up the common providers for the current test
-     * suite on the current platform. If you absolutely need to change the providers,
-     * first use `resetTestEnvironment`.
-     *
-     * Test modules and platforms for individual platforms are available from
-     * '@angular/<platform_name>/testing'.
-     */
-    static initTestEnvironment(ngModule: Type<any> | Type<any>[], platform: PlatformRef, summariesOrOptions?: TestEnvironmentOptions | (() => any[])): ɵangular_packages_core_testing_testing_a;
-    /**
-     * Reset the providers for the test injector.
-     */
-    static resetTestEnvironment(): void;
-    static resetTestingModule(): TestBedStatic;
-    /**
-     * Allows overriding default compiler providers and settings
-     * which are defined in test_injector.js
-     */
-    static configureCompiler(config: {
-        providers?: any[];
-        useJit?: boolean;
-    }): TestBedStatic;
-    /**
-     * Allows overriding default providers, directives, pipes, modules of the test injector,
-     * which are defined in test_injector.js
-     */
-    static configureTestingModule(moduleDef: TestModuleMetadata): TestBedStatic;
-    /**
-     * Compile components with a `templateUrl` for the test's NgModule.
-     * It is necessary to call this function
-     * as fetching urls is asynchronous.
-     */
-    static compileComponents(): Promise<any>;
-    static overrideModule(ngModule: Type<any>, override: MetadataOverride<NgModule>): TestBedStatic;
-    static overrideComponent(component: Type<any>, override: MetadataOverride<Component>): TestBedStatic;
-    static overrideDirective(directive: Type<any>, override: MetadataOverride<Directive>): TestBedStatic;
-    static overridePipe(pipe: Type<any>, override: MetadataOverride<Pipe>): TestBedStatic;
-    static overrideTemplate(component: Type<any>, template: string): TestBedStatic;
-    /**
-     * Overrides the template of the given component, compiling the template
-     * in the context of the TestingModule.
-     *
-     * Note: This works for JIT and AOTed components as well.
-     */
-    static overrideTemplateUsingTestingModule(component: Type<any>, template: string): TestBedStatic;
-    /**
-     * Overwrites all providers for the given token with the given provider definition.
-     *
-     * Note: This works for JIT and AOTed components as well.
-     */
-    static overrideProvider(token: any, provider: {
-        useFactory: Function;
-        deps: any[];
-    }): TestBedStatic;
-    static overrideProvider(token: any, provider: {
-        useValue: any;
-    }): TestBedStatic;
-    static inject<T>(token: ProviderToken<T>, notFoundValue?: T, flags?: InjectFlags): T;
-    static inject<T>(token: ProviderToken<T>, notFoundValue: null, flags?: InjectFlags): T | null;
-    /** @deprecated from v9.0.0 use TestBed.inject */
-    static get<T>(token: ProviderToken<T>, notFoundValue?: T, flags?: InjectFlags): any;
-    /**
-     * @deprecated from v9.0.0 use TestBed.inject
-     * @suppress {duplicate}
-     */
-    static get(token: any, notFoundValue?: any): any;
-    static createComponent<T>(component: Type<T>): ComponentFixture<T>;
-    static shouldTearDownTestingModule(): boolean;
-    static tearDownTestingModule(): void;
-    private _instantiated;
-    private _compiler;
-    private _moduleRef;
-    private _moduleFactory;
-    private _pendingModuleFactory;
-    private _compilerOptions;
-    private _moduleOverrides;
-    private _componentOverrides;
-    private _directiveOverrides;
-    private _pipeOverrides;
-    private _providers;
-    private _declarations;
-    private _imports;
-    private _schemas;
-    private _activeFixtures;
-    private _testEnvAotSummaries;
-    private _aotSummaries;
-    private _templateOverrides;
-    private _isRoot;
-    private _rootProviderOverrides;
-    platform: PlatformRef;
-    ngModule: Type<any> | Type<any>[];
-    /**
-     * Initialize the environment for testing with a compiler factory, a PlatformRef, and an
-     * angular module. These are common to every test in the suite.
-     *
-     * This may only be called once, to set up the common providers for the current test
-     * suite on the current platform. If you absolutely need to change the providers,
-     * first use `resetTestEnvironment`.
-     *
-     * Test modules and platforms for individual platforms are available from
-     * '@angular/<platform_name>/testing'.
-     */
-    initTestEnvironment(ngModule: Type<any> | Type<any>[], platform: PlatformRef, summariesOrOptions?: TestEnvironmentOptions | (() => any[])): void;
-    /**
-     * Reset the providers for the test injector.
-     */
-    resetTestEnvironment(): void;
-    resetTestingModule(): void;
-    configureCompiler(config: {
-        providers?: any[];
-        useJit?: boolean;
-    }): void;
-    configureTestingModule(moduleDef: TestModuleMetadata): void;
-    compileComponents(): Promise<any>;
-    private _initIfNeeded;
-    private _createCompilerAndModule;
-    private _assertNotInstantiated;
-    inject<T>(token: ProviderToken<T>, notFoundValue?: T, flags?: InjectFlags): T;
-    inject<T>(token: ProviderToken<T>, notFoundValue: null, flags?: InjectFlags): T | null;
-    /** @deprecated from v9.0.0 use TestBed.inject */
-    get<T>(token: ProviderToken<T>, notFoundValue?: T, flags?: InjectFlags): any;
-    /** @deprecated from v9.0.0 use TestBed.inject */
-    get(token: any, notFoundValue?: any): any;
-    execute(tokens: any[], fn: Function, context?: any): any;
-    overrideModule(ngModule: Type<any>, override: MetadataOverride<NgModule>): void;
-    overrideComponent(component: Type<any>, override: MetadataOverride<Component>): void;
-    overrideDirective(directive: Type<any>, override: MetadataOverride<Directive>): void;
-    overridePipe(pipe: Type<any>, override: MetadataOverride<Pipe>): void;
-    /**
-     * Overwrites all providers for the given token with the given provider definition.
-     */
-    overrideProvider(token: any, provider: {
-        useFactory: Function;
-        deps: any[];
-    }): void;
-    overrideProvider(token: any, provider: {
-        useValue: any;
-    }): void;
-    private overrideProviderImpl;
-    overrideTemplateUsingTestingModule(component: Type<any>, template: string): void;
-    createComponent<T>(component: Type<T>): ComponentFixture<T>;
-    private destroyActiveFixtures;
-    private shouldRethrowTeardownErrors;
-    shouldTearDownTestingModule(): boolean;
-    tearDownTestingModule(): void;
-}
-
-/**
- * @description
- * Configures and initializes environment for unit testing and provides methods for
- * creating components and services in unit tests.
- *
- * TestBed is the primary api for writing unit tests for Angular applications and libraries.
- *
- * Note: Use `TestBed` in tests. It will be set to either `TestBedViewEngine` or `TestBedRender3`
- * according to the compiler used.
- */
-export declare class ɵangular_packages_core_testing_testing_b implements TestBed {
-    /**
-     * Teardown options that have been configured at the environment level.
-     * Used as a fallback if no instance-level options have been provided.
-     */
-    private static _environmentTeardownOptions;
-    /**
-     * Teardown options that have been configured at the `TestBed` instance level.
-     * These options take precedence over the environemnt-level ones.
-     */
-    private _instanceTeardownOptions;
-    /**
-     * Initialize the environment for testing with a compiler factory, a PlatformRef, and an
-     * angular module. These are common to every test in the suite.
-     *
-     * This may only be called once, to set up the common providers for the current test
-     * suite on the current platform. If you absolutely need to change the providers,
-     * first use `resetTestEnvironment`.
-     *
-     * Test modules and platforms for individual platforms are available from
-     * '@angular/<platform_name>/testing'.
-     *
-     * @publicApi
-     */
-    static initTestEnvironment(ngModule: Type<any> | Type<any>[], platform: PlatformRef, summariesOrOptions?: TestEnvironmentOptions | (() => any[])): TestBed;
-    /**
-     * Reset the providers for the test injector.
-     *
-     * @publicApi
-     */
-    static resetTestEnvironment(): void;
-    static configureCompiler(config: {
-        providers?: any[];
-        useJit?: boolean;
-    }): TestBedStatic;
-    /**
-     * Allows overriding default providers, directives, pipes, modules of the test injector,
-     * which are defined in test_injector.js
-     */
-    static configureTestingModule(moduleDef: TestModuleMetadata): TestBedStatic;
-    /**
-     * Compile components with a `templateUrl` for the test's NgModule.
-     * It is necessary to call this function
-     * as fetching urls is asynchronous.
-     */
-    static compileComponents(): Promise<any>;
-    static overrideModule(ngModule: Type<any>, override: MetadataOverride<NgModule>): TestBedStatic;
-    static overrideComponent(component: Type<any>, override: MetadataOverride<Component>): TestBedStatic;
-    static overrideDirective(directive: Type<any>, override: MetadataOverride<Directive>): TestBedStatic;
-    static overridePipe(pipe: Type<any>, override: MetadataOverride<Pipe>): TestBedStatic;
-    static overrideTemplate(component: Type<any>, template: string): TestBedStatic;
-    /**
-     * Overrides the template of the given component, compiling the template
-     * in the context of the TestingModule.
-     *
-     * Note: This works for JIT and AOTed components as well.
-     */
-    static overrideTemplateUsingTestingModule(component: Type<any>, template: string): TestBedStatic;
-    static overrideProvider(token: any, provider: {
-        useFactory: Function;
-        deps: any[];
-    }): TestBedStatic;
-    static overrideProvider(token: any, provider: {
-        useValue: any;
-    }): TestBedStatic;
-    static inject<T>(token: ProviderToken<T>, notFoundValue?: T, flags?: InjectFlags): T;
-    static inject<T>(token: ProviderToken<T>, notFoundValue: null, flags?: InjectFlags): T | null;
-    /** @deprecated from v9.0.0 use TestBed.inject */
-    static get<T>(token: ProviderToken<T>, notFoundValue?: T, flags?: InjectFlags): any;
-    /** @deprecated from v9.0.0 use TestBed.inject */
-    static get(token: any, notFoundValue?: any): any;
-    static createComponent<T>(component: Type<T>): ComponentFixture<T>;
-    static resetTestingModule(): TestBedStatic;
-    static shouldTearDownTestingModule(): boolean;
-    static tearDownTestingModule(): void;
-    platform: PlatformRef;
-    ngModule: Type<any> | Type<any>[];
-    private _compiler;
-    private _testModuleRef;
-    private _activeFixtures;
-    private _globalCompilationChecked;
-    /**
-     * Initialize the environment for testing with a compiler factory, a PlatformRef, and an
-     * angular module. These are common to every test in the suite.
-     *
-     * This may only be called once, to set up the common providers for the current test
-     * suite on the current platform. If you absolutely need to change the providers,
-     * first use `resetTestEnvironment`.
-     *
-     * Test modules and platforms for individual platforms are available from
-     * '@angular/<platform_name>/testing'.
-     *
-     * @publicApi
-     */
-    initTestEnvironment(ngModule: Type<any> | Type<any>[], platform: PlatformRef, summariesOrOptions?: {
-        teardown?: ModuleTeardownOptions;
-    } | (() => any[])): void;
-    /**
-     * Reset the providers for the test injector.
-     *
-     * @publicApi
-     */
-    resetTestEnvironment(): void;
-    resetTestingModule(): void;
-    configureCompiler(config: {
-        providers?: any[];
-        useJit?: boolean;
-    }): void;
-    configureTestingModule(moduleDef: TestModuleMetadata): void;
-    compileComponents(): Promise<any>;
-    inject<T>(token: ProviderToken<T>, notFoundValue?: T, flags?: InjectFlags): T;
-    inject<T>(token: ProviderToken<T>, notFoundValue: null, flags?: InjectFlags): T | null;
-    /** @deprecated from v9.0.0 use TestBed.inject */
-    get<T>(token: ProviderToken<T>, notFoundValue?: T, flags?: InjectFlags): any;
-    /** @deprecated from v9.0.0 use TestBed.inject */
-    get(token: any, notFoundValue?: any): any;
-    execute(tokens: any[], fn: Function, context?: any): any;
-    overrideModule(ngModule: Type<any>, override: MetadataOverride<NgModule>): void;
-    overrideComponent(component: Type<any>, override: MetadataOverride<Component>): void;
-    overrideTemplateUsingTestingModule(component: Type<any>, template: string): void;
-    overrideDirective(directive: Type<any>, override: MetadataOverride<Directive>): void;
-    overridePipe(pipe: Type<any>, override: MetadataOverride<Pipe>): void;
-    /**
-     * Overwrites all providers for the given token with the given provider definition.
-     */
-    overrideProvider(token: any, provider: {
-        useFactory?: Function;
-        useValue?: any;
-        deps?: any[];
-    }): void;
-    createComponent<T>(type: Type<T>): ComponentFixture<T>;
-    private assertNotInstantiated;
-    /**
-     * Check whether the module scoping queue should be flushed, and flush it if needed.
-     *
-     * When the TestBed is reset, it clears the JIT module compilation queue, cancelling any
-     * in-progress module compilation. This creates a potential hazard - the very first time the
-     * TestBed is initialized (or if it's reset without being initialized), there may be pending
-     * compilations of modules declared in global scope. These compilations should be finished.
-     *
-     * To ensure that globally declared modules have their components scoped properly, this function
-     * is called whenever TestBed is initialized or reset. The _first_ time that this happens, prior
-     * to any other operations, the scoping queue is flushed.
-     */
-    private checkGlobalCompilationFinished;
-    private destroyActiveFixtures;
-    private shouldRethrowTeardownErrors;
-    shouldTearDownTestingModule(): boolean;
-    tearDownTestingModule(): void;
-}
-
-export declare function ɵangular_packages_core_testing_testing_c(): ɵangular_packages_core_testing_testing_b;
-
 export declare class ɵMetadataOverrider {
     private _references;
     /**
@@ -894,6 +610,8 @@ export declare class ɵTestingCompiler extends Compiler {
      * This can be used for errors created by compileModule...
      */
     getComponentFromError(error: Error): Type<any> | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ɵTestingCompiler, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ɵTestingCompiler>;
 }
 
 /**