AmbientLightSensor: illuminance 屬性

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

實驗性: 這是一項實驗性技術
在生產中使用此技術之前,請仔細檢查瀏覽器相容性表格

AmbientLightSensor 介面的只讀屬性 illuminance 返回託管裝置周圍環境光線的當前光照水平(以 勒克斯 為單位)。

一個 Number,表示當前光照水平(以勒克斯為單位)。

示例

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();
}

規範

規範
環境光感測器
# ambient-light-sensor-reading-attribute

瀏覽器相容性