在此页

• 构造函数
• 特性
• 范例
• 规范
• 浏览器兼容性
• 相关话题

AmbientLightSensor 接口的 Sensor APIs returns the current light level or illuminance of the ambient light around the hosting device.

To use this sensor, the user must grant permission to the 'ambient-light-sensor' device sensor through the 权限 API。

If a feature policy blocks use of a feature it is because your code is inconsistent with the policies set on your server. This is not something that would ever be shown to a user. See Feature-Policy for implementation instructions.

构造函数

AmbientLightSensor.AmbientLightSensor()

创建新的 AmbientLightSensor 对象。

特性

AmbientLightSensor.illuminance

Returns the current light level in lux of the ambient light level around the hosting device.

范例

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

规范

规范	状态	注释
Generic Sensor API	候选推荐	Defines sensors in general.
Ambient Light Sensor The definition of 'AmbientLightSensor' in that specification.	候选推荐

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
AmbientLightSensor	Chrome 54 54 69 Based on Generic Sensor API.	Edge ≤79	Firefox No	IE No	Opera 56	Safari No	WebView Android 54 54 69 Based on Generic Sensor API.	Chrome Android 54 54 69 Based on Generic Sensor API.	Firefox Android No	Opera Android 48	Safari iOS No	Samsung Internet Android 6.0 6.0 10.0 Based on Generic Sensor API.
AmbientLightSensor() 构造函数	Chrome 54 54 69 Based on Generic Sensor API.	Edge ≤79	Firefox No	IE No	Opera 56	Safari No	WebView Android 54 54 69 Based on Generic Sensor API.	Chrome Android 54 54 69 Based on Generic Sensor API.	Firefox Android No	Opera Android 48	Safari iOS No	Samsung Internet Android 6.0 6.0 10.0 Based on Generic Sensor API.
illuminance	Chrome 54 54 69 Based on Generic Sensor API. 79 Stopped returning floats and returned integers avoid fingerprinting.	Edge ≤79	Firefox No	IE No	Opera 56	Safari No	WebView Android 54 54 69 Based on Generic Sensor API. 79 Stopped returning floats and returned integers avoid fingerprinting.	Chrome Android 54 54 69 Based on Generic Sensor API. 79 Stopped returning floats and returned integers avoid fingerprinting.	Firefox Android No	Opera Android 48	Safari iOS No	Samsung Internet Android 6.0 6.0 10.0 Based on Generic Sensor API.

图例

完整支持

完整支持

不支持

不支持

见实现注意事项。

元数据

• 最后修改： 2019 年 3 月 23 日

相关话题

1. AmbientLightSensor
2. 构造函数

   1. AmbientLightSensor()
3. 特性

   1. illuminance
4. 继承：

   1. 传感器
   2. EventTarget