Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

performance.now() — pomiar czasu trwania

performance.now() zwraca znacznik czasu w milisekundach względem początku czasu danego środowiska. Różnica dwóch odczytów pozwala mierzyć czas trwania bez wpływu korekt zegara systemowego.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

const start = performance.now();
// Run the operation being measured.
const elapsedMs = performance.now() - start;

performance.now() nie przyjmuje argumentów i zwraca DOMHighResTimeStamp, czyli liczbę w milisekundach, która może mieć część ułamkową. Wartość jest względna wobec początku czasu danego środowiska, a nie epoki Unix. Początek ten opisuje performance.timeOrigin.

Aby zmierzyć czas trwania, odejmij wcześniejszy odczyt od późniejszego w tym samym środowisku. Zegar jest monotoniczny: odczyty nie maleją wskutek korekt zegara systemowego. Natomiast Date.now() opisuje czas kalendarzowy i może podlegać takim korektom. Nie odejmuj bezpośrednio odczytów z kontekstów o różnych początkach czasu.

Przeglądarka może ograniczać rozdzielczość ze względów bezpieczeństwa; dwa kolejne odczyty mogą być równe. Część ułamkowa nie gwarantuje określonej dokładności. Przykład sprawdza wynik obliczenia i nieujemny czas zamiast konkretnej liczby milisekund.

To Web API zdefiniowane w High Resolution Time, a nie funkcja samego ECMAScript. Specyfikacja udostępnia je w Window i Worker; dostępność sprawdzaj w docelowej przeglądarce, nie na podstawie wersji Node w repozytorium. Sam odczyt nie zapisuje wpisu na osi wydajności; nazwane pomiary zapewniają performance.mark() i performance.measure() z User Timing.

Przykłady

const start = performance.now();
let sum = 0;
for (let i = 1; i <= 1000; i++) {
  sum += i;
}
const elapsedMs = performance.now() - start;
console.log(sum);
console.log(Number.isFinite(elapsedMs) && elapsedMs >= 0);

Wynik

500500
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła