PressureObserver: observe()-Methode
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.
Hinweis: Diese Funktion ist in Web Workers verfügbar, mit Ausnahme von Service Workers.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Die observe()-Methode der PressureObserver-Schnittstelle weist den Druckbeobachter an, Änderungen des Drucks zu überwachen. Nachdem diese Methode aufgerufen wurde, wird der Beobachter seine Rückruffunktion aufrufen, wenn ein Druckdatensatz für die angegebene source beobachtet wird.
Wenn ein passender PressureRecord erhalten wird, wird die Rückruffunktion des Druckbeobachters aufgerufen.
Syntax
observe(source)
observe(source, options)
Parameter
source-
Ein String, der angibt, welche
sourceüberwacht werden soll. SiehePressureRecord.sourcefür eine Liste der Quellen undPressureObserver.knownSourcesfür eine Liste der Quellen, die vom User-Agent unterstützt werden. optionsOptional-
Ein Objekt zur Konfiguration der Beobachtung mit den folgenden Eigenschaften:
sampleIntervalOptional-
Eine Zahl, die das angeforderte Abtastintervall in Millisekunden darstellt. Standardmäßig 0 bedeutet, dass Updates so schnell wie das System es verarbeiten kann, erfolgen.
Rückgabewert
Ausnahmen
NotAllowedErrorDOMException-
Wird ausgelöst, wenn die Compute Pressure API durch eine
compute-pressureBerechtigungsrichtlinie nicht erlaubt ist. NotSupportedErrorDOMException-
Wird ausgelöst, wenn der
source-Parameter nicht eine der unterstützten Quellen für diesen User-Agent ist.
Beispiele
Aktuellen Druck protokollieren
Dieses Beispiel erstellt einen PressureObserver und führt Aktionen durch, wann immer sich der Druck ändert. Das Abtastintervall ist auf 1000 ms festgelegt, was bedeutet, dass es Updates höchstens jede Sekunde geben wird.
function callback(records) {
const lastRecord = records[records.length - 1];
console.log(`Current pressure ${lastRecord.state}`);
if (lastRecord.state === "critical") {
// disable video feeds
} else if (lastRecord.state === "serious") {
// disable video filter effects
} else {
// enable all video feeds and filter effects
}
}
try {
const observer = new PressureObserver(callback);
await observer.observe("cpu", {
sampleInterval: 1000, // 1000ms
});
} catch (error) {
// report error setting up the observer
}
Spezifikationen
| Spezifikation |
|---|
| Compute Pressure Level 1 # the-observe-method |