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

CKTIS / JavaScript

PerformanceEntry.duration — duração de uma entrada de desempenho

PerformanceEntry.duration é uma propriedade só de leitura que indica a duração de uma entrada de desempenho em milissegundos. O seu significado depende de entryType; um valor de 0 pode significar que a duração não se aplica, e não que uma operação tenha sido concluída instantaneamente.

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

entry.duration

Lê-se PerformanceEntry.duration como entry.duration, sem chamar um método. Devolve um DOMHighResTimeStamp: um número expresso em milissegundos que pode incluir uma parte fracionária. É uma duração, não uma data nem um carimbo temporal de início. A propriedade é só de leitura.

O seu significado depende de entryType. Para measure, corresponde à duração da medição; para resource, a responseEnd - startTime; e para navigation, a loadEventEnd - startTime. Em entradas como mark e paint, a duração não se aplica e vale 0. Por isso, não interpretes todos os zeros como prova de uma execução rápida.

As entradas são objetos de interfaces especializadas que herdam de PerformanceEntry. Esta é uma API da plataforma Web, não uma funcionalidade do próprio ECMAScript. A propriedade é amplamente suportada nos browsers e está disponível em Web Workers, mas isso não significa que todos os tipos de entrada ou todas as variantes das APIs que criam entradas sejam suportados.

O exemplo cria um PerformanceMeasure com os valores explícitos start: 10 e end: 35. A leitura de entry.duration dá 25, independentemente da velocidade do dispositivo. São valores sintéticos, não uma medição da execução do código; depois de ler o resultado, o exemplo remove da linha temporal a medição com nome.

Exemplos

const entry = performance.measure("cktis-duration-demo", {
  start: 10,
  end: 35,
});
console.log(entry.entryType);
console.log(entry.duration);
performance.clearMeasures("cktis-duration-demo");

Resultado

measure
25

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