Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

En-tête Speculation-Rules

Disponibilité limitée

Cette fonctionnalité n'est pas Compatible car elle ne fonctionne pas dans certains des navigateurs les plus utilisés.

Vous voulez une meilleure prise en charge pour cette fonctionnalité ? Dites-nous pourquoi.

Expérimental: Il s'agit d'une technologie expérimentale.
Vérifiez attentivement le tableau de compatibilité des navigateurs avant de l'utiliser en production.

L'en-tête de réponse HTTP Speculation-Rules fournit une ou plusieurs URL pointant vers des ressources textuelles contenant des définitions JSON de règles de spéculation. Lorsque la réponse est un document HTML, ces règles sont ajoutées à l'ensemble des règles de spéculation du document. Voir l'API Speculation Rules pour plus d'informations.

Le fichier de ressource contenant les règles de spéculation au format JSON peut avoir n'importe quel nom et extension valides, mais il est demandé avec un type destination de speculationrules, et doit être servi avec un type MIME application/speculationrules+json.

Note : Ce mécanisme fournit une alternative à la définition de la définition JSON à l'intérieur d'un élément en incise <script type="speculationrules">. Définir un en-tête HTTP est utile dans les cas où les développeur·euse·s ne peuvent pas modifier directement le document lui-même.

Type d'en-tête En-tête de réponse

Syntaxe

http
Speculation-Rules: <url-list>

Directives

<url-list>

Une liste d'URL séparées par des virgules pointant vers des ressources textuelles contenant des définitions JSON de règles de spéculation. Le JSON contenu dans les fichiers texte doit suivre les mêmes règles que celui contenu à l'intérieur des éléments en incise <script type="speculationrules">. Voir Représentation JSON des règles de spéculation pour la référence de syntaxe.

Exemples

Champ Speculation-Rules avec un seul fichier

La réponse suivante contient une référence à un fichier :

http
Speculation-Rules: "/rules/prefetch.json"

Champ Speculation-Rules avec plusieurs fichiers

La réponse suivante contient plusieurs références de fichiers sous forme de liste séparée par des virgules :

http
Speculation-Rules: "/rules/prefetch.json","/rules/prerender.json"

Note : Les valeurs des URL doivent être contenues entre guillemets.

Spécifications

Spécification
HTML
# the-speculation-rules-header

Compatibilité des navigateurs

Voir aussi