AmbientLightSensor

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

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

Die AmbientLightSensor-Schnittstelle der Sensor-APIs gibt den aktuellen Lichtpegel oder die Beleuchtungsstärke des Umgebungslichts um das Hostgerät zurück.

Um diesen Sensor zu verwenden, muss der Benutzer die Berechtigung für den Geräten-Sensor 'ambient-light-sensor' durch die Permissions API erteilen.

Diese Funktion kann durch eine auf Ihrem Server gesetzte Permissions Policy blockiert werden.

EventTarget Sensor AmbientLightSensor

Konstruktor

AmbientLightSensor()

Erstellt ein neues AmbientLightSensor-Objekt.

Instanz-Eigenschaften

AmbientLightSensor.illuminance Schreibgeschützt

Gibt den aktuellen Lichtpegel in Lux des Umgebungslichts um das Hostgerät zurück.

Instanz-Methoden

AmbientLightSensor hat keine eigenen Methoden. Es erbt jedoch Methoden von seinen Elternschnittstellen, Sensor und EventTarget.

Ereignisse

AmbientLightSensor hat keine eigenen Ereignisse. Es erbt jedoch Ereignisse von seiner Elternschnittstelle, Sensor.

Beispiel

js
if ("AmbientLightSensor" in window) {
  const sensor = new AmbientLightSensor();
  sensor.addEventListener("reading", (event) => {
    console.log("Current light level:", sensor.illuminance);
  });
  sensor.addEventListener("error", (event) => {
    console.log(event.error.name, event.error.message);
  });
  sensor.start();
}

Spezifikationen

Specification
Ambient Light Sensor
# ambient-light-sensor-interface

Browser-Kompatibilität

BCD tables only load in the browser