PerformanceElementTiming
========================

**Expérimental:** **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  
Expérimental

Non-standard

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

`PerformanceElementTiming.id` Lecture seule  
Expérimental

Non-standard

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

`PerformanceElementTiming.identifier` Lecture seule  
Expérimental

Non-standard

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

`PerformanceElementTiming.intersectionRect` Lecture seule  
Expérimental

Non-standard

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

`PerformanceElementTiming.loadTime` Lecture seule  
Expérimental

Non-standard

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

`PerformanceElementTiming.naturalHeight` Lecture seule  
Expérimental

Non-standard

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  
Expérimental

Non-standard

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  
Expérimental

Non-standard

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

`PerformanceElementTiming.url` Lecture seule  
Expérimental

Non-standard

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

Méthodes
--------

`PerformanceElementTiming.toJSON()` 
Expérimental

Non-standard

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
--------------

| Specification |
| --- |
| Element Timing API # sec-performance-element-timing |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.