Delete Virtual Sensor

The Delete Virtual Sensor command of the WebDriver API removes a virtual sensor previously created using the Create Virtual Sensor command. After the virtual sensor is deleted, the Sensor APIs once again use the real platform sensor of that type, if one is available.

Syntax

MethodURI template
DELETE/session/{session id}/sensor/{type}

URL parameters

session id

Identifier of the session.

type

The virtual sensor type to delete. Possible values include "ambient-light", "accelerometer", and "gyroscope".

Return value

null if successful.

Errors

invalid session id

Session does not exist.

invalid argument

No virtual sensor of the given type exists.

Examples

undefined

Deleting a virtual sensor

With a WebDriver server running on localhost:4444, assume a virtual "ambient-light" sensor has been created for the active session. To remove it, send a DELETE request with the sensor type appended to the endpoint, replacing ID with the sessionId from the New Session response:

bash
curl -i -X DELETE http://localhost:4444/session/ID/sensor/ambient-light

The server responds with a null value to indicate success:

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

{"value":null}

Specifications

See also