CKTIS / JavaScript
AbortSignal.aborted — lire l’état d’annulation
AbortSignal.aborted est une propriété d’instance en lecture seule. Elle renvoie true lorsque le signal a été annulé, et false dans le cas contraire. Elle permet d’examiner l’état actuel, mais n’annule pas elle-même une opération.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
signal.abortedAbortSignal.aborted désigne une propriété d’instance de AbortSignal, lue sous la forme signal.aborted, sans parenthèses. Elle renvoie un booléen : false si le signal n’a pas été annulé, ou true s’il l’a été. Ce n’est ni une méthode statique ni une propriété modifiable.
Tu peux obtenir un signal avec controller.signal, où controller est une instance d’AbortController. L’appel de controller.abort() définit l’état d’annulation ; une lecture ultérieure de signal.aborted renvoie true. Un signal annulé ne peut pas retrouver son état initial : utilise un nouveau contrôleur pour une nouvelle opération indépendante.
Lire cette propriété n’interrompt pas le travail, ne déclenche pas d’exception et n’enregistre pas de notifications. Une opération doit prendre en charge le signal fourni, ou ton code doit réagir à son état. false ne signifie pas que l’opération a réussi. Pour réagir à une annulation ultérieure, utilise l’événement abort ; tiens aussi compte du cas où le signal a déjà été annulé avant l’enregistrement de l’écouteur.
Il s’agit d’une API Web définie par la norme DOM, et non d’une fonctionnalité d’une édition particulière d’ECMAScript. MDN indique qu’elle est largement prise en charge par les navigateurs depuis avril 2018, y compris dans les Web Workers. La présence de Node 24 dans un dépôt ne prouve pas que les navigateurs ciblés la prennent en charge.
Exemples
const controller = new AbortController();
const signal = controller.signal;
console.log(signal.aborted);
controller.abort();
console.log(signal.aborted);Résultat
false true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.