Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

performance.measure — nazwane przedziały czasu

performance.measure zapisuje nazwany przedział na osi wydajności. Może korzystać ze znaczników lub jawnych czasów; współczesny wariant zwraca PerformanceMeasure z początkiem i długością przedziału w milisekundach.

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

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 należy do Web API User Timing, nie do ECMAScript. Zapisuje wpis typu "measure"; współczesny wariant zwraca PerformanceMeasure z name, startTime, duration i detail. Nie uruchamia ani nie mierzy automatycznie przekazanej funkcji.

performance.measure(name) obejmuje czas od zera osi wydajności do chwili wywołania. Wariant z nazwami znaczników używa najnowszego pasującego performance.mark. Obiekt opcji przyjmuje start i end jako nazwy znaczników lub czasy w milisekundach względem początku osi wydajności, nie epoki Unix. Można podać start z duration albo end z duration, lecz nie wszystkie trzy pola naraz.

Pusty obiekt opcji jest dozwolony. Niepusty wymaga start lub end i wyklucza trzeci argument; naruszenie tych reguł powoduje TypeError. Brak zwykłego nazwanego znacznika powoduje SyntaxError. Ujemny czas wejściowy powoduje TypeError, ale wynikowe duration może być ujemne. detail jest kopiowane mechanizmem klonowania strukturalnego.

Przykład używa sztucznych czasów: pokazuje obliczenie przedziału, nie test szybkości. performance.clearMeasures(name) usuwa zapisane pomiary o tej nazwie, ale nie znaczniki. Obiekt opcji i zwracany wpis pochodzą z rozszerzeń Level 3; Level 2 zwracał undefined. Sama obecność metody ani Node 24 nie dowodzą obsługi tego wariantu w docelowej przeglądarce.

Przykłady

(() => {
  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);
  }
})();

Wynik

measure: 10 + 25 ms

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

Źródła