Erstellen eines virtuellen Sensors
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 Erstellen eines virtuellen Sensors Befehl der WebDriver API erstellt einen virtuellen Sensor eines bestimmten Typs, der den Plattform-Sensor desselben Typs überschreibt. Dies ermöglicht es Tests, die Sensor-APIs mit vorab festgelegten Messwerten zu nutzen, anstatt sich auf reale Hardware zu verlassen. Während der virtuelle Sensor existiert, verwenden neue Verbindungen zu einem Sensor desselben Typs im obersten Browsing-Kontext den virtuellen Sensor anstelle des Plattform-Sensors.
Hinweis: Sensorinstanzen desselben Typs können koexistieren und verschiedene Gerätesensoren verwenden. Ein Sensor, der bereits mit einem echten, hardwarebasierten Sensor verbunden ist, erhält weiterhin Messwerte von diesem und wechselt nur dann zum virtuellen Sensor, wenn er erneut verbunden wird.
Syntax
| Methode | URI-Vorlage |
|---|---|
POST |
/session/{session id}/sensor |
URL-Parameter
session id-
Kennung der Sitzung.
Nutzlast
Die Eingabe ist ein Objekt:
type-
Ein String, der den zu erstellenden virtuellen Sensortyp identifiziert. Mögliche Werte sind unter anderem
"ambient-light","accelerometer"und"gyroscope". Im obersten Browsing-Kontext kann jeweils nur ein virtueller Sensor eines bestimmten Typs existieren. connectedOptional-
Ein Boolescher Wert, der angibt, ob der Sensor in der Lage ist, Messwerte bereitzustellen. Standardwert ist
true. maxSamplingFrequencyOptional-
Eine Zahl in Hertz, die die obere Grenze der Abtastfrequenz angibt, die der virtuelle Sensor unterstützt.
minSamplingFrequencyOptional-
Eine Zahl in Hertz, die die untere Grenze der Abtastfrequenz angibt, die der virtuelle Sensor unterstützt.
Rückgabewert
null bei Erfolg.
Fehler
ungültige Sitzungs-ID-
Sitzung existiert nicht.
ungültiges Argument-
Der
typeist kein String, es handelt sich um einen nicht unterstützten virtuellen Sensortyp oder ein virtueller Sensor dieses Typs existiert bereits. Die angegebenen Abtastfrequenzwerte sind ungültig, wenn sie keine Zahlen sind oder wenn dieminSamplingFrequencygrößer als diemaxSamplingFrequencyist.
Beispiele
Erstellen eines virtuellen Sensors
Mit einem WebDriver-Server, der auf localhost:4444 läuft, wird davon ausgegangen, dass eine aktive Sitzung erstellt wurde. Um einen virtuellen AmbientLightSensor zu erstellen, senden Sie seinen Typ in der Nutzlast der Anfrage und ersetzen ID durch die sessionId aus der Antwort der Neuen Sitzung:
curl -i -H "Content-Type: application/json" \
-d '{"type": "ambient-light"}' \
http://localhost:4444/session/ID/sensor
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 # create-virtual-sensor-command |