KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

performance.clearMarks() — tijdmarkeringen verwijderen

performance.clearMarks() verwijdert User Timing-markeringen uit de buffer met performance-items. Met een naam worden alle overeenkomende markeringen verwijderd; zonder argument worden alle markeringen verwijderd, maar geen metingen.

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.clearMarks();
performance.clearMarks(markName);

performance.clearMarks(markName) verwijdert alle PerformanceMark-objecten met exact de opgegeven naam uit de buffer met performance-items, niet alleen het nieuwste object. Als er geen markering overeenkomt, verandert er niets. De methode retourneert undefined, niet het aantal verwijderde items.

performance.clearMarks() zonder argument verwijdert alle markeringen. PerformanceMeasure-items worden niet verwijderd; gebruik daarvoor performance.clearMeasures(). Verwijder bij voorkeur op naam, zodat je geen markeringen van andere onderdelen van de toepassing wist.

Maak een meting voordat je de markeringen verwijdert waarnaar deze op naam verwijst. Een latere aanroep van performance.measure() met de naam van een verwijderde toepassingsmarkering veroorzaakt SyntaxError, tenzij die markering opnieuw wordt gemaakt. Bestaande metingen blijven in de buffer.

Dit is een Web-API die door User Timing wordt gespecificeerd, geen functie van een bepaalde ECMAScript-editie; de API staat al in User Timing Level 2. De specificatie is geen browsercompatibiliteitstabel. Controleer typeof globalThis.performance?.clearMarks === "function" in de doelomgeving; de aanwezigheid van Node 24 in een repository bewijst geen browserondersteuning.

Voorbeelden

(() => {
  const name = "cktis:clearMarks:demo";
  performance.clearMarks(name);
  try {
    performance.mark(name);
    performance.mark(name);
    console.log(performance.getEntriesByName(name, "mark").length);
    const result = performance.clearMarks(name);
    console.log(performance.getEntriesByName(name, "mark").length);
    console.log(result === undefined);
    performance.clearMarks(name);
    console.log(performance.getEntriesByName(name, "mark").length);
  } finally {
    performance.clearMarks(name);
  }
})();

Resultaat

2
0
true
0

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