Slide 1

Slide 1 text

Zoneless Testing Rainer Hahnekamp 6. December 2024

Slide 2

Slide 2 text

About Me... https://www.youtube.com/ @RainerHahnekamp https://www.ng-news.com https://github.com/softarc-consulting/sheriff ● Rainer Hahnekamp ANGULARarchitects.io NgRx Team (Trusted Collaborator) ● Developer / Trainer / Speaker @RainerHahnekamp Workshops NgRx • Testing • Spring • Quality

Slide 3

Slide 3 text

RainerHahnekamp Why a talk on experimental features??? Critical for some apps Future-proof tests

Slide 4

Slide 4 text

RainerHahnekamp Change Detection with zone.js

Slide 5

Slide 5 text

RainerHahnekamp Zone.js triggers Change Detection Component Tree DOM Submit Cancel Zone.js Handled DOM Events Asynchronous Tasks

Slide 6

Slide 6 text

Component Tree DOM Submit Cancel Change Detection (DOM and Components in Sync)

Slide 7

Slide 7 text

Component Tree DOM Submit Cancel Change Detection (Component's value changes)

Slide 8

Slide 8 text

Component Tree DOM Submit Cancel Change Detection (Detecting Changes...)

Slide 9

Slide 9 text

Component Tree DOM Submit Cancel Change Detection (Detecting Changes...) ✅

Slide 10

Slide 10 text

Component Tree DOM Submit Cancel Change Detection (Detecting Changes...) ✅

Slide 11

Slide 11 text

Component Tree DOM Submit Cancel Change Detection (Detecting Changes...) ✅ ✅

Slide 12

Slide 12 text

Component Tree DOM Submit Cancel Change Detection (Detecting Changes...) ✅ ✅

Slide 13

Slide 13 text

Component Tree DOM Submit Cancel Change Detection (Detecting Changes...) ✅ ✅ ✅

Slide 14

Slide 14 text

Component Tree DOM Submit Cancel Change Detection (Detecting Changes...) ✅ ✅ ✅

Slide 15

Slide 15 text

Component Tree DOM Submit Cancel Change Detection (Detecting Changes...) ✅ ✅ ✅

Slide 16

Slide 16 text

Component Tree DOM Submit Cancel Change Detection (Detecting Changes...) ✅ ✅ ✅

Slide 17

Slide 17 text

Component Tree DOM Submit Cancel Change Detection (Detecting Changes...) ✅ ✅ ✅ ✅

Slide 18

Slide 18 text

Component Tree DOM Submit Cancel Change Detection (Updating DOM) ✅ ✅ ✅ ✅

Slide 19

Slide 19 text

Component Tree DOM Submit Cancel Change Detection (Updating DOM) ✅ ✅ ✅ ✅ ✅

Slide 20

Slide 20 text

Component Tree DOM Submit Cancel Change Detection (Updating DOM) ✅ ✅ ✅ ✅ ✅

Slide 21

Slide 21 text

Component Tree DOM Submit Cancel Change Detection (Updating DOM) ✅ ✅ ✅ ✅ ✅ ✅

Slide 22

Slide 22 text

RainerHahnekamp Change Detection without zone.js

Slide 23

Slide 23 text

Component Tree DOM Submit Cancel Zoneless Change Detection Zone.js

Slide 24

Slide 24 text

Component Tree DOM Submit Cancel Zoneless Change Detection Zone.js

Slide 25

Slide 25 text

Component Tree DOM Submit Cancel Zoneless Change Detection (Change happens)

Slide 26

Slide 26 text

Component Tree DOM Submit Cancel Zoneless Change Detection ("Somebody/-thing calls markForCheck()) markForCheck()

Slide 27

Slide 27 text

Component Tree DOM Submit Cancel Zoneless Change Detection (markForCheck triggers CD) markForCheck()

Slide 28

Slide 28 text

Component Tree DOM Submit Cancel Zoneless Change Detection (Checkend & Done) ✅ ✅ ✅ ✅ ✅ ✅

Slide 29

Slide 29 text

RainerHahnekamp Criteria markForCheck Handled DOM Events async Pipe Signal Change manually via markForCheck

Slide 30

Slide 30 text

RainerHahnekamp A First Test 1/5

Slide 31

Slide 31 text

RainerHahnekamp A First Test 2/5

Slide 32

Slide 32 text

RainerHahnekamp A First Test 3a/5 // setup const fixture = TestBed.configureTestingModule({ providers: [ provideExperimentalZonelessChangeDetection(), provideHttpClient(), provideHttpClientTesting() }).createComponent(QuizComponent); fixture.componentRef.setInput('id', 1); fixture.autoDetectChanges(true)

Slide 33

Slide 33 text

RainerHahnekamp A First Test 3a/5 // setup const fixture = TestBed.configureTestingModule({ providers: [ provideExperimentalZonelessChangeDetection(), provideHttpClient(), provideHttpClientTesting(), {provide: ComponentFixtureAutoDetect, useValue: false} ], }).createComponent(QuizComponent); fixture.componentRef.setInput('id', 1); fixture.autoDetectChanges(true) Automatic Change Detection enabled in zoneless

Slide 34

Slide 34 text

RainerHahnekamp A First Test 3b/5 // setup TestBed.configureTestingModule({ providers: [ provideExperimentalZonelessChangeDetection(), provideHttpClient(), provideHttpClientTesting(), provideRouter( [{ path: 'quiz/:id', component: QuizComponent }], withComponentInputBinding(), ), provideLocationMocks(), ], }); const { fixture } = await RouterTestingHarness.create('/quiz/1');

Slide 35

Slide 35 text

RainerHahnekamp A First Test 4/5 // setup... // init const httpClient = TestBed.inject(HttpTestingController); const req = httpClient.expectOne('/holiday/1/quiz'); req.flush(createQuiz(1)); await fixture.whenStable();

Slide 36

Slide 36 text

RainerHahnekamp A First Test 5/5 // setup... // init... // execution const question = screen.getByLabelText('question'); const status = screen.getByLabelText('quiz-status'); expect(within(status).getByText('Correct: 0')).toBeTruthy(); expect( within(question).getByText( 'What programming language is Angular written in?', ), ).toBeTruthy(); within(question).getByRole('button', { name: 'TypeScript' }).click(); await fixture.whenStable(); expect(within(status).getByText('Correct: 1')).toBeTruthy();

Slide 37

Slide 37 text

RainerHahnekamp Major Pitfalls markForCheck Mutable Property Binding Asynchronous Tasks

Slide 38

Slide 38 text

RainerHahnekamp Asynchronous Tasks is a problem? What about fakeAsync() or waitForAsync() 🤨

Slide 39

Slide 39 text

RainerHahnekamp Dealing with asynchronous Tasks ComponentFixture ::whenStable

Slide 40

Slide 40 text

RainerHahnekamp Dealing with asynchronous Tasks ComponentFixture ::whenStable PendingTasks

Slide 41

Slide 41 text

RainerHahnekamp PendingTasks ✅ Official Solution ● (rx)resource() ✅ Required for SSR ✅ Empowers ComponentFixture::whenStable ⛔ Not a good DX ● Overhead ⛔ Timeouts are real ● Slow Tests ⛔ Issues with third-party Libraries

Slide 42

Slide 42 text

RainerHahnekamp Dealing with asynchronous Tasks ComponentFixture ::whenStable PendingTasks Stubs & Fakes

Slide 43

Slide 43 text

RainerHahnekamp Stub Example // implementation @Injectable({providedIn: 'root'}) export class Clock { setTimeout(fn: () => void, timeout: number) { setTimeout(fn, timeout) } } // stub TestBed.configureTestingModule({ providers: [ // ... { provide: Clock, useValue: { setTimeout: (fn: () => void) => fn() } }, ], });

Slide 44

Slide 44 text

RainerHahnekamp Minimal Fake Example export class Clock { readonly #tasks = new Map void>(); schedule(task: () => void, timeout: number) { const timeoutId = window.setTimeout(() => { task(); this.#tasks.delete(timeoutId) }, timeout); this.#tasks.set(timeout, task) } flushAll() { for (const taskId of this.#tasks.keys()) { clearTimeout(taskId) const task = this.#tasks.get(taskId); assertDefined(task); task(); } } }

Slide 45

Slide 45 text

RainerHahnekamp Dealing with asynchronous Tasks ComponentFixture ::whenStable PendingTasks Testing Framework Stubs & Fakes

Slide 46

Slide 46 text

RainerHahnekamp jasmine.clock it('should show the next button', async () => { const { fixture, question } = await setup(); const clock = jasmine.clock(); clock.install() within(question).getByRole('button', { name: 'TypeScript' }).click(); clock.tick(1000) await fixture.whenStable() });

Slide 47

Slide 47 text

RainerHahnekamp Testing Framework Features ● https://github.com/jasmine/jasmine/pull/2042 ● https://github.com/jestjs/jest/pull/15300

Slide 48

Slide 48 text

RainerHahnekamp

Slide 49

Slide 49 text

RainerHahnekamp

Slide 50

Slide 50 text

RainerHahnekamp Dealing with asynchronous Tasks ComponentFixture ::whenStable PendingTasks Testing Framework Cypress CT Stubs & Fakes

Slide 51

Slide 51 text

RainerHahnekamp ✅ No Quarrels with ● Change Detection ● DOM Events ● Asynchronous Tasks ✅ Superior DX ⛔ Real Timeout ⛔ Third-Party Library ⛔ No Unit or Service Tests Cypress Component Testing

Slide 52

Slide 52 text

RainerHahnekamp Summary ● Zoneless & Testing is easier than you might think ● Careful about asynchronous tasks ● It is still experimental, i.e. up for change ● Always test as close to the real world as possible

Slide 53

Slide 53 text

RainerHahnekamp Farewell waitForAsync() and fakeAsync() Embrace ComponentFixture::whenStable