performance.mark()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2015.

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

js
performance.mark(name);

Arguments

name

Une chaîne de caractères (DOMString) représentant le nom du marqueur. Si le nom donné à cette méthode existe déjà dans l'interface PerformanceTiming, une exception SyntaxError est 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.

js
// 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 Level 3
# dom-performance-mark

Compatibilité des navigateurs

BCD tables only load in the browser