Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Contact Us
Online Help
Domain Status
Man Pages

Virtual Servers

Topology Map

Server Agreement
Year 2038

USA Flag



Man Pages
Selenium::Firefox::Profile(3) User Contributed Perl Documentation Selenium::Firefox::Profile(3)

Selenium::Firefox::Profile - Use custom profiles with Selenium::Remote::Driver

version 1.30

You can use this module to create a custom Firefox Profile for your Selenium tests. Currently, you can set browser preferences and add extensions to the profile before passing it in the constructor for a new Selenium::Remote::Driver or Selenium::Firefox.

    use Selenium::Remote::Driver;
    use Selenium::Firefox::Profile;
    my $profile = Selenium::Firefox::Profile->new;
        'browser.startup.homepage' => '',
        'browser.cache.disk.capacity' => 358400
        '' => 0
    my $driver = Selenium::Remote::Driver->new(
        'firefox_profile' => $profile
    print $driver->get_title();

profile_dir - <string> directory to look for the firefox profile. Defaults to a Tempdir.

Set string and integer preferences on the profile object. You can set multiple preferences at once. If you need to set a boolean preference, either use JSON::true/JSON::false, or see "set_boolean_preference()".
    $profile->set_preference("quoted.integer.pref" => '"20140314220517"');
    # user_pref("quoted.integer.pref", "20140314220517");
    $profile->set_preference("plain.integer.pref" => 9005);
    # user_pref("plain.integer.pref", 9005);
    $profile->set_preference("string.pref" => "sample string value");
    # user_pref("string.pref", "sample string value");

Set preferences that require boolean values of 'true' or 'false'. You can set multiple preferences at once. For string or integer preferences, use "set_preference()".
    $profile->set_boolean_preference("false.pref" => 0);
    # user_pref("false.pref", false);
    $profile->set_boolean_preference("true.pref" => 1);
    # user_pref("true.pref", true);

Retrieve the computed value of a preference. Strings will be double quoted and boolean values will be single quoted as "true" or "false" accordingly.
    $profile->set_boolean_preference("true.pref" => 1);
    print $profile->get_preference("true.pref") # true
    $profile->set_preference("string.pref" => "an extra set of quotes");
    print $profile->get_preference("string.pref") # "an extra set of quotes"

Add an existing ".xpi" to the profile by providing its path. This only works with packaged ".xpi" files, not plain/un-packed extension directories.

Primarily for internal use, we set the appropriate firefox preferences for a new geckodriver session.

Primarily for internal use. This adds the fxgoogle .xpi that is used for webdriver communication in FF47 and older. For FF48 and newer, the old method using an extension to orchestrate the webdriver communication with the Firefox browser has been obsoleted by the introduction of "geckodriver".

Primarily for internal use, configure Marionette to the current Firefox profile.

Please see those modules/websites for more information related to this module.

Please report any bugs or feature requests on the bugtracker website
When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.

Current Maintainers:
Daniel Gempesaw <>
Emmanuel Peroumalnaïk <>
Previous maintainers:
Luke Closs <>
Mark Stosberg <>
Original authors:
Aditya Ivaturi <>

Copyright (c) 2010-2011 Aditya Ivaturi, Gordon Child
Copyright (c) 2014-2017 Daniel Gempesaw
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
2018-09-17 perl v5.28.1

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.