WebDriver-Fähigkeiten

Aushandlung von Fähigkeiten

Fähigkeiten können verwendet werden, um einen Treiber anzufordern, der eine bestimmte Teilmenge von Funktionen unterstützt. Dies kann genutzt werden, um bestimmte Browser-Funktionen zu verlangen, wie etwa die Fähigkeit, die Fenstergröße anzupassen, wird aber auch in verteilten Umgebungen verwendet, um eine bestimmte Browser-Konfiguration aus einer Vielzahl von Optionen auszuwählen.

Die Auswahl eines bestimmten Webbrowsers oder einer Plattform ergibt nur Sinn, wenn Sie einen Remote-WebDriver verwenden. In diesem Fall nimmt der Client Kontakt mit WebDriver über einen oder mehrere Zwischenknoten auf, die aushandeln, welchen Treiber Sie basierend auf den empfangenen Fähigkeiten erhalten.

Das Fähigkeitenobjekt ist ein Auswahlmechanismus, der einschränkt, welche Treiberkonfigurationen der Server zurückgibt. Wenn Sie ein Firefox-Exemplar mit browserName anfordern und Firefox nicht auf dem Remote installiert ist, oder macOS von einem Remote, das nur Linux unterstützt, haben Sie möglicherweise Pech. Aber gelegentlich ist es Ihnen vielleicht egal, welches spezifische Betriebssystem oder welcher Webbrowser Ihre Sitzung hat: Sie wollen einfach nur eine Sitzung, die eine bestimmte Fähigkeit hat.

Der Auswahlprozess, oder die Aushandlung von Fähigkeiten, erfolgt über alwaysMatch und firstMatch.

alwaysMatch

Wie der Name schon sagt, sind die im alwaysMatch-Fähigkeitenobjekt beschriebenen Fähigkeiten Funktionen, die die Sitzung erforderlich haben muss. Wenn der Server die von Ihnen geforderten Funktionen nicht bereitstellen kann, wird er scheitern.

Wenn Sie zum Beispiel Firefox Version 62 auf einem System anfordern, das nur 60 installiert hat, wird die Sitzungserstellung fehlschlagen:

{
  "capabilities": {
    "alwaysMatch": {
      "browserName": "firefox",
      "browserVersion": "60"
    }
  }
}

firstMatch

Das firstMatch-Feld akzeptiert ein Array von Fähigkeitenobjekten, die nacheinander abgeglichen werden, bis eines gefunden wird, das der Server bereitstellen kann, andernfalls wird es fehlschlagen.

Dies kann nützlich sein, wenn Sie einen Treiber möchten, der auf macOS oder Linux, aber nicht auf Windows läuft:

{
  "capabilities": {
    "firstMatch": [{ "platformName": "macos" }, { "platformName": "linux" }]
  }
}

Kombination von alwaysMatch und firstMatch

firstMatch kann natürlich mit alwaysMatch kombiniert werden, um die Auswahl einzugrenzen. Wenn Sie zum Beispiel einen Treiber möchten, der auf macOS oder Linux läuft, aber unbedingt Firefox sein muss:

{
  "capabilities": {
    "alwaysMatch": {
      "browserName": "firefox"
    },
    "firstMatch": [{ "platformName": "macos" }, { "platformName": "linux" }]
  }
}

Das vorherige Beispiel entspricht genau dem, dass die Firefox-Anforderung in jedem firstMatch-Zweig platziert wird:

{
  "capabilities": {
    "firstMatch": [
      { "browserName": "firefox", "platformName": "macos" },
      { "browserName": "firefox", "platformName": "linux" }
    ]
  }
}

Welche der beiden vorherigen Beispiele Sie wählen, ist nicht wichtig, aber es kann von Bedeutung sein, wenn Sie Browser-Konfigurationen weitergeben. Um zu vermeiden, Daten wie Profile unnötigerweise zu wiederholen, ist es ratsam, alwaysMatch zu verwenden, sodass diese Daten nur einmal übertragen werden:

{
  "capabilities": {
    "alwaysMatch": {
      "browserName": "firefox",
      "moz:firefoxOptions": {
        "profile": "<base64 encoded profile>",
        "args": ["-headless"],
        "prefs": { "dom.ipc.processCount": 8 },
        "log": { "level": "trace" }
      }
    },
    "firstMatch": [{ "platformName": "macos" }, { "platformName": "linux" }]
  }
}

Liste von Fähigkeiten

• browserName
• browserVersion
• platformName
• acceptInsecureCerts
• pageLoadStrategy
• proxy
• setWindowRect
• timeouts
• unhandledPromptBehavior
• webSocketUrl

Anbieter-spezifische Fähigkeiten

Zusätzlich zu den Standardfähigkeiten ermöglicht WebDriver Drittanbietern, den Satz von Fähigkeiten zu erweitern, um ihre Bedürfnisse anzupassen. Browserhersteller und Lieferanten von Treibern nutzen in der Regel Erweiterungsfähigkeiten, um Konfigurationen für den Browser bereitzustellen, aber sie können auch von Zwischenstellen für willkürliche Datenblöcke verwendet werden.

• Firefox Fähigkeiten (moz:firefoxOptions)
• Chrome Fähigkeiten (goog:chromeOptions)

Legacy-Fähigkeiten

Die Mehrheit der Selenium-Clients verwendet desiredCapabilities und requiredCapabilities, um die neue Sitzung zu konfigurieren. Diese sind sehr ähnlich zu den oben beschriebenen firstMatch und alwaysMatch. Einige Treiber unterstützen diese Legacy-Fähigkeiten, aber sie sind veraltet und sollten vermieden werden.

Ein Legacy-Fähigkeitenobjekt in den neuen Stil umzuwandeln ist einfach. Das erste, was Sie wissen müssen, ist, dass alwaysMatch/firstMatch immer in ein capabilities JSON-Objekt eingebettet ist, während desiredCapabilities/requiredCapabilities auf der obersten Ebene existiert. Im Allgemeinen sollte alles, was vorher in desiredCapabilities ging, in einen firstMatch-Zweig gebracht werden, um den gleichen Effekt zu erzielen.

Nehmen Sie dieses veraltete Fähigkeitenobjekt:

{ "desiredCapabilities": { "browserName": "firefox" } }

Dies wäre funktional äquivalent im neuen Stil:

{ "capabilities": { "firstMatch": [{ "browserName": "firefox" }] } }

Aber da es nur einen firstMatch-Zweig gibt und wir wissen, dass die Sitzungserstellung fehlschlagen wird, wenn der Server kein Firefox installiert hat, ist es auch gleichbedeutend mit diesem:

{ "capabilities": { "alwaysMatch": { "browserName": "firefox" } } }

Siehe auch

• Neue Sitzung Befehl
• Sitzung löschen Befehl