Request : propriété keepalive
Baseline
2024
Newly available
Depuis November 2024, cette fonctionnalité fonctionne sur les appareils et les versions de navigateur les plus récents. Elle peut ne pas fonctionner sur les appareils ou navigateurs plus anciens.
Note : Cette fonctionnalité est disponible via les Web Workers.
La propriété en lecture seule keepalive de l'interface Request contient le paramètre keepalive de la requête (true ou false), qui indique si le navigateur va maintenir la requête associée active si la page qui l'a initiée est déchargée avant que la requête soit terminée.
Cela permet à une requête fetch() d'envoyer, par exemple, des données d'analyse à la fin d'une session même si l'utilisateur·ice quitte ou ferme la page.
Cela présente certains avantages par rapport à l'utilisation de Navigator.sendBeacon() pour le même objectif, notamment la possibilité d'utiliser des méthodes HTTP autres que POST, de personnaliser les propriétés de la requête, et d'accéder à la réponse du serveur via la résolution de la promesse (Promise).
Valeur
Une valeur booléenne indiquant le statut keepalive de la requête.
Exemples
Créer une requête avec keepalive
Dans l'extrait suivant, nous créons une nouvelle requête à l'aide du constructeur Request() avec keepalive défini à true, puis nous enregistrons la valeur keepalive de la requête dans une variable :
const options = {
keepalive: true,
};
const maRequete = new Request("flaurs.jpg", options);
let monKeepAlive = maRequete.keepalive; // true
Spécifications
| Specification |
|---|
| Fetch # ref-for-dom-request-keepalive② |
Compatibilité des navigateurs
Voir aussi
- L'API ServiceWorker
- Contrôle d'accès HTTP (CORS)
- La référence HTTP