Selenium::Remote::Driver::Firefox::Profile - Use custom profiles with Selenium::Remote::Driver
version 0.19
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.
Set string and integer preferences on the profile object. You can set multiple preferences at once. If you need to set a boolean preference, see set_boolean_preference().
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().
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.
.xpi
$profile->add_extension('t/www/redisplay.xpi');
use Selenium::Remote::Driver; use Selenium::Remote::Driver::Firefox::Profile; my $profile = Selenium::Remote::Driver::Firefox::Profile->new; $profile->set_preference( 'browser.startup.homepage' => 'http://www.google.com', 'browser.cache.disk.capacity' => 358400 ); $profile->set_boolean_preference( 'browser.shell.checkDefaultBrowser' => 0 ); $profile->add_extension('t/www/redisplay.xpi'); my $driver = Selenium::Remote::Driver->new( 'firefox_profile' => $profile ); $driver->get('http://www.google.com'); print $driver->get_title();
Please see those modules/websites for more information related to this module.
Selenium::Remote::Driver
https://developer.mozilla.org/en-US/docs/Mozilla/Preferences/A_brief_guide_to_Mozilla_preferences
Please report any bugs or feature requests on the bugtracker website https://github.com/gempesaw/Selenium-Remote-Driver/issues
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.
Aditya Ivaturi <ivaturi@gmail.com>
Daniel Gempesaw <gempesaw@gmail.com>
Luke Closs <cpan@5thplane.com>
Mark Stosberg <mark@stosberg.com>
Copyright (c) 2010-2011 Aditya Ivaturi, Gordon Child
Copyright (c) 2014 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
http://www.apache.org/licenses/LICENSE-2.0
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.
To install Selenium::Remote::Driver, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Selenium::Remote::Driver
CPAN shell
perl -MCPAN -e shell install Selenium::Remote::Driver
For more information on module installation, please visit the detailed CPAN module installation guide.