Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
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 lesWeb Workers.
La propriété en lecture seuledestination de l'interfaceRequest retourne une chaîne de caractères décrivant le type de contenu demandé.
La chaîne doit être soitaudio,audioworklet,document,embed,fencedframe,font,frame,iframe,image,json,manifest,object,paintworklet,report,script,sharedworker,speculationrules,style,track,video,worker ouxslt, ou la chaîne vide, qui est la valeur par défaut.
La propriétédestination est utilisée parl'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 surWorklet (y compris les sous-classes commeAudioWorklet), et les destinations basées surWorker, y comprisServiceWorker etSharedWorker.
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 uncadre 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.
"sharedworker"La cible est un shared worker.
"speculationrules"ExpérimentalLa cible est un document JSON derè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 constructeurRequest() (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éfautSpécifications
| Specification |
|---|
| Fetch # ref-for-dom-request-destination① |