FileSystemObserver: FileSystemObserver() Konstruktor

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

Nicht standardisiert: Diese Funktion ist nicht standardisiert. Wir raten davon ab, nicht-standardisierte Funktionen auf produktiven Webseiten zu verwenden, da sie nur von bestimmten Browsern unterstützt werden und sich in Zukunft ändern oder entfernt werden können. Unter Umständen kann sie jedoch eine geeignete Option sein, wenn es keine standardisierte Alternative gibt.

Der FileSystemObserver() Konstruktor erstellt eine neue FileSystemObserver Objektinstanz.

Syntax

js
new FileSystemObserver(callback)

Parameter

callback

Eine benutzerdefinierte Callback-Funktion, die aufgerufen wird, wenn der Beobachter eine Änderung in dem Dateisystemeintrag beobachtet hat, den er beobachten soll (über FileSystemObserver.observe()). Der Callback-Funktion werden die folgenden zwei Parameter übergeben:

records

Ein Array von FileSystemChangeRecord Objekten, die Details aller beobachteten Änderungen enthalten.

observer

Eine Referenz auf das aktuelle FileSystemObserver Objekt, das zur Verfügung steht, falls Sie zum Beispiel die Beobachtungen nach Erhalt der aktuellen Einträge mit der Methode FileSystemObserver.disconnect() stoppen möchten.

Rückgabewert

Ein neues FileSystemObserver Objekt.

Beispiele

Hinweis: Für ein vollständiges funktionierendes Beispiel sehen Sie sich die File System Observer Demo an (Quellcode).

Initialisierung eines FileSystemObserver

Bevor Sie Änderungen an Dateien oder Verzeichnissen beobachten können, müssen Sie einen FileSystemObserver initialisieren, um die Beobachtungen zu handhaben:

js
const observer = new FileSystemObserver(callback);

Der Funktionskörper der Callback-Funktion kann so spezifiziert werden, dass er Dateiänderungsbeobachtungen auf jegliche gewünschte Weise zurückgibt und verarbeitet:

js
const callback = (records, observer) => {
  for (const record of records) {
    console.log("Change detected:", record);
    const reportContent = `Change observed to ${record.changedHandle.kind} ${record.changedHandle.name}. Type: ${record.type}.`;
    sendReport(reportContent); // Some kind of user-defined reporting function
  }

  observer.disconnect();
};

Spezifikationen

Derzeit nicht Teil einer Spezifikation. Siehe https://github.com/whatwg/fs/pull/165 für den relevanten Spezifikations-PR.

Browser-Kompatibilität

Siehe auch