Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

AbortSignal.aborted — consultar o estado de cancelamento

AbortSignal.aborted é uma propriedade de instância só de leitura. Devolve true quando o sinal foi cancelado, ou false caso contrário. Permite consultar o estado atual, mas não cancela uma operação por si só.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

signal.aborted

AbortSignal.aborted é uma propriedade de instância de AbortSignal, lida como signal.aborted, sem parênteses. Devolve um valor booleano: false se o sinal não tiver sido cancelado, ou true se tiver sido. Não é um método estático nem uma propriedade gravável.

Podes obter um sinal através de controller.signal, em que controller é uma instância de AbortController. A chamada a controller.abort() define o estado de cancelamento; uma leitura posterior de signal.aborted devolve true. Um sinal cancelado não pode voltar ao estado inicial — utiliza um novo controlador para uma nova operação independente.

A leitura da propriedade não interrompe o trabalho, não lança uma exceção nem regista notificações. Uma operação tem de suportar o sinal fornecido, ou o teu código tem de reagir ao respetivo estado. false não significa que a operação tenha sido bem-sucedida. Para reagir a um cancelamento posterior, utiliza o evento abort; tem também em conta o caso em que o sinal já tenha sido cancelado antes do registo do listener.

Esta é uma API Web definida pela norma DOM, não uma funcionalidade de uma edição específica de ECMAScript. A MDN indica uma ampla disponibilidade nos navegadores desde abril de 2018, incluindo em Web Workers. A presença de Node 24 num repositório não comprova o suporte nos navegadores de destino.

Exemplos

const controller = new AbortController();
const signal = controller.signal;

console.log(signal.aborted);
controller.abort();
console.log(signal.aborted);

Resultado

false
true

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes