CKTIS / JavaScript
performance.mark: un punto con nome sulla cronologia
performance.mark registra un timestamp con nome sulla cronologia delle prestazioni. Rappresenta un punto, non un intervallo; le opzioni permettono di impostare l’ora e aggiungere metadati.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
performance.mark(markName)
performance.mark(markName, { startTime, detail })performance.mark(markName, markOptions) fa parte della Web API User Timing, non di ECMAScript. Nel modello di livello 3 registra e restituisce un PerformanceMark: entryType è "mark" e duration è 0. Un intervallo si misura separatamente con performance.measure().
Se startTime non è specificato, usa performance.now(): millisecondi relativi all’origine temporale locale, non a una data di calendario. detail, che è facoltativo, viene copiato tramite clonazione strutturata. Non includere segreti, perché altri script della pagina possono leggere i mark.
Un startTime negativo genera un TypeError; un detail non clonabile può causare un DataCloneError. In Window, i nomi riservati dal vecchio PerformanceTiming, come navigationStart, generano un SyntaxError.
Riutilizzare un nome aggiunge una voce invece di sostituire quella precedente. performance.clearMarks(name) rimuove tutti i mark con quel nome. L’esempio richiede il supporto del livello 3; la presenza di Node 24 nel repository non dimostra il supporto dei browser.
Esempi
(() => {
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);
}
})();Risultato
["cktis:performance-mark:demo","mark",12,0,"ready"]
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.