Request : propriété signal
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis mars 2019.
Note : Cette fonctionnalité est disponible via les Web Workers.
La propriété en lecture seule signal de l'interface Request retourne l'objet AbortSignal associé à la requête.
Valeur
Un objet AbortSignal.
Exemples
js
// Créer un nouveau contrôleur d'annulation
const controleur = new AbortController();
// Créer une requête avec l'objet AbortSignal de ce contrôleur
const requete = new Request("/", { signal: controleur.signal });
// Ajouter un gestionnaire d'évènement qui affiche un message en cas d'annulation
requete.signal.addEventListener("abort", () => {
console.log("annulation");
});
// En cas d'annulation, afficher la raison de l'AbortSignal, si elle existe
fetch(requete).catch(() => {
if (requete.signal.aborted) {
if (requete.signal.reason) {
console.log(`Requête annulée avec la raison : ${requete.signal.reason}`);
} else {
console.log("Requête annulée mais aucune raison n'a été fournie.");
}
} else {
console.log("Requête terminée de façon anormale, sans annulation.");
}
});
// Annuler effectivement la requête
controleur.abort();
Spécifications
| Specification |
|---|
| Fetch # ref-for-dom-request-signal② |