The Get Virtual Sensor Information command of the WebDriver API returns information about a virtual sensor previously created using the Create Virtual Sensor command. It reports the sampling frequency currently requested by the page, which lets a test confirm that the Sensor APIs are consuming readings at the expected rate.
Syntax
| Method | URI template |
|---|---|
GET |
/session/{session id}/sensor/{type} |
URL parameters
session id- : Identifier of the session.
type- : The virtual sensor type to query. Possible values include
"ambient-light","accelerometer", and"gyroscope".
- : The virtual sensor type to query. Possible values include
Return value
An object with the following field:
requestedSamplingFrequency- : A number, in hertz, providing the sampling frequency currently requested for the virtual sensor. This value is bounded by the minimum and maximum sampling frequencies that were set when the sensor was created.
Errors
invalid session id- : Session does not exist.
invalid argument- : No virtual sensor of the given
typeexists.
- : No virtual sensor of the given
Examples
Getting virtual sensor information
With a WebDriver server running on localhost:4444, assume a virtual "ambient-light" sensor has been created for the active session. To read its information, append the sensor type to the endpoint, replacing ID with the sessionId from the New Session response:
curl -i http://localhost:4444/session/ID/sensor/ambient-light
The server responds with the currently requested sampling frequency:
HTTP/1.1 200 OK
content-type: application/json; charset=utf-8
{"value":{"requestedSamplingFrequency":60}}
Specifications
Browser compatibility
See also
- Create Virtual Sensor command
- Update Virtual Sensor Reading command
- Delete Virtual Sensor command
- Sensor APIs
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
