Experimentos · JavaScript: das closures aos sistemas autônomos · Capítulo 12

Um timeout que não cancela nada

Cancelar uma promise com AbortController e AbortSignal.timeout

Tema
ExperimenteUm timeout que não cancela nada
Uma operação lenta grava um registro no banco depois de meio segundo, e quem a chama espera no máximo 100 ms. Execute as duas versões com timers de verdade: com Promise.race o cliente ouve que deu errado e o registro aparece mesmo assim; com AbortSignal a operação para sozinha.

Tudo é calculado no seu navegador; nada é enviado.

Sobre este experimento

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.

Do livro

JavaScript: das closures aos sistemas autônomos · Capítulo 12

O tempo como parte do programa

Ao lado deste experimento no capítulo
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.