Update Virtual Sensor Reading

Syntax

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

• Create Virtual Sensor command
• Get Virtual Sensor Information command
• Delete Virtual Sensor command
• Sensor APIs