Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

PerformanceEntry.duration — durata di una voce di performance

PerformanceEntry.duration è una proprietà di sola lettura che indica la durata di una voce di performance in millisecondi. Il suo significato dipende da entryType; un valore pari a 0 può indicare che la durata non è applicabile, non che un’operazione sia stata completata istantaneamente.

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

entry.duration

PerformanceEntry.duration si legge come entry.duration, senza chiamare un metodo. Restituisce un DOMHighResTimeStamp: un numero espresso in millisecondi che può includere una parte frazionaria. È una durata, non una data né un timestamp di inizio. La proprietà è di sola lettura.

Il suo significato dipende da entryType. Per measure indica la lunghezza della misurazione; per resource corrisponde a responseEnd - startTime; per navigation a loadEventEnd - startTime. Per voci come mark e paint, la durata non è applicabile e vale 0. Non interpretare quindi ogni zero come prova di un’esecuzione rapida.

Le voci sono oggetti di interfacce specializzate che ereditano da PerformanceEntry. Questa è un’API della piattaforma Web, non una funzionalità di ECMAScript in sé. La proprietà è ampiamente supportata nei browser ed è disponibile nei Web Workers, ma ciò non implica il supporto di ogni tipo di voce o di ogni variante delle API che creano voci.

L’esempio crea un PerformanceMeasure con i valori espliciti start: 10 e end: 35. Leggere entry.duration restituisce 25, indipendentemente dalla velocità del dispositivo. Sono valori sintetici, non una misurazione dell’esecuzione del codice; dopo aver letto il risultato, l’esempio rimuove dalla timeline la misurazione denominata.

Esempi

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

Risultato

measure
25

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