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

Update Virtual Sensor Reading

· 52CE 我爱测

The _Update Virtual Sensor Reading_ command of the WebDriver API provides a new reading for a virtual sensor previously created using the Create Virtual Sensor command. The new reading is made available to platform sensors through the Sensor APIs, letting tests drive sensor-depen

The Update Virtual Sensor Reading command of the WebDriver API provides a new reading for a virtual sensor previously created using the Create Virtual Sensor command. The new reading is made available to platform sensors through the Sensor APIs, letting tests drive sensor-dependent behavior with predetermined data.

Syntax

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

URL parameters

  • session id
    • : Identifier of the session.
  • type
    • : The virtual sensor type to update. Possible values include "ambient-light", "accelerometer", and "gyroscope".

Payload

The input is an object:

  • reading
    • : An object representing the new sensor reading. The properties it must contain depend on the sensor type; for example, an "ambient-light" sensor expects an illuminance value.

Return value

null if successful.

Errors

  • invalid session id
    • : Session does not exist.
  • invalid argument
    • : The type is not a supported virtual sensor type, no virtual sensor of that type exists, the reading is not an object, or the reading is not valid for the given sensor type.

Examples

Updating a virtual sensor reading

With a WebDriver server running on localhost:4444, assume a virtual "ambient-light" sensor has been created for the active session. To set a new reading, send the reading object in the request payload, replacing ID with the sessionId from the New Session response:

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

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

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

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