Cookies concent notice

This site uses cookies from Google to deliver its services and to analyze traffic.
Learn more
Skip to main content
This site is no longer updated.Head to Angular.devHome
/

This is the archived documentation for Angular v17. Please visit angular.dev to see this page for the current version of Angular.

Testability

The Testability service provides testing hooks that can be accessed from the browser.

See more...

      
      class Testability implements PublicTestability {
increasePendingRequestCount(): number
decreasePendingRequestCount(): number
isStable(): boolean
whenStable(doneCb: Function, timeout?: number, updateCb?: Function): void
getPendingRequestCount(): number
findProviders(using: any, provider: string, exactMatch: boolean): any[] }

Description

Angular applications bootstrapped using an NgModule (via @NgModule.bootstrap field) will also instantiate Testability by default (in both development and production modes).

For applications bootstrapped using the bootstrapApplication function, Testability is not included by default. You can include it into your applications by getting the list of necessary providers using the provideProtractorTestingSupport() function and adding them into the options.providers array. Example:

      
      import {provideProtractorTestingSupport} from '@angular/platform-browser';

await bootstrapApplication(RootComponent, providers: [provideProtractorTestingSupport()]);
    

Methods

Increases the number of pending request

      
      increasePendingRequestCount(): number
    

Deprecated pending requests are now tracked with zones.

Parameters

There are no parameters.

Returns

number

Decreases the number of pending request

      
      decreasePendingRequestCount(): number
    

Deprecated pending requests are now tracked with zones

Parameters

There are no parameters.

Returns

number

Whether an associated application is stable

      
      isStable(): boolean
    
Parameters

There are no parameters.

Returns

boolean

Wait for the application to be stable with a timeout. If the timeout is reached before that happens, the callback receives a list of the macro tasks that were pending, otherwise null.

      
      whenStable(doneCb: Function, timeout?: number, updateCb?: Function): void
    
Parameters
doneCb Function

The callback to invoke when Angular is stable or the timeout expires whichever comes first.

timeout number

Optional. The maximum time to wait for Angular to become stable. If not specified, whenStable() will wait forever.

Optional. Default is undefined.

updateCb Function

Optional. If specified, this callback will be invoked whenever the set of pending macrotasks changes. If this callback returns true doneCb will not be invoked and no further updates will be issued.

Optional. Default is undefined.

Returns

void

Get the number of pending requests

      
      getPendingRequestCount(): number
    

Deprecated pending requests are now tracked with zones

Parameters

There are no parameters.

Returns

number

Find providers by name

      
      findProviders(using: any, provider: string, exactMatch: boolean): any[]
    
Parameters
using any

The root element to search from

provider string

The name of binding variable

exactMatch boolean

Whether using exactMatch

Returns

any[]