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() Experimentell

Erstellt ein neues AmbientLightSensor-Objekt.

Instanz-Eigenschaften

AmbientLightSensor.illuminance Schreibgeschützt Experimentell

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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
AmbientLightSensor
Experimental
AmbientLightSensor() constructor
Experimental
illuminance
Experimental

Legend

Tip: you can click/tap on a cell for more information.

No support
No support
Experimental. Expect behavior to change in the future.
See implementation notes.
User must explicitly enable this feature.
Has more compatibility info.