CKTIS / JavaScript
performance.clearMeasures() — User Timing-metingen verwijderen
performance.clearMeasures() verwijdert opgeslagen User Timing-metingen uit de buffer met performance-items. Je kunt alle metingen verwijderen of alle items met één bepaalde naam, zonder tijdmarkeringen te wissen.
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.clearMeasures();
performance.clearMeasures(measureName);performance.clearMeasures() verwijdert PerformanceMeasure-objecten, gemaakt door performance.measure(), uit de buffer met performance-items. Zonder argument verwijdert de methode alle metingen; performance.clearMeasures(measureName) verwijdert elke meting met precies die naam, niet alleen de laatste.
Het optionele measureName is een naam van het type DOMString. Als er geen metingen overeenkomen, verwijdert de aanroep niets. De retourwaarde is altijd undefined, niet het aantal verwijderde items. De methode verwijdert geen PerformanceMark-items; gebruik daarvoor performance.clearMarks().
Verwijder je eigen metingen nadat je ze hebt uitgelezen. Geef in code die een pagina met andere modules deelt liever een naam mee dan dat je de methode zonder argument aanroept. Zo voorkom je dat metingen van andere modules worden verwijderd. Het voorbeeld maakt twee metingen met dezelfde naam en controleert het aantal vóór en na verwijdering, zonder variabele tijdwaarden af te drukken.
Dit is een Web-API die is vastgelegd in User Timing, geen functie van de ECMAScript-taal. De methode staat al in User Timing Level 2. Controleer de beschikbaarheid in de doelbrowser, bijvoorbeeld met typeof performance.clearMeasures === "function"; de aanwezigheid van Node 24 in een repository bewijst geen browserondersteuning.
Voorbeelden
(() => {
const name = "cktis.clearMeasures.demo";
performance.clearMeasures(name);
try {
performance.measure(name);
performance.measure(name);
console.log(performance.getEntriesByName(name, "measure").length);
const result = performance.clearMeasures(name);
console.log(performance.getEntriesByName(name, "measure").length);
console.log(result === undefined);
} finally {
performance.clearMeasures(name);
}
})();Resultaat
2 0 true
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.