timdeschryver · Oct 9, 2026 · Oct 9, 2026
diff --git a/docs/angular-testing-library/api.mdx b/docs/angular-testing-library/api.mdx
@@ -231,6 +231,9 @@ await render(FixtureComponent, {
 })
 ```
 
+To set the state of specific deferrable blocks, pass an array of
+`{deferBlockState, deferBlockIndex}` objects instead.
+
 ### `componentProviders`
 
 A collection of providers needed to render the component via Dependency
@@ -433,6 +436,25 @@ await render(AppComponent, {
 })
 ```
 
+### `initialRoute`
+
+Specifies which route should be initially navigated to. Use it together with
+[`routes`](#routes).
+
+**default** : `''`
+
+**example**:
+
+```typescript
+await render(AppComponent, {
+  initialRoute: 'myroute',
+  routes: [
+    {path: '', component: HomeComponent},
+    {path: 'myroute', component: SecondaryComponent},
+  ],
+})
+```
+
 ### `schemas`
 
 A collection of schemas needed to render the component. Allowed values are
@@ -465,6 +487,39 @@ await render(AppComponent, {
 })
 ```
 
+### `configureTestBed`
+
+A callback to configure the `TestBed` before the components are compiled. Use
+it for `TestBed` configuration that isn't covered by the other options.
+
+**default** : `() => {}`
+
+**example**:
+
+```typescript
+await render(AppComponent, {
+  configureTestBed: testBed => {
+    testBed.overrideProvider(AppService, {useValue: appServiceMock})
+  },
+})
+```
+
+### `wrapper`
+
+Only available when rendering a [`template`](#template). The Angular component
+to wrap the template in, its template is overridden with the provided
+`template`. A standalone component cannot be used as a wrapper.
+
+**default** : `WrapperComponent`, an empty non-standalone component
+
+**example**:
+
+```typescript
+await render('<div appSpoiler></div>', {
+  declarations: [SpoilerDirective],
+  wrapper: CustomWrapperComponent,
+})
+```
 
 ### ~~`componentInputs`~~ (deprecated)
 
@@ -500,7 +555,7 @@ await render(AppComponent, {
 })
 ```
 
-### ~~`componentProperties`~~ (deprecated)
+### `componentProperties`
 
 An object to set `@Input` and `@Output` properties of the component. Doesn't
 have a fine-grained control as `inputs` and `on`.
@@ -620,7 +675,8 @@ const componentInstance = fixture.componentInstance
 
 Accepts a DOM element or a path as parameter. If an element is passed,
 `navigate` will navigate to the `href` value of the element. If a path is
-passed, `navigate` will navigate to the path.
+passed, `navigate` will navigate to the path. An optional second parameter,
+`basePath`, is prepended to the `href` or path.
 
 ```typescript
 const { navigate } = await render(AppComponent, {
@@ -668,3 +724,34 @@ expect(screen.getByText(/loading/i)).toBeInTheDocument()
 await renderDeferBlock(DeferBlockState.Complete)
 expect(screen.getByText(/completed/i)).toBeInTheDocument()
 ```
+
+When the component contains multiple deferrable blocks, pass the index of the
+block as the second argument, for example
+`renderDeferBlock(DeferBlockState.Complete, 1)`.
+
+## `configure`
+
+Sets the global configuration that is used by every `render` call. It accepts a
+partial configuration object, or a callback that receives the current
+configuration and returns the new one.
+
+- `dom`: the
+  [DOM Testing Library configuration](dom-testing-library/api-configuration.mdx)
+- `defaultImports`: imports that are added to the `imports` of every `render`
+- `excludeComponentDeclaration`: the default value of the
+  [`excludeComponentDeclaration`](#excludecomponentdeclaration) render option
+
+```typescript
+import {configure} from '@testing-library/angular'
+
+configure({
+  defaultImports: [NoopAnimationsModule],
+  dom: {testIdAttribute: 'data-test'},
+})
+
+// or, based on the current configuration
+configure(config => ({
+  ...config,
+  defaultImports: [...(config.defaultImports ?? []), NoopAnimationsModule],
+}))
+```
diff --git a/docs/angular-testing-library/zoneless.mdx b/docs/angular-testing-library/zoneless.mdx
@@ -0,0 +1,119 @@
+---
+id: zoneless
+title: Zoneless
+---
+
+For zoneless applications, Angular Testing Library provides a dedicated slim
+entry point.
+
+```typescript
+import {render, screen} from '@testing-library/angular/zoneless'
+```
+
+Compared to the main entry point, this `render` doesn't set up zone-based change
+detection. The `fireEvent`, `findBy` and `waitFor` re-exports from
+`DOM Testing Library` aren't patched to trigger a change detection cycle,
+instead, Angular's zoneless scheduler takes care of running change detection.
+Because this happens asynchronously, use the `findBy` queries or `waitFor` to
+wait for updates that aren't the result of a user interaction, for example when
+a signal is updated from within the test.
+
+## Migrating existing tests
+
+A schematic is available to migrate the imports of existing tests:
+
+```bash
+ng generate @testing-library/angular:migrate-to-zoneless
+```
+
+## `render`
+
+Just like the main entry point, `render` accepts a component's type or a
+template, but it supports a reduced set of options.
+
+```typescript
+await render(AppComponent)
+
+await render('<app-component [value]="value()" />', {
+  imports: [AppComponent],
+  wrapperProperties: {value: signal(47)},
+})
+```
+
+### Options
+
+The following options work the same as in the
+[main API](angular-testing-library/api.mdx):
+
+- [`queries`](angular-testing-library/api.mdx#queries)
+- [`providers`](angular-testing-library/api.mdx#providers)
+- [`configureTestBed`](angular-testing-library/api.mdx#configuretestbed)
+- [`bindings`](angular-testing-library/api.mdx#bindings) (component only)
+- [`importOverrides`](angular-testing-library/api.mdx#importoverrides)
+  (component only)
+- [`imports`](angular-testing-library/api.mdx#imports) and
+  [`wrapper`](angular-testing-library/api.mdx#wrapper) (template only)
+
+Additionally, the zoneless entry point adds the following options.
+
+#### `skipDetectChanges`
+
+Skips the initial `fixture.detectChanges()` after the component is created. The
+initial render then only happens when Angular schedules a change detection
+cycle, so wait for it, for example with a `findBy` query.
+
+**default** : `false`
+
+**example**:
+
+```typescript
+await render(AppComponent, {skipDetectChanges: true})
+
+expect(await screen.findByText('Hello world')).toBeInTheDocument()
+```
+
+#### `waitForStableOnRender`
+
+Awaits `fixture.whenStable()` after the component is rendered.
+
+**default** : `false`
+
+**example**:
+
+```typescript
+await render(AppComponent, {waitForStableOnRender: true})
+```
+
+#### `wrapperProperties`
+
+Only available when rendering a template. An object with properties to set on
+the wrapper component instance, which can be used in the template. Pass a signal
+to update the template from within the test.
+
+**default** : `undefined`
+
+**example**:
+
+```typescript
+const value = signal(10)
+const valueUpdated = jest.fn()
+
+await render(
+  '<app-counter [value]="value()" (valueUpdated)="valueUpdated($event)" />',
+  {
+    imports: [CounterComponent],
+    wrapperProperties: {value, valueUpdated},
+  },
+)
+
+value.set(20)
+expect(await screen.findByText('20')).toBeInTheDocument()
+```
+
+### Result
+
+`render` returns the [queries](angular-testing-library/api.mdx#queries) bound to
+the component, together with
+[`container`](angular-testing-library/api.mdx#container),
+[`debug`](angular-testing-library/api.mdx#debug) and
+[`fixture`](angular-testing-library/api.mdx#fixture).
diff --git a/sidebars.js b/sidebars.js
@@ -124,6 +124,7 @@ module.exports = {
             'angular-testing-library/intro',
             'angular-testing-library/examples',
             'angular-testing-library/api',
+            'angular-testing-library/zoneless',
             'angular-testing-library/version-compatibility',
             'angular-testing-library/faq',
           ],