JS Self-Profiling API

Eingeschränkt verfügbar

Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Die JS Self-Profiling API ermöglicht es einer Website, einen Sampling-Profiler auszuführen, um zu verstehen, wo sie JavaScript-Ausführungszeit verbringt.

In diesem Artikel

Konzepte und Nutzung

Um ein Profil zu starten, erstellt eine Website eine Profiler-Instanz. Sobald die Instanz erstellt ist, beginnt sie mit der Probenahme des JavaScript-Ausführungskontextes.

Um die Sammlung von Proben zu stoppen und das Profil abzurufen, ruft die Website Profiler.stop() auf. Dies gibt ein Promise zurück, das ein Objekt mit den Profildaten auflöst.

Zum Beispiel erstellt die folgende Funktion einen Profiler, ruft dann eine Funktion genPrimes() auf, stoppt anschließend den Profiler und ruft die Profildaten ab:

js
async function profileGeneratePrimes() {
  const profiler = new Profiler({ sampleInterval: 10, maxBufferSize: 10000 });

  genPrimes();

  const trace = await profiler.stop();
  console.log(trace);
}

Der Profiler ist ein Sampling-Profiler: das bedeutet, dass er periodisch den aktuellen Zustand des JavaScript-Call Stacks aufzeichnet (oder abfragt). Das Profil besteht aus der Sammlung dieser Proben. Dies ermöglicht es Ihnen zu verstehen, wo das Programm statistisch gesehen die meiste Zeit verbringt.

Um genau zu verstehen, was ein Profil enthält und wie es formatiert ist, siehe Profile anatomy and format.

Best Practices für das Profiling

Das Sammeln und Verarbeiten von Profildaten führt zu einem eigenen Leistungsaufwand, und Entwickler sollten darauf achten, diesen zu verwalten. Praktiken zur Minimierung des Leistungsaufwands umfassen:

Verwenden Sie die Optionen maxBufferSize und sampleInterval, um zu steuern, wie viele Proben genommen werden und wie oft die Probenahme erfolgen soll.
Nehmen Sie Proben für kurze Zeiträume auf eine gesampelte Weise: zum Beispiel, indem Sie für 5 Sekunden von jeder 60 Sekunden verfolgen.
Verarbeiten Sie die Proben in einem Web Worker, um die Leistung auf dem Haupt-Thread nicht zu beeinträchtigen.
Aggregieren Sie Proben auf dem Client, bevor Sie sie an einen Telemetrie-Endpunkt senden.

Wenn das JavaScript auf Ihrer Seite minifiziert ist, müssen Sie die Profildaten basierend auf einer Source Map entweder auf dem Client oder auf dem Server transformieren, bevor die Daten verwendbar sind.

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

JS Self-Profiling API
Anleitungen
1. Aufbau und Format eines Profils
Interfaces
1. Profiler

JS Self-Profiling API

In diesem Artikel

Konzepte und Nutzung

Best Practices für das Profiling

Schnittstellen

Sicherheitsanforderungen

Spezifikationen

Browser-Kompatibilität

Help improve MDN