大网数据广告活动
Web 标准与前端开发

Create Virtual Sensor

· 52CE 我爱测

The _Create Virtual Sensor_ command of the WebDriver API creates a virtual sensor of a given type, which overrides the platform sensor of the same type. This lets tests exercise the Sensor APIs with predetermined readings instead of relying on real hardware. While the virtual sen

The Create Virtual Sensor command of the WebDriver API creates a virtual sensor of a given type, which overrides the platform sensor of the same type. This lets tests exercise the Sensor APIs with predetermined readings instead of relying on real hardware. While the virtual sensor exists, new connections to a sensor of the same type in the top-level browsing context use the virtual sensor instead of the platform sensor.

[!NOTE] Sensor instances of the same type can coexist and use different device sensors. A sensor already connected to a real, hardware sensor continues receiving readings from it and switches to the virtual sensor only if it connects again.

Syntax

Method URI template
POST /session/{session id}/sensor

URL parameters

  • session id
    • : Identifier of the session.

Payload

The input is an object:

  • type
    • : A string identifying the virtual sensor type to create. Possible values include "ambient-light", "accelerometer", and "gyroscope". Only one virtual sensor of a given type can exist at a time in the top-level browsing context.
  • connected
    • : A boolean indicating whether the sensor is able to provide readings. Defaults to true.
  • maxSamplingFrequency
    • : A number, in hertz, specifying the upper bound of the sampling frequency that the virtual sensor supports.
  • minSamplingFrequency
    • : A number, in hertz, specifying the lower bound of the sampling frequency that the virtual sensor supports.

Return value

null if successful.

Errors

  • invalid session id
    • : Session does not exist.
  • invalid argument
    • : The type is not a string, is not a supported virtual sensor type, or a virtual sensor of that type already exists. The specified sampling frequency values are invalid if they are not a number or if minSamplingFrequency is greater than maxSamplingFrequency.

Examples

Creating a virtual sensor

With a WebDriver server running on localhost:4444, assume an active session has been created. To create a virtual AmbientLightSensor, send its type in the request payload, replacing ID with the sessionId from the New Session response:

curl -i -H "Content-Type: application/json" \
  -d '{"type": "ambient-light"}' \
  http://localhost:4444/session/ID/sensor

The server responds with a null value to indicate success:

HTTP/1.1 200 OK
content-type: application/json; charset=utf-8

{"value":null}

Specifications

Browser compatibility

See also

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。