WebDriver-Funktionen

Fähigkeiten können verwendet werden, um einen Treiber anzufordern, der einen bestimmten Satz von Funktionen unterstützt. Dies kann verwendet werden, um bestimmte Browserfunktionen wie die Fähigkeit zum Ändern der Fensterausmaße anzufordern, wird aber auch in verteilten Umgebungen verwendet, um eine bestimmte Browserkonfiguration aus einer Matrix von Auswahlmöglichkeiten auszuwählen.

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

Das Fähigkeiten-Objekt ist ein Auswahlmechanismus, der begrenzt, welche Treiberkonfigurationen der Server zurückgeben wird. Wenn Sie beispielsweise eine Firefox-Instanz 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 egal, welches Betriebssystem oder welchen Webbrowser Ihre Sitzung hat: Sie möchten einfach eine Sitzung, die über eine bestimmte Fähigkeit verfügt.

Der Auswahlprozess oder die Aushandlung der Fähigkeiten erfolgt durch alwaysMatch und firstMatch.

Wie der Name schon sagt, sind Fähigkeiten, die innerhalb des alwaysMatch-Fähigkeiten-Objekts beschrieben werden, Funktionen, die Sie erfordern, dass die Sitzung sie hat. Wenn der Server nicht in der Lage ist, die von Ihnen angeforderten Funktionen bereitzustellen, wird er scheitern.

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

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

Das firstMatch-Feld akzeptiert ein Array von Fähigkeiten-Objekten, das nacheinander abgeglichen wird, bis eines mit dem übereinstimmt, was der Server bereitstellen kann, oder es wird fehlschlagen.

Dies kann nützlich sein, wenn Sie einen Treiber möchten, der unter macOS oder Linux ausgeführt wird, aber nicht unter Windows:

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

firstMatch kann natürlich mit alwaysMatch kombiniert werden, um die Auswahl einzugrenzen. Wenn Sie beispielsweise einen Treiber wünschen, der unter macOS oder Linux läuft, aber es muss Firefox sein:

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

Das vorherige Beispiel ist genau gleichwertig damit, die Firefox-Anforderung in jedem firstMatch-Arm zu setzen:

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

Welche der beiden vorhergehenden Beispiele Sie wählen, ist nicht wichtig, aber es kann von Bedeutung sein, wenn Sie Browserkonfigurationen weitergeben. Um zu vermeiden, dass Daten unnötig wiederholt werden, wie z. B. Profile, ist es ratsam, alwaysMatch zu verwenden, damit diese Daten nur einmal über die Leitung ü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" }]
  }
}

• browserName
• browserVersion
• platformName
• acceptInsecureCerts: Diese Fähigkeit kommuniziert, ob abgelaufene oder ungültige TLS-Zertifikate beim Navigieren überprüft werden. Wenn die Fähigkeit falsch ist, wird ein unsicheres Zertifikat Fehler zurückgegeben, wenn die Navigation auf Domains mit Zertifikatproblemen stößt. Andernfalls werden selbstsignierte oder anderweitig ungültige Zertifikate implizit vom Browser beim Navigieren vertraut. Die Fähigkeit hat Wirkung für die Dauer der Sitzung.
• pageLoadStrategy
• proxy
• setWindowRect
• timeouts
• unhandledPromptBehavior
• webSocketUrl

Zusätzlich zu den Standardfähigkeiten ermöglicht WebDriver dritten Parteien, die Menge der Fähigkeiten zu erweitern, um ihren Bedürfnissen gerecht zu werden. Browser-Anbieter und Lieferanten von Treibern verwenden typischerweise Erweiterungsfähigkeiten, um die Konfiguration des Browsers bereitzustellen, aber sie können auch von Zwischenstellen für beliebige Informationsbrocken verwendet werden.

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

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

Das Konvertieren eines veralteten Fähigkeiten-Objekts in den neuen Stil ist einfach. Das Erste, was Sie wissen müssen, ist, dass alwaysMatch/firstMatch immer innerhalb eines capabilities-JSON-Objekts eingewickelt ist, während desiredCapabilities/requiredCapabilities auf oberster Ebene existieren. Allgemein gesagt, sollte alles, was zuvor in desiredCapabilities ging, in einen firstMatch-Zweigarm verschoben werden, um denselben Effekt zu erzielen.

Nehmen Sie dieses veraltete Fähigkeiten-Objekt:

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

Dieses wäre im neuen Stil funktional gleichwertig:

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

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

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

• Befehl Neue Sitzung
• Befehl Sitzung löschen