PerformanceElementTiming

Disponibilité limitée

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

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.

Non standard: Cette fonctionnalité n'est pas standardisée. Nous déconseillons d'utiliser des fonctionnalités non standard en production, car leur prise en charge par les navigateurs est limitée, et elles peuvent être modifiées ou supprimées. Toutefois, elles peuvent constituer une alternative appropriée dans certains cas où aucune option standard n'existe.

L'interface PerformanceElementTiming de l'API Element Timing API rapporte les informations de timing sur un élément spécifique identifié par l'auteur de la page. Par exemple, elle peut fournir des informations sur l'image principale d'un article.

Dans cet article

Propriétés

PerformanceElementTiming.element Lecture seule

Un Element représentant l'élément pour lequel nous retournons des informations.

PerformanceElementTiming.id Lecture seule

Un DOMString qui est l'identifiant (attribut id) de l'élément.

PerformanceElementTiming.identifier Lecture seule

Une DOMString qui est la valeur de l'attribut elementtiming de l'élément.

PerformanceElementTiming.intersectionRect Lecture seule

Un DOMRectReadOnly qui est le rectangle de l'élément dans la fenêtre d'affichage.

PerformanceElementTiming.loadTime Lecture seule

Un DOMHighResTimeStamp avec l'heure de chargement de l'élément.

PerformanceElementTiming.naturalHeight Lecture seule

Un entier de 32 bits non signé (unsigned long) qui est la hauteur intrinsèque de l'image si cela est appliqué à une image, 0 pour le texte.

PerformanceElementTiming.naturalWidth Lecture seule

Un entier de 32 bits non signé (unsigned long) qui est la largeur intrinsèque de l'image si cela est appliqué à une image, 0 pour le texte.

PerformanceElementTiming.renderTime Lecture seule

Un DOMHighResTimeStamp avec le renderTime de l'élément.

PerformanceElementTiming.url Lecture seule

Une DOMString qui est l'URL initiale de la demande de ressources pour les images, 0 pour le texte.

Méthodes

PerformanceElementTiming.toJSON()

Génère une description JSON de l'objet.

Exemples

Dans cet exemple, nous avons deux éléments qui sont observés. Nous utilisons l'interface PerformanceObserver pour créer une liste d'événements de mesure des performances. Dans notre cas, l'observation de l'élément PerformanceEntry.entrytype element afin d'utiliser l'interface PerformanceElementTiming.

Deux entrées seront affichées dans la console. La première contenant les détails de l'image, la seconde les détails du nœud texte.

html
<img src="image.jpg" elementtiming="big-image" />
<p elementtiming="text" id="text-id">le texte ici</p>

js
const observer = new PerformanceObserver((list) => {
  let entries = list.getEntries().forEach(function (entry) {
    console.log(entry);
  });
});
observer.observe({ entryTypes: ["element"] });

Spécifications

Spécification

Element Timing API
# sec-performance-element-timing

Compatibilité des navigateurs

Activez JavaScript pour afficher ce tableau de compatibilité des navigateurs.

Aider à améliorer MDN

Cette page vous a-t-elle été utile ?

Oui Non

Apprendre à contribuer

Cette page a été modifiée le 10 avr. 2026 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu