CKTIS / JavaScript
performance.mark — un point nommé sur la chronologie
performance.mark enregistre un horodatage nommé sur la chronologie des performances. Il représente un point, pas un intervalle ; les options permettent de définir son heure et d’ajouter des métadonnées.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
performance.mark(markName)
performance.mark(markName, { startTime, detail })performance.mark(markName, markOptions) fait partie de l’API Web User Timing, et non d’ECMAScript. Dans le modèle de niveau 3, la méthode enregistre et renvoie un PerformanceMark : entryType vaut "mark" et duration vaut 0. Un intervalle se mesure séparément avec performance.measure().
Sans startTime, elle utilise performance.now() : des millisecondes relatives à l’origine temporelle locale, et non à une date du calendrier. detail, qui est facultatif, est copié par clonage structuré. N’y incluez pas de secrets, car d’autres scripts de la page peuvent lire les marques.
Un startTime négatif déclenche une TypeError ; un detail impossible à cloner peut provoquer une DataCloneError. Dans Window, les noms réservés par l’ancien PerformanceTiming, comme navigationStart, déclenchent une SyntaxError.
Réutiliser un nom ajoute une entrée au lieu de remplacer la précédente. performance.clearMarks(name) supprime toutes les marques portant ce nom. L’exemple nécessite la prise en charge du niveau 3 ; la présence de Node 24 dans le dépôt ne prouve pas la prise en charge par les navigateurs.
Exemples
(() => {
const name = "cktis:performance-mark:demo";
performance.clearMarks(name);
try {
const mark = performance.mark(name, {
startTime: 12,
detail: { phase: "ready" }
});
console.log(JSON.stringify([
mark.name,
mark.entryType,
mark.startTime,
mark.duration,
mark.detail.phase
]));
} finally {
performance.clearMarks(name);
}
})();Résultat
["cktis:performance-mark:demo","mark",12,0,"ready"]
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.