CKTIS / JavaScript
performance.mark — um ponto com nome na linha temporal
performance.mark regista um carimbo temporal com nome na linha temporal de desempenho. Representa um ponto, não um intervalo; as opções permitem definir a hora e adicionar metadados.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
performance.mark(markName)
performance.mark(markName, { startTime, detail })performance.mark(markName, markOptions) faz parte da API Web User Timing, não de ECMAScript. No modelo de nível 3, regista e devolve um PerformanceMark: entryType é "mark" e duration é 0. Um intervalo é medido separadamente com performance.measure().
Sem startTime, utiliza performance.now(): milissegundos relativos à origem temporal local, não a uma data do calendário. O detail, que é opcional, é copiado através de clonagem estruturada. Não incluas segredos, pois outros scripts na página podem ler as marcas.
Um startTime negativo gera um TypeError; um detail que não possa ser clonado pode causar um DataCloneError. Em Window, os nomes reservados pelo antigo PerformanceTiming, como navigationStart, geram um SyntaxError.
Reutilizar um nome adiciona uma entrada em vez de substituir a anterior. performance.clearMarks(name) remove todas as marcas com esse nome. O exemplo requer suporte de nível 3; a presença de Node 24 no repositório não comprova o suporte dos navegadores.
Exemplos
(() => {
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"]
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.