Funcionalidade específica do Firefox

Por omissão, Selenium 4 é compatível com Firefox 78 ou superior. Recomendamos que use sempre a versão mais recente do geckodriver.

Opções

Capacidades comuns a todos os navegadores estão descritas na página Opções.

Capacidades únicas ao Firefox podem ser encontradas na página da Mozilla para firefoxOptions

Este é um exemplo de como iniciar uma sessão Firefox com um conjunto de opções básicas:

• Java
• Python
• CSharp
• Ruby
• JavaScript
• Kotlin

    FirefoxOptions options = new FirefoxOptions();
    driver = new FirefoxDriver(options);

    options = webdriver.FirefoxOptions()
    driver = webdriver.Firefox(options=options)

            var options = new FirefoxOptions();
            driver = new FirefoxDriver(options);

      options = Selenium::WebDriver::Options.firefox
      @driver = Selenium::WebDriver.for :firefox, options: options

    driver = new Builder()
      .forBrowser(Browser.FIREFOX)
      .setFirefoxOptions(options)
      .build();

Alguns exemplos de uso com capacidades diferentes:

Argumentos

O parametro args é usado para indicar uma lista de opções ao iniciar o navegador. Opções mais frequentes incluem -headless e "-profile", "/path/to/profile"

Adicione uma opção:

• Java
• Python
• CSharp
• Ruby
• JavaScript
• Kotlin

    options.addArguments("-headless");

    options.add_argument("-headless")

            options.AddArgument("-headless");

      options.args << '-headless'

      .setFirefoxOptions(options.addArguments('--headless'))
      .build();

Iniciar navegador numa localização específica

O parametro binary é usado contendo o caminho para uma localização específica do navegador. Como exemplo, pode usar este parametro para indicar ao geckodriver a versão Firefox Nightly ao invés da versão de produção, quando ambas versões estão presentes no seu computador.

Adicionar uma localização:

• Java
• Python
• CSharp
• Ruby
• JavaScript
• Kotlin

    options.setBinary(getFirefoxLocation());

    options.binary_location = firefox_bin

            options.BinaryLocation = GetFirefoxLocation();

      options.binary = firefox_location

Perfis

Existem várias formas de trabalhar com perfis Firefox

FirefoxProfile profile = new FirefoxProfile();
FirefoxOptions options = new FirefoxOptions();
options.setProfile(profile);
driver = new RemoteWebDriver(options);
  

from selenium.webdriver.firefox.options import Options
from selenium.webdriver.firefox.firefox_profile import FirefoxProfile
options=Options()
firefox_profile = FirefoxProfile()
firefox_profile.set_preference("javascript.enabled", False)
options.profile = firefox_profile
  

var options = new FirefoxOptions();
var profile = new FirefoxProfile();
options.Profile = profile;
var driver = new RemoteWebDriver(options);
  

      profile = Selenium::WebDriver::Firefox::Profile.new
      profile['browser.download.dir'] = '/tmp/webdriver-downloads'
      options = Selenium::WebDriver::Firefox::Options.new(profile: profile)

const { Builder } = require("selenium-webdriver");
const firefox = require('selenium-webdriver/firefox');

const options = new firefox.Options();
let profile = '/path to custom profile';
options.setProfile(profile);
const driver = new Builder()
    .forBrowser('firefox')
    .setFirefoxOptions(options)
    .build();
  

val options = FirefoxOptions()
options.profile = FirefoxProfile()
driver = RemoteWebDriver(options)
  

Service

Service settings common to all browsers are described on the Service page.

Log output

Getting driver logs can be helpful for debugging various issues. The Service class lets you direct where the logs will go. Logging output is ignored unless the user directs it somewhere.

File output

To change the logging output to save to a specific file:

• Java
• Python
• CSharp
• Ruby
• JavaScript
• Kotlin

    FirefoxDriverService service =
        new GeckoDriverService.Builder().withLogFile(logLocation).build();

    service = webdriver.FirefoxService(log_output=log_path, service_args=['--log', 'debug'])

      service.log = file_name

Console output

To change the logging output to display in the console:

