---
title: "Um checklist curto antes de testar zoneless"
description: "Um checklist de prontidão para testar Angular zoneless em uma aplicação existente sem confundir spike de compatibilidade com rollout."
deck: "Zoneless não é só remover zone.js. Em app existente, o trabalho real é descobrir quem avisa o Angular que o estado mudou. [Stable desde a v20.2 e default em projetos novos a partir da v21](https://angular.dev/guide/zoneless). Em app existente, o spike é outra conversa."
author: "André Ramos"
url: "https://andreramos.dev/pt/angular/zoneless-checklist/"
lang: "pt-BR"
type: "article"
---

# Um checklist curto antes de testar zoneless

> Zoneless não é só remover zone.js. Em app existente, o trabalho real é descobrir quem avisa o Angular que o estado mudou. [Stable desde a v20.2 e default em projetos novos a partir da v21](https://angular.dev/guide/zoneless). Em app existente, o spike é outra conversa.

## Comece com uma branch, não com uma promessa

Zoneless é a direção do Angular para novas aplicações, mas um app existente pode depender de Zone.js por padrões que nunca foram documentados. Trate a primeira tentativa como spike de compatibilidade.

O primeiro spike não é uma sprint de migração. Ele serve para encontrar telas onde timer, subscription, overlay ou widget de terceiro depende de change detection implícita há anos.

## O que inspecionar

| Área | Pergunta |
|---|---|
| Subscriptions manuais | O código atualiza campos simples sem Signal, AsyncPipe, mudança de input ou markForCheck? |
| Timers | Callbacks de setTimeout ou setInterval alteram dados lidos no template sem notificar o Angular? |
| APIs de estabilidade | Algum código espera eventos de estabilidade do NgZone ou usa isStable como gate de runtime? |
| Forms | Reactive forms e estados de validação atualizam corretamente em fluxos críticos? |
| UI de terceiros | Overlays, charts, editors e mapas assumem Zone.js? |
| Testes | O setup de testes ainda importa zone.js/testing? |

*Encontrar pontos prováveis de risco zoneless*

```bash
rg "NgZone|onStable|onUnstable|onMicrotaskEmpty|isStable|ApplicationRef|setTimeout|setInterval|subscribe\(" src
rg "zone.js|zone.js/testing|provideZoneChangeDetection|provideZonelessChangeDetection" .
```

## O que um bom spike deve entregar

Um bom spike de zoneless termina com um relatório curto: fluxos testados, falhas encontradas, dependências que assumem Zone.js, mudanças necessárias e recomendação para adotar, testar mais ou esperar.

Um relatório útil é específico: checkout passou, o overlay do gráfico falhou depois de uma mutação em timer, o pacote de editor ainda assume Zone.js e a correção estimada é mexer em dois componentes ou atualizar uma dependência.

Se a única saída é 'compilou', o spike não respondeu a pergunta de produção. Um time precisa saber o que quebrou, o que nem foi tocado e o que seria caro demais corrigir agora.

## Artefato reaproveitável: Checklist de prontidão para zoneless

- Crie uma branch isolada.
- Remova pressupostos de Zone.js apenas dentro do spike.
- Teste subscriptions manuais, timers, APIs de estabilidade, forms, overlays, charts, editors e mapas.
- Cheque polyfills de build e teste.
- Escreva uma recomendação antes de planejar rollout.

## Fontes consultadas

- https://angular.dev/guide/zoneless
- https://angular.dev/api/core/provideZonelessChangeDetection
- https://angular.dev/api/core/ChangeDetectorRef
- https://angular.dev/api/core/ChangeDetectionStrategy
- https://angular.dev/api/core/rxjs-interop/takeUntilDestroyed
- https://angular.dev/best-practices/zone-pollution
- https://blog.angular.dev/announcing-angular-v20-b5c9c06cf301
- https://blog.angular.dev/announcing-angular-v21-57946c34f14b
- https://github.com/angular/angular/discussions/66779

## Leia também

- [O código que quebra quando Angular fica zoneless](https://andreramos.dev/pt/angular/code-that-breaks-when-angular-goes-zoneless/)
- [NG0100 ExpressionChangedAfterItHasBeenCheckedError: por que ele aparece no Angular zoneless](https://andreramos.dev/pt/angular/expressionchanged-error-zoneless-angular/)
- [OnPush é o default no Angular 22: o que quebra e o que fazer](https://andreramos.dev/pt/angular/onpush-default-angular-22/)