KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

performance.measure — benoemde tijdsintervallen

performance.measure registreert een benoemd interval op de prestatietijdlijn. Het kan markeringen of expliciete tijdstempels gebruiken; de moderne variant retourneert een PerformanceMeasure met het begin en de duur van het interval in milliseconden.

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

Syntax

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 hoort bij de Web API User Timing, niet bij ECMAScript. Het registreert een item van het type "measure"; de moderne variant retourneert een PerformanceMeasure met name, startTime, duration en detail. Het voert een meegegeven functie niet uit en meet die ook niet automatisch.

performance.measure(name) omvat het interval vanaf nul op de prestatietijdlijn tot aan de aanroep. De variant met markeringsnamen gebruikt de nieuwste overeenkomende performance.mark. Het optiesobject accepteert start en end als markeringsnamen of tijdstempels in milliseconden ten opzichte van het tijdsoorsprongspunt van de prestaties, niet de Unix-epoch. U kunt start met duration of end met duration opgeven, maar niet alle drie de velden tegelijk.

Een leeg optiesobject is toegestaan. Een niet-leeg object moet start of end bevatten en sluit een derde argument uit; overtreding van deze regels veroorzaakt een TypeError. Als een gewone marker met die naam ontbreekt, ontstaat een SyntaxError. Een negatieve invoertijdstempel veroorzaakt een TypeError, maar de resulterende duration kan negatief zijn. detail wordt gekopieerd met structured cloning.

Het voorbeeld gebruikt kunstmatige tijdstempels: het laat zien hoe een interval wordt berekend, niet hoe snelheid wordt getest. performance.clearMeasures(name) verwijdert opgeslagen metingen met die naam, maar geen markeringen. Het optiesobject en het geretourneerde item komen uit uitbreidingen van Level 3; Level 2 retourneerde undefined. Alleen de aanwezigheid van de methode, noch Node 24, bewijst dat deze variant in een doelbrowser wordt ondersteund.

Voorbeelden

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

Resultaat

measure: 10 + 25 ms

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen