firefoxOptions

Android

Seit geckodriver 0.26.0 existieren zusätzliche Fähigkeiten, wenn Firefox oder eine Anwendung, die GeckoView einbettet, auf Android kontrolliert 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 zu startenden Aktivität, z.B. .GeckoViewActivity. Wenn nicht angegeben, wird die Standardaktivität des Pakets verwendet.

androidDeviceSerial (Zeichenkette, optional)

Die Seriennummer des Gerätes, 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. Intern verwendet geckodriver Android am, um die zu testende Android-Anwendung zu starten. Die angegebenen Intent-Argumente werden dem Befehl am start hinzugefügt. 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 Ansicht Aktion und einer bestimmten URL zu starten, bevor als Teil eines Tests navigiert wird, fügen Sie ein:

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

Zum Beispiel, um ein boolesches Extra zu spezifizieren, das mit android.content.Intent.getBooleanExtra verarbeitet werden kann, fügen Sie ein:

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

env (Umgebungs-Objekt)

Map von Umgebungsvariablenname zu Umgebungsvariablenwert, beide müssen Zeichenketten sein, die an den Anwendungsprozess weitergeleitet werden, der auf dem Android-Gerät läuft.

Log-Objekt

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

level (Zeichenkette)

Setzt das Detailgradniveau für geckodriver und Firefox. Verfügbare Ebenen sind trace, debug, config, info, warn, error und fatal. Wenn nicht anders angegeben, ist der Standardwert info. Der Wert ist nicht empfindlich gegenüber Groß-/Kleinschreibung.

Preferences-Objekt

Ein JSON-Objekt mit einem Eintrag pro einzustellender Präferenz. Die Präferenz wird in das Profil geschrieben, bevor Firefox gestartet wird. Eine vollständige Liste der verfügbaren Einstellungen ist verfügbar, indem Sie "about:config" in Ihrem Firefox-Browser besuchen. Einige davon sind in dieser Quelle dokumentiert.

Ein Beispiel für ein Preferences-Objekt:

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

Env-Objekt

Ein JSON-Objekt mit einem Eintrag pro einzustellender Umgebungsvariable. Auf dem Desktop wird das zu testende Firefox mit der angegebenen Variablen in seiner Umgebung gestartet. Auf Android wird die auf GeckoView basierende App die angegebene Variable im env Block in ihrer YAML-Konfigurationsdatei haben.

Ein Beispiel für ein Env-Objekt:

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

Beispiel

Der folgende ist ein Beispiel für ein vollständiges Capabilities-Objekt, das ein spezifisches Firefox-Binärprogramm auswählt, um mit einem vorbereiteten Profil vom Dateisystem im Headless Mode ausgeführt zu werden. Es erhöht auch die Anzahl der IPC-Prozesse durch eine Präferenz, schaltet Chrome-Fehler/Warnungen in der Konsole aus und aktiviert 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"
        }
      }
    }
  }
}

moz:firefoxOptions muss—wie oben gezeigt—innerhalb von alwaysMatch platziert werden oder in einem der firstMatch Capabilities Objekte, wie hier gezeigt:

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

Android

Dies führt die GeckoView-Beispielanwendung aus, die auf dem ersten Android-Emulator auf dem Host-Computer 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"
        }
      }
    }
  }
}

Siehe auch

• geckodriver's Dokumentation zu unterstützten Firefox-Fähigkeiten
• Chrome-spezifische WebDriver-Fähigkeiten (goog:chromeOptions))
• Liste von WebDriver-Fähigkeiten
• New Session-Befehl