CKTIS / JavaScript
performance.mark: un punto con nombre en la línea de tiempo
performance.mark registra una marca de tiempo con nombre en la línea de tiempo de rendimiento. Representa un punto, no un intervalo; las opciones permiten establecer la hora y adjuntar metadatos.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
performance.mark(markName)
performance.mark(markName, { startTime, detail })performance.mark(markName, markOptions) pertenece a la API web User Timing, no a ECMAScript. En el modelo de nivel 3, registra y devuelve un PerformanceMark: entryType es "mark" y duration es 0. Un intervalo se mide por separado con performance.measure().
Si no se indica startTime, utiliza performance.now(): milisegundos relativos al origen temporal local, no a una fecha del calendario. El detail opcional se copia mediante clonación estructurada. No incluyas secretos, porque otros scripts de la página pueden leer las marcas.
Un startTime negativo provoca un TypeError; un detail que no se pueda clonar puede causar un DataCloneError. En Window, los nombres reservados por el antiguo PerformanceTiming, como navigationStart, provocan un SyntaxError.
Reutilizar un nombre añade una entrada en vez de reemplazar la anterior. performance.clearMarks(name) elimina todas las marcas con ese nombre. El ejemplo requiere compatibilidad con el nivel 3; la presencia de Node 24 en el repositorio no demuestra que los navegadores lo admitan.
Ejemplos
(() => {
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);
}
})();Resultado
["cktis:performance-mark:demo","mark",12,0,"ready"]
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.