@angular/core

provideExperimentalZonelessChangeDetection

function

Experimental

Provides change detection without ZoneJS for the application bootstrapped using bootstrapApplication.

  
    function provideExperimentalZonelessChangeDetection(  ): EnvironmentProviders;

Provides change detection without ZoneJS for the application bootstrapped using bootstrapApplication.

This function allows you to configure the application to not use the state/state changes of ZoneJS to schedule change detection in the application. This will work when ZoneJS is not present on the page at all or if it exists because something else is using it (either another Angular application which uses ZoneJS for scheduling or some other library that relies on ZoneJS).

This can also be added to the TestBed providers to configure the test environment to more closely match production behavior. This will help give higher confidence that components are compatible with zoneless change detection.

ZoneJS uses browser events to trigger change detection. When using this provider, Angular will instead use Angular APIs to schedule change detection. These APIs include:

ChangeDetectorRef.markForCheck
ComponentRef.setInput
updating a signal that is read in a template
when bound host or template listeners are triggered
attaching a view that was marked dirty by one of the above
removing a view
registering a render hook (templates are only refreshed if render hooks do one of the above)

          bootstrapApplication(MyApp, {providers: [  provideExperimentalZonelessChangeDetection(),]});

This API is experimental. Neither the shape, nor the underlying behavior is stable and can change in patch versions. There are known feature gaps and API ergonomic considerations. We will iterate on the exact API based on the feedback and our understanding of the problem and solution space.