Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti