firefoxOptions

Ab geckodriver 0.26.0 existieren zusätzliche Fähigkeiten, wenn Firefox oder eine Anwendung, die GeckoView einbettet, auf Android gesteuert werden muss:

androidPackage (Zeichenkette, 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 (Zeichenkette, optional)

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

androidDeviceSerial (Zeichenkette, 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 Zeichenketten, optional)

Argumente, um den Intent zu starten. Unter der Haube verwendet geckodriver Android am, um die Android-Anwendung unter Test zu starten. Die angegebenen Intent-Argumente werden dem am start-Befehl angehängt. Siehe Androids Spezifikation für Intent-Argumente für Details. Dies ermöglicht die Steuerung, wie die Anwendung gestartet wird, und das Hinzufügen optionaler Extras zum Aktivieren und Deaktivieren von Funktionen. Zum Beispiel, um mit der Ansichtaktion und einer angegebenen URL vor dem Navigieren als Teil eines Tests zu starten, schließen Sie ein:

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

Zum Beispiel, um eine Boolean-Zusatzoption anzugeben, die mit android.content.Intent.getBooleanExtra verarbeitet werden kann, schließen Sie ein:

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

env (Env-Objekt)

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

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

level (Zeichenkette)

Setzt das Verbositätslevel von geckodriver und Firefox. Verfügbare Levels sind trace, debug, config, info, warn, error und fatal. Wenn undefiniert bleibt, ist der Standard info. Der Wert wird ohne Berücksichtigung der Groß- und Kleinschreibung behandelt.

Ein JSON-Objekt mit einem Eintrag pro einzustellender Präferenz. Die Präferenz wird ins Profil geschrieben, bevor Firefox startet. Eine vollständige Liste der verfügbaren Präferenzen ist erhältlich, indem "about:config" in Ihrem Firefox-Browser besucht wird. Einige davon sind in dieser Quelle dokumentiert.

Ein Beispiel eines Präferenzobjekts:

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

Ein JSON-Objekt mit einem Eintrag pro Umgebungsvariable, die eingestellt werden soll. Auf dem Desktop wird das getestete Firefox mit der gegebenen Variable in seiner Umgebung gestartet. Auf Android, wird der App basierend auf GeckoView die gegebene Variable zum env-Block in ihrer Konfigurations-YAML hinzugefügt.

Ein Beispiel eines Env-Objekts:

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

Das Folgende ist ein Beispiel eines vollständigen Fähigkeiten-Objekts, das eine spezifische Firefox-Binärdatei auswählt, die mit einem vorbereiteten Profil vom Dateisystem im kopflose Modus ausgeführt werden soll. 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 gezeigt – innerhalb von alwaysMatch, oder in einem der firstMatch Fähigkeiten-Objekte wie hier:

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

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

{
  "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"
        }
      }
    }
  }
}

• geckodriver-Dokumentation zu unterstützten Firefox-Fähigkeiten
• Chrome-spezifische WebDriver-Fähigkeiten (goog:chromeOptions)
• Liste der WebDriver-Fähigkeiten
• Neue Sitzung Befehl