Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

fetchpriority — priorité de récupération d’une ressource

L’attribut fetchpriority définit la priorité relative de récupération des images, des scripts externes et des ressources référencées par link. Il accepte high, low ou auto ; il ne garantit pas l’ordre dans lequel les récupérations se terminent.

Version : WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

fetchpriority="high|low|auto"

fetchpriority est un attribut à valeur énumérée qui contrôle la priorité de récupération. La valeur high signale une priorité supérieure, low une priorité inférieure, et auto laisse le navigateur décider. La comparaison concerne les ressources ayant la même destination de requête, par exemple des images entre elles, et non des ressources partageant une URL ou un hôte. Si l’attribut est absent ou si sa valeur est invalide, cela signifie auto ; ce n’est pas un attribut booléen.

Sur img, l’attribut concerne la récupération de l’image. Sur script, il concerne la récupération initiale d’un script externe classique ou d’un module, mais pas celle de ses imports de modules. Sur link, il est destiné aux liens vers des ressources externes, comme les feuilles de style. Ce n’est pas un attribut global qui confère un comportement de récupération à des éléments quelconques.

La priorité ne garantit ni le moment ni l’ordre de fin des requêtes. Elle ne remplace pas loading sur les images, ni async et defer sur les scripts : ce sont des mécanismes distincts qui contrôlent le chargement ou l’exécution. En JavaScript, la propriété correspondante est fetchPriority ; elle reflète l’attribut et ne renvoie que les valeurs reconnues. L’exemple vérifie cette réflexion, et non la planification réelle du réseau.

Exemples

const image = document.createElement('img');
image.setAttribute('fetchpriority', 'high');
console.log(image.fetchPriority);
image.setAttribute('fetchpriority', 'invalid');
console.log(image.fetchPriority);
image.removeAttribute('fetchpriority');
console.log(image.fetchPriority);

Résultat

high
auto
auto

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources