HTMLScriptElement : propriété fetchPriority
Baseline
2024
Newly available
Depuis October 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.
La propriété fetchPriority de l'interface HTMLScriptElement représente une indication pour le navigateur sur la façon de prioriser la récupération d'un script externe par rapport à d'autres scripts externes.
Elle reflète l'attribut fetchpriority de l'élément HTML <script>.
Cette propriété permet à un·e développeur·euse d'indiquer que la récupération d'un script particulier tôt ou tard dans le processus de chargement a plus ou moins d'impact sur l'expérience utilisateur que ce que le navigateur peut raisonnablement déduire lors de l'attribution d'une priorité interne. Ceci permet au navigateur d'augmenter ou de diminuer la priorité, et potentiellement de charger le script plus tôt ou plus tard qu'il ne l'aurait fait autrement. La propriété doit être utilisée avec parcimonie, car une priorisation excessive ou incorrecte peut dégrader les performances.
La priorité de récupération permet de diminuer la priorité des scripts placés en fin de corps de page, ou d'augmenter la priorité des scripts async sans avoir à utiliser le préchargement.
Lorsque le chargement anticipé d'un script est important, la priorité peut être utilisée en complément du préchargement, en augmentant la priorité par rapport à des ressources moins importantes qui ont une priorité par défaut plus élevée.
Notez que la priorité interne de toute opération de récupération, ainsi que l'impact de fetchPriority sur cette priorité, dépendent entièrement du navigateur.
Valeur
Une chaîne de caractères représentant l'indication de priorité. Les valeurs possibles sont :
high-
Récupère le script externe avec une priorité élevée par rapport aux autres scripts externes.
low-
Récupère le script externe avec une priorité faible par rapport aux autres scripts externes.
auto-
Ne définit pas de préférence pour la priorité de récupération. Il s'agit de la valeur par défaut. Elle est utilisée si aucune valeur n'est définie ou si une valeur invalide est définie.
Exemples
<script id="el" type="module" src="main.js" fetchpriority="high"></script>
const el = document.getElementById("el");
console.log(el.fetchPriority); // Affiche : "high"
Spécifications
| Specification |
|---|
| HTML # dom-script-fetchpriority |
Compatibilité des navigateurs
Chargement…
Voir aussi
- La propriété
HTMLImageElement.fetchPriority - La propriété
HTMLLinkElement.fetchPriority - L'en-tête HTTP
Link - Optimiser le chargement des ressources avec l'API Fetch Priority (angl.) pour des informations sur la façon dont cette API affecte les priorités dans Chrome.