---
title: "Um timeout que não cancela nada"
url: "https://www.mikefluff.com/pt/experiments/js-ch12-cancel-race"
locale: "pt"
author: "Mikhail Savchenko (Mike Fluff)"
updated: "2026-11-18"
description: "Cancelar uma promise com AbortController e AbortSignal.timeout"
book: "https://www.mikefluff.com/pt/books/from-closures-to-autonomous-systems"
alternates:
  - locale: "en"
    url: "https://www.mikefluff.com/en/experiments/js-ch12-cancel-race"
    markdown: "https://www.mikefluff.com/en/experiments/js-ch12-cancel-race.md"
  - locale: "ru"
    url: "https://www.mikefluff.com/ru/experiments/js-ch12-cancel-race"
    markdown: "https://www.mikefluff.com/ru/experiments/js-ch12-cancel-race.md"
  - locale: "pt"
    url: "https://www.mikefluff.com/pt/experiments/js-ch12-cancel-race"
    markdown: "https://www.mikefluff.com/pt/experiments/js-ch12-cancel-race.md"
  - locale: "es"
    url: "https://www.mikefluff.com/es/experiments/js-ch12-cancel-race"
    markdown: "https://www.mikefluff.com/es/experiments/js-ch12-cancel-race.md"
---

# Um timeout que não cancela nada

*Cancelar uma promise com AbortController e AbortSignal.timeout*

## Promise.race cancela a promise que perdeu?

Não. Promise.race se resolve com a primeira promise que terminar e ignora as outras, mas não tem como pará-las. Uma promise só representa um resultado; o trabalho por trás dela, seja um timer, uma requisição de rede ou uma gravação no banco, continua até acabar. Para parar o trabalho, o código que o executa precisa aceitar um sinal de cancelamento. Em JavaScript esse sinal é o AbortSignal de um AbortController, ou AbortSignal.timeout(ms), que dispara sozinho depois do tempo dado. A função precisa escutar o evento abort ou verificar signal.aborted e arrumar o que deixou pela metade.

O jeito mais comum de dar um prazo a uma chamada assíncrona é um Promise.race contra um timer. Quando o timer ganha, quem chamou para de esperar, e a operação que ele esperava continua rodando, porque ninguém mandou parar. No experimento uma operação lenta grava um registro no banco depois de 500 ms, e quem a chama espera no máximo 100 ms.

Aperte “Executar” na aba Promise.race. A escala é preenchida pelos timers reais do navegador: quem chamou recebe o erro perto dos 100 ms, e a operação segue e grava o registro perto dos 500 ms. Aperte mais algumas vezes, como um cliente que ouviu que deu errado, e veja o número de registros crescer enquanto cada resposta diz “não deu certo”. Na aba AbortSignal a operação recebe AbortSignal.timeout(100), cancela o próprio timer e não grava nada.

No livro, no Node 24, quem chamou recebeu “timeout” aos 102 ms e o registro foi gravado mesmo assim aos 501 ms. Com AbortSignal.timeout(100) a operação parou aos 103 ms. No seu navegador os números vão variar alguns milissegundos, conforme o motor e o que mais a aba está fazendo.

Depois que async/await tornou o código assíncrono legível, diz o capítulo, sobraram três perguntas sobre o tempo, e esta é a primeira: como parar um trabalho que não é mais necessário. O cancelamento veio do navegador, como AbortController no padrão DOM, e o Node adotou o mesmo desenho. Ele só funciona se o sinal for passado à mão para cada função da cadeia e cada função o verificar.

_A página tem um experimento interativo que roda no navegador: https://www.mikefluff.com/pt/experiments/js-ch12-cancel-race_

## Fontes

- [MDN: Promise.race()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/race)
- [MDN: AbortSignal.timeout()](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal/timeout_static)
- [MDN: AbortController](https://developer.mozilla.org/en-US/docs/Web/API/AbortController)

## Do livro

Ao lado dele no livro:

> 102 ms o chamador recebeu erro: timeout, o cliente ouviu "não deu certo" 501 ms a operação gravou o registro no banco Disseram ao cliente que nada deu certo, e quatrocentos milissegundos depois o registro apareceu assim mesmo. O cliente provavelmente vai apertar o botão de novo, e o registro vai aparecer pela segunda vez. O Promise.race parou de esperar, mas ninguém parou a operação em si. Na segunda variante a operação recebe o sinal AbortSignal.timeout(100) e, no centésimo terceiro milissegundo, interrompe o trabalho sozinha, e nada chega ao banco.

- Ler o capítulo: [Capítulo 12. O tempo como parte do programa](https://www.mikefluff.com/pt/read/from-closures-to-autonomous-systems/ch12) (início livre, o resto no livro completo; Markdown: https://www.mikefluff.com/pt/read/from-closures-to-autonomous-systems/ch12.md)

- Livro: [JavaScript: das closures aos sistemas autônomos](https://www.mikefluff.com/pt/books/from-closures-to-autonomous-systems)
