L'interface PerformanceResourceTiming permet de récupérer et d'analyser des données de synchronisation réseau détaillées concernant le chargement des ressources d'une application. Une application peut utiliser les mesures temporelles pour déterminer, par exemple, la durée nécessaire à l'extraction d'une ressource spécifique, telle qu'une XMLHttpRequest, un élément <svg>, une image ou un script.
Les propriétés de l'interface créent une chronologie de chargement des ressources avec un timestamps haute résolution pour les événements réseau tels que les heures de début et de fin de redirection, les heures de début de récupération, les heures de début et de fin de recherche DNS, les heures de début et de fin de réponse, etc. En outre, l'interface étend PerformanceEntry avec d'autres propriétés qui fournissent des données sur la taille de la ressource extraite ainsi que le type de ressource qui a initié l'extraction.
{{InheritanceDiagram}}
{{AvailableInWorkers}}
Cette interface étend les propriétés PerformanceEntry suivantes pour les types d'entrée de performance des ressources en les restreignant comme suit :
PerformanceEntry.entryType {{readonlyInline}}"resource".PerformanceEntry.name {{readonlyInline}}PerformanceEntry.startTime {{readonlyInline}}timestamp de l'heure de début de la récupération d'une ressource. Cette valeur est équivalente à PerformanceResourceTiming.fetchStart.PerformanceEntry.duration {{readonlyInline}}timestamp qui est la différence entre les propriétés responseEnd et startTime.L'interface prend également en charge les propriétés suivantes, qui sont énumérées dans l'ordre temporel selon lequel elles sont enregistrées pour l'extraction d'une seule ressource. Une liste alphabétique est présentée dans la navigation, à gauche.
PerformanceResourceTiming.initiatorType {{readonlyInline}}string représentant le type de ressource qui a initié l'entrée de performance, comme spécifié dans PerformanceResourceTiming.initiatorType.PerformanceResourceTiming.nextHopProtocol {{readonlyInline}}string représentant le protocole réseau utilisé pour récupérer la ressource, tel qu'identifié par le ALPN Protocol ID (RFC7301).PerformanceResourceTiming.workerStart {{readonlyInline}}DOMHighResTimeStamp immédiatement avant de transmettre le FetchEvent si un processus de Service Worker est déjà en cours, ou immédiatement avant de lancer le processus de Service Worker s'il n'est pas encore en cours. Si la ressource n'est pas interceptée par un Service Worker, la propriété retourne toujours 0.PerformanceResourceTiming.redirectStart {{readonlyInline}}DOMHighResTimeStamp qui représente l'heure de début de l'extraction qui déclenche la redirection.PerformanceResourceTiming.redirectEnd {{readonlyInline}}DOMHighResTimeStamp immédiatement après la réception du dernier octet de la réponse de la dernière redirection.PerformanceResourceTiming.fetchStart {{readonlyInline}}DOMHighResTimeStamp immédiatement avant que le navigateur ne commence à récupérer la ressource.PerformanceResourceTiming.domainLookupStart {{readonlyInline}}DOMHighResTimeStamp immédiatement avant que le navigateur ne commence la recherche du nom de domaine pour la ressource.PerformanceResourceTiming.domainLookupEnd {{readonlyInline}}DOMHighResTimeStamp représentant l'heure immédiatement après la fin de la recherche du nom de domaine de la ressource par le navigateur.PerformanceResourceTiming.connectStart {{readonlyInline}}DOMHighResTimeStamp immédiatement avant que le navigateur ne commence à établir la connexion avec le serveur pour récupérer la ressource.PerformanceResourceTiming.connectEnd {{readonlyInline}}DOMHighResTimeStamp immédiatement après que le navigateur ait fini d'établir la connexion avec le serveur pour récupérer la ressource.PerformanceResourceTiming.secureConnectionStart {{readonlyInline}}DOMHighResTimeStamp immédiatement avant que le navigateur ne lance le processus de reconnaissance pour sécuriser la connexion en cours.PerformanceResourceTiming.requestStart {{readonlyInline}}DOMHighResTimeStamp immédiatement avant que le navigateur ne commence à demander la ressource au serveur.PerformanceResourceTiming.responseStart {{readonlyInline}}DOMHighResTimeStamp immédiatement après que le navigateur ait reçu le premier octet de la réponse du serveur.PerformanceResourceTiming.responseEnd {{readonlyInline}}DOMHighResTimeStamp immédiatement après la réception par le navigateur du dernier octet de la ressource ou immédiatement avant la fermeture de la connexion de transfert, selon la première éventualité.PerformanceResourceTiming.transferSize {{readonlyInline}}PerformanceResourceTiming.encodedBodySize {{readonlyInline}}PerformanceResourceTiming.decodedBodySize {{readonlyInline}}PerformanceResourceTiming.serverTiming {{readonlyInline}}PerformanceServerTiming contenant des mesures de synchronisation du serveur.PerformanceResourceTiming.toJSON()DOMString qui est la représentation JSON de l'objet PerformanceResourceTiming.Voir l'exemple dans Utilisation de Resource Timing API.
| Spécification | Statut | Commentaire |
|---|---|---|
| {{SpecName('Resource Timing', '#performanceresourcetiming', 'PerformanceResourceTiming')}} | {{Spec2('Resource Timing')}} | Définition initiale. |
{{Compat("api.PerformanceResourceTiming")}}