PerformanceElementTiming

Experimental

Cette fonction est expérimentale
Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le tableau de compatibilité pour les préfixes à utiliser selon les navigateurs.
Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification.

Non standard

Cette fonctionnalité n'est ni standard, ni en voie de standardisation. Ne l'utilisez pas pour des sites accessibles sur le Web : elle ne fonctionnera pas pour tout utilisateur. Il peut également y avoir d'importantes incompatibilités entre les implémentations et son comportement peut être modifié dans le futur.

L'interface PerformanceElementTiming de l'API Element Timing API (en-US) 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.

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.

<img src="image.jpg" elementtiming="big-image">
<p elementtiming="text" id="text-id">le texte ici</p>
const observer = new PerformanceObserver((list) => {
  let entries = list.getEntries().forEach(function (entry) {
      console.log(entry);
  });
});
observer.observe({ entryTypes: ["element"] });

Spécifications

Spécification Statut Commentaire
Element Timing
La définition de 'PerformanceElementTiming' dans cette spécification.
Brouillon de l'éditeur Définition initiale.

Compatibilité des navigateurs

BCD tables only load in the browser