firefoxOptions

Android

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

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. Falls nicht angegeben, wird die Standardaktivität des Pakets verwendet.

androidDeviceSerial (string, optional)

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

androidIntentArguments (Array von Strings, optional)

Argumente, um den Intent zu starten. Hinter den Kulissen verwendet geckodriver Android am, um die zu testende Android-Anwendung zu starten. Die angegebenen Intent-Argumente werden an den am start-Befehl angehängt. Siehe Androids Spezifikation für Intent-Argumente für Details. Dies erlaubt es, zu steuern, wie die Anwendung gestartet wird, und optionale Extras zum Aktivieren und Deaktivieren von Funktionen einzuschließen. Um beispielsweise mit der Ansichtaktionen und einer angegebenen URL zu starten, bevor Sie als Teil eines Tests navigieren, fügen Sie hinzu:

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

Um beispielsweise ein Boolean-Extra anzugeben, das mit android.content.Intent.getBooleanExtra verarbeitet werden kann, fügen Sie hinzu:

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

env (Env-Objekt)

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

Log-Objekt

Ein JSON-Objekt, das eines der folgenden Felder haben kann:

level (string)

Setzt das Detaillevel der Protokollierung für geckodriver und Firefox. Verfügbare Level sind trace, debug, config, info, warn, error und fatal. Wenn nicht definiert, ist der Standard info. Der Wert wird ohne Beachtung der Groß- und Kleinschreibung behandelt.

Preferences-Objekt

Ein JSON-Objekt mit einem Eintrag pro zu setzender Präferenz. Die Präferenz wird in das Profile geschrieben, bevor Firefox gestartet wird. Eine vollständige Liste der verfügbaren Präferenzen ist beim Aufrufen von "about:config" im Firefox-Browser ersichtlich. Einige davon sind in dieser Quelle dokumentiert.

Ein Beispiel eines Preference-Objekts:

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

Env-Objekt

Ein JSON-Objekt mit einem Eintrag pro zu setzender Umgebungsvariable. Auf dem Desktop wird der zu testende Firefox mit der gegebenen Variablen in seiner Umgebung gestartet. Auf Android wird die GeckoView-basierte App die gegebene Variable zum env-Block in ihrer Konfigurations-YAML hinzufügen.

Ein Beispiel eines Env-Objekts:

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

Beispiel

Das Folgende ist ein Beispiel für ein vollständiges Fähigkeitsobjekt, das eine spezifische Firefox-Binärdatei auswählt, um sie mit einem vorbereiteten Profile aus dem Dateisystem im Headless-Modus auszuführen. Es erhöht außerdem die Anzahl der IPC-Prozesse durch eine Präferenz, schaltet Chrome-Fehler/Warnungen in der Konsole aus und aktiviert mehr detaillierte 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"
        }
      }
    }
  }
}

Die moz:firefoxOptions müssen—wie oben—innerhalb von alwaysMatch platziert werden, oder in einem der firstMatch Capabilities-Objekte, wie hier zu sehen:

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

Android

Dies führt die GeckoView-Beispielanwendung aus, wie sie auf dem ersten auf dem Hostsystem laufenden Android-Emulator 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-Dokumentation zu unterstützten Firefox-Fähigkeiten
• Chrome-spezifische WebDriver-Fähigkeiten (goog:chromeOptions))
• Liste der WebDriver-Fähigkeiten
• Neuer Sitzungsbefehl