• Java
• Python
• CSharp
• Ruby
• JavaScript
• Kotlin

    FirefoxDriverService service =
        new GeckoDriverService.Builder().withLogOutput(System.out).build();

    service = webdriver.FirefoxService(log_output=subprocess.STDOUT)

      service.log = $stdout

Log level

There are 7 available log levels: fatal, error, warn, info, config, debug, trace. If logging is specified the level defaults to info.

Note that -v is equivalent to -log debug and -vv is equivalent to log trace, so this examples is just for setting the log level generically:

• Java
• Python
• CSharp
• Ruby
• JavaScript
• Kotlin

    FirefoxDriverService service =
        new GeckoDriverService.Builder().withLogLevel(FirefoxDriverLogLevel.DEBUG).build();

    service = webdriver.FirefoxService(log_output=log_path, service_args=['--log', 'debug'])

      service.args += %w[--log debug]

Truncated Logs

The driver logs everything that gets sent to it, including string representations of large binaries, so Firefox truncates lines by default. To turn off truncation:

• Java
• Python
• CSharp
• Ruby
• JavaScript
• Kotlin

    FirefoxDriverService service =
        new GeckoDriverService.Builder().withTruncatedLogs(false).build();

    service = webdriver.FirefoxService(service_args=['--log-no-truncate', '--log', 'debug'], log_output=log_path)

      service.args << '--log-no-truncate'

Profile Root

The default directory for profiles is the system temporary directory. If you do not have access to that directory, or want profiles to be created some place specific, you can change the profile root directory:

• Java
• Python
• CSharp
• Ruby
• JavaScript
• Kotlin

    FirefoxDriverService service =
        new GeckoDriverService.Builder().withProfileRoot(profileDirectory).build();

    service = webdriver.FirefoxService(service_args=['--profile-root', temp_dir])

      service.args += ['--profile-root', root_directory]

Special Features

Extras

Ao invés do Chrome, os extras do Firefos não são adicionados como parte das capacidades, mas sim após iniciar o driver.

Unlike Chrome, Firefox extensions are not added as part of capabilities as mentioned in this issue, they are created after starting the driver.

The following examples are for local webdrivers. For remote webdrivers, please refer to the Remote WebDriver page.

Instalação

Um arquivo xpi que pode ser obtido da página Mozilla Extras

• Java
• Python
• CSharp
• Ruby
• JavaScript
• Kotlin

    driver.install_addon(addon_path_xpi)

            driver.InstallAddOnFromFile(Path.GetFullPath(extensionFilePath));

      driver.install_addon(extension_file_path)

    let driver = new Builder()
      .forBrowser(Browser.FIREFOX)
      .build()

Desinstalação

Desinstalar uma extensão implica saber o seu id que pode ser obtido como valor de retorno durante a instalação.

• Java
• Python
• CSharp
• Ruby
• JavaScript
• Kotlin

    String id = driver.installExtension(xpiPath);

    driver.uninstall_addon(id)

            driver.UninstallAddOn(extensionId);

      driver.uninstall_addon(extension_id)

    let id = await driver.installAddon(xpiPath);

Instalação de extensões não assinadas

Quando trabalhar em uma extensão não terminada ou não publicada, provavelmente ela não estará assinada. Desta forma, só pode ser instalada como “temporária”. Isto pode ser feito passando uma arquivo ZIP ou uma pasta, este é um exemplo com uma pasta:

• Java
• Python
• CSharp
• Ruby
• JavaScript
• Kotlin

    driver = startFirefoxDriver();

    driver.install_addon(addon_path_dir, temporary=True)

            driver.InstallAddOnFromDirectory(Path.GetFullPath(extensionDirPath), true);

      driver.install_addon(extension_dir_path, true)

    const xpiPath = path.resolve('./test/resources/extensions/selenium-example')
    let driver = new Builder()

Captura de tela inteira

The following examples are for local webdrivers. For remote webdrivers, please refer to the Remote WebDriver page.

• Java
• Python
• CSharp
• Ruby
• JavaScript
• Kotlin

        screenshot = driver.save_full_page_screenshot(File.join(dir, 'screenshot.png'))

Contexto

The following examples are for local webdrivers. For remote webdrivers, please refer to the Remote WebDriver page.

• Java
• Python
• CSharp
• Ruby
• JavaScript
• Kotlin

      driver.context = 'content'