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
Large disponibilité
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éthode mark() crée un timestamp dans le tampon 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éthodes getEntries*() de l'interface Performance (getEntries(), getEntriesByName() ou getEntriesByType()).
La méthode mark() stocke ses données en interne sous la forme d'objets PerformanceEntry.
Note : Cette fonctionnalité est disponible via les Web Workers.
Syntaxe
performance.mark(name);
Arguments
name-
Une chaîne de caractères (
String) 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 utiliser mark() pour créer et récupérer des entrées PerformanceMark.
// 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
| Spécification |
|---|
| User Timing # dom-performance-mark |
Compatibilité des navigateurs
Activez JavaScript pour afficher ce tableau de compatibilité des navigateurs.
Aider à améliorer MDN
Cette page a été modifiée le par les contributeur·ice·s du MDN.