Skip to main content

@atomic-testing/angular-21

Adapter for integrating Atomic Testing with Angular 21. It maps standalone Angular components to the core scene part APIs.

This package is a thin re-export of @atomic-testing/angular-core that pins the Angular 21 peer range — the implementation (interactor, settling, and createTestEngine) is shared across all supported Angular majors. Using a different Angular major? Install the matching @atomic-testing/angular-* package instead.

Install​

npm install --save-dev @atomic-testing/angular-21 @atomic-testing/component-driver-html

zone.js is an optional peer: zoneless applications do not need it, and createTestEngine bootstraps zoneless automatically when it is not loaded.

Usage​

import { createTestEngine } from '@atomic-testing/angular-21';
import { HTMLButtonDriver, HTMLElementDriver } from '@atomic-testing/component-driver-html';
import { byDataTestId, ScenePart, TestEngine } from '@atomic-testing/core';

const parts = {
  increment: { locator: byDataTestId('increment'), driver: HTMLButtonDriver },
  count: { locator: byDataTestId('count'), driver: HTMLElementDriver },
} satisfies ScenePart;

let engine: TestEngine<typeof parts>;

beforeEach(async () => {
  // Angular bootstrapping is asynchronous — await the engine.
  engine = await createTestEngine(CounterComponent, parts);
});

afterEach(() => engine.cleanUp());

it('increments', async () => {
  await engine.parts.increment.click();
  expect(await engine.parts.count.getText()).toBe('1');
});

Interactions settle through ApplicationRef.whenStable(), so the same test passes whether the application under test runs zone-based or zoneless change detection.

Classes​

Interfaces​

Variables​

Functions​