Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
performance.mark()
Baseline Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis septembre 2017.
La méthodemark() crée untimestamp dans letampon d'entrée de performance du navigateur avec le nom donné en argument.
L'horodatage ainsi défini par l'application peut être récupéré par l'une des méthodesgetEntries*() de l'interfacePerformance (getEntries(),getEntriesByName() ougetEntriesByType()).
La méthodemark() stocke ses données en interne sous la forme d'objetsPerformanceEntry.
Note : Cette fonctionnalité est disponible via lesWeb Workers.
Syntaxe
performance.mark(name);Arguments
nameUne chaîne de caractères (
DOMString) représentant le nom du marqueur. Si le nom donné à cette méthode existe déjà dans l'interfacePerformanceTiming, une exceptionSyntaxErrorest levée.
Valeur de retour
Aucune.
>
Exemple
L'exemple suivant montre comment utilisermark() pour créer et récupérer des entréesPerformanceMark.
// Crée un ensemble de marqueurs.performance.mark("squirrel");performance.mark("squirrel");performance.mark("monkey");performance.mark("monkey");performance.mark("dog");performance.mark("dog");// Obtient toutes les entrées de PerformanceMark.const allEntries = performance.getEntriesByType("mark");console.log(allEntries.length);// 6// Obtient toutes les entrées "monkey" de PerformanceMark.const monkeyEntries = performance.getEntriesByName("monkey");console.log(monkeyEntries.length);// 2// Efface tous les marqueurs.performance.clearMarks();Spécifications
| Specification |
|---|
| User Timing # dom-performance-mark |