firefoxOptions

Beginnend mit Geckodriver 0.26.0 existieren zusätzliche Fähigkeiten, wenn Firefox oder eine Anwendung, die GeckoView einbettet, auf Android kontrolliert werden soll:

androidPackage (String, erforderlich)

Der Paketname von Firefox, z.B., org.mozilla.firefox, org.mozilla.firefox_beta, oder org.mozilla.fennec, abhängig vom Release-Kanal, oder der Paketname der Anwendung, die GeckoView einbettet, z.B. org.mozilla.geckoview_example.

androidActivity (String, optional)

Der vollständig qualifizierte Klassenname der zu startenden Aktivität, z.B. .GeckoViewActivity. Wenn nicht angegeben, wird die Standardaktivität des Pakets verwendet.

androidDeviceSerial (String, optional)

Die Seriennummer des Geräts, auf dem die Anwendung gestartet werden soll. Wenn nicht angegeben und mehrere Geräte angeschlossen sind, wird ein Fehler zurückgegeben.

androidIntentArguments (Array von Strings, optional)

Argumente, um das Intent zu starten. Intern verwendet Geckodriver Android am, um die Android-Anwendung unter Test zu starten. Die angegebenen Intent-Argumente werden dem am start-Befehl hinzugefügt. Siehe Androids Spezifikation für Intent-Argumente für Details. Dies ermöglicht die Kontrolle, wie die Anwendung gestartet wird, und das Einbeziehen optionaler Extras zum Aktivieren und Deaktivieren von Funktionen. Zum Beispiel, um mit der Ansichtsaktion und einer angegebenen URL vor dem Navigieren als Teil eines Tests zu starten, beinhalten Sie:

{
  "androidIntentArguments": [
    "-a",
    "android.intent.action.VIEW",
    "-d",
    "https://example.com"
  ]
}

Zum Beispiel, um ein Boolean Extra zu spezifizieren, das mit android.content.Intent.getBooleanExtra verarbeitet werden kann, beinhalten Sie:

{
  "androidIntentArguments": ["--ez", "customBooleanFlagName", "true"]
}

env (Env-Objekt)

Mapping von Umgebungsvariablennamen zu Umgebungsvariablenwerten, die beide Strings sein müssen, und an den Anwendungsprozess auf dem Android-Gerät weitergeleitet werden.

Ein JSON-Objekt, das eines dieser Felder haben kann:

level (String)

Setzen Sie das Detaillevel der Protokollierung von Geckodriver und Firefox. Verfügbare Level sind trace, debug, config, info, warn, error, und fatal. Wenn undefiniert, ist der Standard info. Der Wert wird ohne Berücksichtigung der Groß-/Kleinschreibung behandelt.

Ein JSON-Objekt mit einem Eintrag pro zu setzender Präferenz. Die Präferenz wird im Profil geschrieben, bevor Firefox gestartet wird. Eine vollständige Liste verfügbarer Präferenzen ist durch den Besuch von "about:config" in Ihrem Firefox-Browser erhältlich. Einige davon sind in dieser Quelle dokumentiert.

Ein Beispiel für ein Präferenz-Objekt:

{
  "dom.ipc.processCount": 8,
  "javascript.options.showInConsole": false
}

Ein JSON-Objekt mit einem Eintrag pro Umgebungsvariable, die gesetzt werden soll. Auf dem Desktop wird der zu testende Firefox mit der angegebenen Variablen in seiner Umgebung gestartet. Auf Android wird die GeckoView-basierte App die angegebene Variable in den env-Block in ihrer Konfigurations-YAML haben.

Ein Beispiel für ein Env-Objekt:

{
  "MOZ_LOG": "nsHttp:5",
  "MOZ_LOG_FILE": "/mnt/sdcard/log"
}

Das folgende ist ein Beispiel für ein vollständiges Fähigkeitsobjekt, das eine spezifische Firefox-Binärdatei auswählt, um mit einem vorbereiteten Profil aus dem Dateisystem im Headless-Modus zu laufen. Es erhöht auch die Anzahl der IPC-Prozesse durch eine Präferenz, schaltet Chrome-Fehler/Warnungen in der Konsole aus und aktiviert eine detailliertere Protokollierung:

{
  "capabilities": {
    "alwaysMatch": {
      "moz:firefoxOptions": {
        "binary": "/usr/local/firefox/bin/firefox",
        "args": ["-headless", "-profile", "/path/to/my/profile"],
        "prefs": {
          "dom.ipc.processCount": 8,
          "javascript.options.showInConsole": false
        },
        "log": { "level": "trace" },
        "env": {
          "MOZ_LOG": "nsHttp:5",
          "MOZ_LOG_FILE": "/path/to/my/profile/log"
        }
      }
    }
  }
}

Das moz:firefoxOptions muss—wie oben—innerhalb von alwaysMatch oder in einem der firstMatch Fähigkeitenobjekte platziert werden, wie hier zu sehen ist:

{
  "capabilities": {
    "firstMatch": [
      {"moz:firefoxOptions": …}
    ]
  }
}

Dies führt die GeckoView-Beispielanwendung aus, wie sie auf dem ersten Android-Emulator läuft, der auf dem Host-Computer läuft:

{
  "capabilities": {
    "alwaysMatch": {
      "moz:firefoxOptions": {
        "androidPackage": "org.mozilla.geckoview_example",
        "androidActivity": "org.mozilla.geckoview_example.GeckoView",
        "androidDeviceSerial": "emulator-5554",
        "androidIntentArguments": ["-d", "http://example.org"],
        "env": {
          "MOZ_LOG": "nsHttp:5",
          "MOZ_LOG_FILE": "/mnt/sdcard/log"
        }
      }
    }
  }
}

• Geckodrivers Dokumentation zu unterstützten Firefox-Fähigkeiten
• Chrome-spezifische WebDriver-Fähigkeiten (goog:chromeOptions))
• Liste der WebDriver-Fähigkeiten
• Neuer Sitzungsbefehl