CKTIS / JavaScript
performance.measure — intervalos de tempo com nome
performance.measure regista um intervalo com nome na linha temporal de desempenho. Pode utilizar marcas ou marcas temporais explícitas; a sobrecarga moderna devolve um PerformanceMeasure com o início e a duração do intervalo em milissegundos.
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.measure(name)
performance.measure(name, startMark, endMark)
performance.measure(name, { start, end, detail })
performance.measure(name, { start, duration, detail })
performance.measure(name, { end, duration, detail })performance.measure pertence à Web API User Timing, não a ECMAScript. Regista uma entrada do tipo "measure"; a sobrecarga moderna devolve um PerformanceMeasure com name, startTime, duration e detail. Não executa nem mede automaticamente uma função que lhe seja passada.
performance.measure(name) abrange o intervalo desde zero na linha temporal de desempenho até à chamada. A sobrecarga com nomes de marcas utiliza o performance.mark correspondente mais recente. O objeto de opções aceita start e end como nomes de marcas ou marcas temporais em milissegundos relativas à origem temporal do desempenho, não à época Unix. Pode fornecer start com duration ou end com duration, mas não os três campos em simultâneo.
É permitido um objeto de opções vazio. Um objeto não vazio tem de incluir start ou end e exclui um terceiro argumento; a violação destas regras gera um TypeError. A ausência de uma marca nomeada comum gera um SyntaxError. Uma marca temporal de entrada negativa gera um TypeError, mas a duration resultante pode ser negativa. detail é copiado através de clonagem estruturada.
O exemplo utiliza marcas temporais artificiais: demonstra o cálculo de um intervalo, não um teste de velocidade. performance.clearMeasures(name) remove as medições guardadas com esse nome, mas não as marcas. O objeto de opções e a entrada devolvida provêm de extensões de nível 3; o nível 2 devolvia undefined. Nem a mera presença do método nem o Node 24 comprovam que esta sobrecarga é suportada no navegador de destino.
Exemplos
(() => {
const name = "cktis:measure-demo";
try {
const entry = performance.measure(name, { start: 10, end: 35 });
console.log(`${entry.entryType}: ${entry.startTime} + ${entry.duration} ms`);
} finally {
performance.clearMeasures(name);
}
})();Resultado
measure: 10 + 25 ms
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.