WebDriver klassische Fähigkeiten

Fähigkeitenverhandlung

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 anzufordern, wie z. B. die Fähigkeit, die Fensterdimensionen zu ändern, wird aber auch in verteilten Umgebungen verwendet, um eine bestimmte Browserkonfiguration aus einer Matrix von Optionen auszuwählen.

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

Das Fähigkeitenobjekt ist ein Auswahlmechanismus, der einschränkt, welche Treiberkonfigurationen der Server zurückgibt. Wenn Sie 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 manchmal ist es Ihnen vielleicht egal, welches spezifische Betriebssystem oder welcher Browser Ihre Sitzung hat: Sie möchten einfach nur eine Sitzung, die eine bestimmte Fähigkeit hat.

Der Auswahlprozess oder die Fähigkeitenverhandlung erfolgt über alwaysMatch und firstMatch.

alwaysMatch

Wie der Name schon sagt, sind Fähigkeiten, die im alwaysMatch-Fähigkeitenobjekt beschrieben sind, Merkmale, die Sie von der Sitzung erwarten. Wenn der Server die angeforderten Merkmale nicht bereitstellen kann, schlägt die Anforderung fehl.

Wenn Sie beispielsweise Firefox Version 62 auf einem System anfordern, das nur Version 60 installiert hat, schlägt die Sitzungerstellung fehl:

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

firstMatch

Das firstMatch-Feld akzeptiert ein Array von Fähigkeitenobjekten, die nacheinander abgeglichen werden, bis eines zu dem passt, was der Server bereitstellen kann, oder es schlägt fehl.

Dies kann nützlich sein, wenn Sie einen Treiber benötigen, der unter macOS oder Linux, aber nicht unter Windows läuft:

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

Kombination von alwaysMatch und firstMatch

firstMatch kann selbstverständlich mit alwaysMatch kombiniert werden, um die Auswahl einzuschränken. Wenn Sie beispielsweise einen Treiber benötigen, der unter macOS oder Linux läuft, es muss jedoch Firefox sein:

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

Das vorherige Beispiel ist genau äquivalent dazu, die Firefox-Anforderung in jedem firstMatch-Zweig zu platzieren:

{
  "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 Browsereinstellungen weitergeben. Um zu vermeiden, dass Daten unnötig oft, wie beispielsweise Profile, wiederholt werden, 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" }]
  }
}

Liste der Fähigkeiten

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

Anbieter-spezifische Fähigkeiten

Zusätzlich zu den standardmäßigen Fähigkeiten ermöglicht WebDriver Drittanbietern, das Set an Fähigkeiten zu erweitern, um ihren Anforderungen gerecht zu werden. Browseranbieter und Anbieter von Treibern verwenden in der Regel erweiterte Fähigkeiten, um Konfigurationen an den Browser zu übermitteln, sie können jedoch auch von Zwischeninstanzen für beliebige Informationen verwendet werden.

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

Veraltete Fähigkeiten

Die Mehrheit der Selenium-Clients verwendet desiredCapabilities und requiredCapabilities, um eine 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ähigkeitenobjekts in den neuen Stil ist einfach. Zuerst müssen Sie wissen, dass alwaysMatch/firstMatch immer innerhalb eines capabilities JSON-Objekts eingeschlossen ist, während desiredCapabilities/requiredCapabilities auf der obersten Ebene existieren. Generell sollte alles, was zuvor in desiredCapabilities eingefügt wurde, in einen firstMatch-Zweigarm verschoben werden, um den gleichen Effekt zu erzielen.

Nehmen wir dieses veraltete Fähigkeitenobjekt:

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

Dies wäre funktional äquivalent im neuen Stil:

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

Da es jedoch nur einen firstMatch-Zweigarm gibt und wir wissen, dass die Sitzungerstellung fehlschlägt, wenn der Server keinen Firefox installiert hat, ist es auch gleichwertig zu diesem:

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

Siehe auch

• Neue Sitzung Befehl
• Sitzung löschen Befehl