From b34e48bdff41e707ad4abfa7b9e024db48e75cc8 Mon Sep 17 00:00:00 2001
From: Matthieu Riegler <kyro38@gmail.com>
Date: Mon, 24 Nov 2025 20:10:28 +0200
Subject: [PATCH] docs: add callout on zone base testing helpers

With zoneless being the default, we need to make these requirements more explicit.

fixes #65539
---
 packages/core/testing/src/fake_async.ts | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/packages/core/testing/src/fake_async.ts b/packages/core/testing/src/fake_async.ts
index 0aad49d7078..b14d35bfc6a 100644
--- a/packages/core/testing/src/fake_async.ts
+++ b/packages/core/testing/src/fake_async.ts
@@ -24,6 +24,8 @@ function withFakeAsyncTestModule(fn: (fakeAsyncTestModule: any) => any): any {
 }
 
 /**
+ * IMPORTANT: This API requires Zone.js
+ *
  * Clears out the shared fake async zone for a test.
  * To be called in a global `beforeEach`.
  *
@@ -40,6 +42,8 @@ export function resetFakeAsyncZoneIfExists(): void {
 }
 
 /**
+ * IMPORTANT: This API requires Zone.js
+ *
  * Wraps a function to be executed in the `fakeAsync` zone:
  * - Microtasks are manually executed by calling `flushMicrotasks()`.
  * - Timers are synchronous; `tick()` simulates the asynchronous passage of time.
@@ -68,6 +72,8 @@ export function fakeAsync(fn: Function, options?: {flush?: boolean}): (...args:
 }
 
 /**
+ * IMPORTANT: This API requires Zone.js
+ *
  * Simulates the asynchronous passage of time for the timers in the `fakeAsync` zone.
  *
  * The microtasks queue is drained at the very start of this function and after any timer callback
@@ -141,6 +147,8 @@ export function tick(
 }
 
 /**
+ * IMPORTANT: This API requires Zone.js
+ *
  * Flushes any pending microtasks and simulates the asynchronous passage of time for the timers in
  * the `fakeAsync` zone by
  * draining the macrotask queue until it is empty.
@@ -156,6 +164,8 @@ export function flush(maxTurns?: number): number {
 }
 
 /**
+ * IMPORTANT: This API requires Zone.js
+ *
  * Discard all remaining periodic tasks.
  *
  * @publicApi
@@ -165,6 +175,8 @@ export function discardPeriodicTasks(): void {
 }
 
 /**
+ * IMPORTANT: This API requires Zone.js
+ *
  * Flush any pending microtasks.
  *
  * @publicApi