Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes