Request : propriété destination
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 juin 2018.
* Certaines parties de cette fonctionnalité peuvent bénéficier de prise en charge variables.
Note : Cette fonctionnalité est disponible via les Web Workers.
La propriété en lecture seule destination de l'interface Request retourne une chaîne de caractères décrivant le type de contenu demandé.
La chaîne doit être soit audio, audioworklet, document, embed, fencedframe, font, frame, iframe, image, json, manifest, object, paintworklet, report, script, sharedworker, speculationrules, style, track, video, worker ou xslt, ou la chaîne vide, qui est la valeur par défaut.
La propriété destination est utilisée par l'agent utilisateur pour, par exemple, aider à déterminer quel ensemble de règles suivre pour le CORS, ou comment naviguer dans les chemins de code complexes qui affectent la gestion de certains types de requêtes.
Ces destinations varient considérablement dans leur fonctionnement. Certaines sont des réceptacles de données, où les données reçues sont stockées pour un traitement ultérieur. D'autres sont basées sur des scripts, auquel cas les données reçues sont transmises à un script en l'appelant et en lui passant les données.
Les destinations basées sur des scripts incluent les éléments <script>, ainsi que toutes les destinations basées sur Worklet (y compris les sous-classes comme AudioWorklet), et les destinations basées sur Worker, y compris ServiceWorker et SharedWorker.
Valeur
Une chaîne de caractères qui indique le type de contenu demandé par la requête. Ce type est bien plus large que les valeurs habituelles de type de document (comme "document" ou "manifest"), et peut inclure des indices contextuels comme "image", "worker" ou "audioworklet".
Les valeurs possibles sont :
""-
La chaîne vide est la valeur par défaut, et est utilisée pour les destinations qui n'ont pas leur propre valeur. C'est la valeur lorsque les requêtes sont effectuées avec les API suivantes (entre autres) :
"audio"-
La cible est une donnée audio.
"audioworklet"-
La cible est une donnée récupérée pour être utilisée par un audio worklet.
"document"-
La cible est un document (HTML ou XML).
"embed"-
La cible est un contenu embarqué.
"fencedframe"-
La cible est un cadre protégé.
"font"-
La cible est une police de caractères.
"image"-
La cible est une image.
"json"-
La cible est un fichier JSON.
"manifest"-
La cible est un manifeste.
"object"-
La cible est un objet.
"paintworklet"-
La cible est un paint worklet.
"report"-
La cible est un rapport.
"script"-
La cible est un script.
"serviceworker"-
La cible est un service worker.
-
La cible est un shared worker.
"speculationrules"Expérimental-
La cible est un document JSON de règles de spéculation.
"style"-
La cible est une feuille de style.
"track"-
La cible est un élément HTML
<track>. "video"-
La cible est une donnée vidéo.
"worker"-
La cible est un worker.
"xslt"-
La cible est une transformation XSLT.
Exemples
Dans l'extrait de code suivant, nous créons une nouvelle requête à l'aide du constructeur Request() (pour un fichier image dans le même répertoire que le script), puis nous enregistrons la destination de la requête :
const maRequete = new Request("fleurs.jpg");
const maDestination = maRequete.destination; // retourne la chaîne vide par défaut
Spécifications
| Specification |
|---|
| Fetch # ref-for-dom-request-destination① |
Compatibilité des navigateurs
Voir aussi
- L'API ServiceWorker
- Contrôle d'accès HTTP (CORS)
- La référence HTTP