Aktualisieren der virtuellen Sensorablesung
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more browser support for this feature? Tell us why.
Der Befehl Aktualisieren der virtuellen Sensorablesung der WebDriver API stellt eine neue Ablesung für einen virtuellen Sensor bereit, der zuvor mit dem Befehl Virtuellen Sensor erstellen erstellt wurde. Die neue Ablesung wird den Plattform-Sensoren über die Sensor APIs zur Verfügung gestellt, sodass Tests sensorabhängiges Verhalten mit vorbestimmten Daten steuern können.
Syntax
| Methode | URI-Vorlage |
|---|---|
POST |
/session/{session id}/sensor/{type} |
URL-Parameter
session id-
Kennung der Sitzung.
type-
Der virtuelle Sensortyp, der aktualisiert werden soll. Mögliche Werte sind unter anderem
"ambient-light","accelerometer"und"gyroscope".
Nutzlast
Die Eingabe ist ein Objekt:
reading-
Ein Objekt, das die neue Sensorablesung darstellt. Die Eigenschaften, die es enthalten muss, hängen vom Sensor
typeab; beispielsweise erwartet ein"ambient-light"Sensor einenilluminanceWert.
Rückgabewert
null bei Erfolg.
Fehler
invalid session id-
Sitzung existiert nicht.
invalid argument-
Der
typeist kein unterstützter virtueller Sensortyp, es existiert kein virtueller Sensor dieses Typs, dasreadingist kein Objekt oder die Ablesung ist für den gegebenen Sensortypenicht gültig.
Beispiele
Aktualisieren einer virtuellen Sensorablesung
Bei einem laufenden WebDriver-Server auf localhost:4444 wird angenommen, dass ein virtueller "ambient-light" Sensor für die aktive Sitzung erstellt wurde. Um eine neue Ablesung festzulegen, senden Sie das reading Objekt in der Anfrage-Nutzlast und ersetzen Sie ID durch die sessionId aus der Antwort der Neuen Sitzung:
curl -i -H "Content-Type: application/json" \
-d '{"reading": {"illuminance": 42}}' \
http://localhost:4444/session/ID/sensor/ambient-light
Der Server antwortet mit einem null Wert, um den Erfolg anzuzeigen:
HTTP/1.1 200 OK
content-type: application/json; charset=utf-8
{"value":null}
Spezifikationen
| Spezifikation |
|---|
| Generic Sensor API # update-virtual-sensor-reading-command |