05 May 2022 12:29:56 UTC
- Distribution: Selenium-Remote-Driver
- Module version: 1.47
- Source (raw)
- Browse (raw)
- How to Contribute
- Issues (20)
- Testers (243 / 0 / 1)
- KwaliteeBus factor: 1
- 64.72% Coverage
- License: apache_2_0
- Perl: v5.10.0
- Download (3.93MB)
- MetaCPAN Explorer
- Subscribe to distribution
- Reverse dependencies
- CPAN Testers List
- Dependency graph
- This version
- Latest version++ed by:25 non-PAUSE users
- Aditya Ivaturi
- Daniel Gempesaw
- Emmanuel Peroumalnaïk
- Luke Closs
- Mark Stosberg
- Allen Lew
- Andy Jack
- Bas Bloemsaat
- Blake GH
- Brian Horakh
- Charles Howes
- Chris Davies
- Daniel Fackrell
- Dave Rolsky
- Dmitry Karasik
- Doug Bell
- Dylan Streb
- Eric Johnson
- Gabor Szabo
- Gerhard Jungwirth
- Gordon Child
- Ivan Kurmanov
- Joe Higton
- Jon Hermansen
- Keita Sugama
- Ken Swanson
- Martin Gruner
- Matthew Spahr
- Max O'Cull
- Michael Prokop
- Peter Mottram (SysPete)
- Phil Kania
- Phil Mitchell
- Prateek Goyal
- Richard Sailer
- Robert Utter
- Tetsuya Tatsumi
- Tod Hagan
- Tom Hukins
- Vangelis Katsikaros
- Vishwanath Janmanchi
- Viťas Strádal
- Yuki Kimoto
- Yves Lavoie
- COPYRIGHT AND LICENSE
Selenium::PhantomJS - Use GhostDriver without a Selenium server
my $driver = Selenium::PhantomJS->new; # when you're done $driver->shutdown_binary;
This class allows you to use PhantomJS via Ghostdriver without needing the JRE or a selenium server running. When you refrain from passing the
portarguments, we will search for the phantomjs executable binary in your $PATH. We'll try to start the binary connect to it, shutting it down at the end of the test.
If the binary is not found, we'll fall back to the default Selenium::Remote::Driver behavior of assuming defaults of 127.0.0.1:4444 after waiting a few seconds.
If you specify a remote server address, or a port, we'll assume you know what you're doing and take no additional behavior.
If you're curious whether your Selenium::PhantomJS instance is using a separate PhantomJS binary, or through the selenium server, you can check the
binary_modeattr after instantiation.
my $driver = Selenium::PhantomJS->new; print $driver->binary_mode;
N.B. - if you're using Windows and you installed
npm install -g phantomjs, there is a very high probability that we will _not_ close down your phantomjs binary correctly after your test. You will be able to tell if we leave around empty command windows that you didn't start yourself. The easiest way to fix this is to download PhantomJS manually from their website and put it in your
%PATH%. If this is a blocking issue for you, let us know in Github; thanks!
Optional: specify the path to your binary. If you don't specify anything, we'll try to find it on our own via "which" in File::Which.
Optional: specify the port that we should bind to. If you don't specify anything, we'll default to the driver's default port. Since there's no a priori guarantee that this will be an open port, this is _not_ necessarily the port that we end up using - if the port here is already bound, we'll search above it until we find an open one.
Optional: specify any additional command line arguments you'd like invoked during the binary startup. See "custom_args" in Selenium::CanStartBinary for more information.
Optional: specify how long to wait for the binary to start itself and listen on its port. The default duration is arbitrarily 10 seconds. It accepts an integer number of seconds to wait: the following will wait up to 20 seconds:
Selenium::PhantomJS->new( startup_timeout => 20 );
See "startup_timeout" in Selenium::CanStartBinary for more information.
Call this method instead of "quit" in Selenium::Remote::Driver to ensure that the binary executable is also closed, instead of simply closing the browser itself. If the browser is still around, it will call
quitfor you. After that, it will try to shutdown the browser binary by making a GET to /shutdown and on Windows, it will attempt to do a
taskkillon the binary CMD window.
It doesn't take any arguments, and it doesn't return anything.
We do our best to call this when the
$driveroption goes out of scope, but if that happens during global destruction, there's nothing we can do.
George S. Baugh <email@example.com>
Daniel Gempesaw <firstname.lastname@example.org>
Emmanuel Peroumalnaïk <email@example.com>
Luke Closs <firstname.lastname@example.org>
Mark Stosberg <email@example.com>
Aditya Ivaturi <firstname.lastname@example.org>
Copyright (c) 2010-2011 Aditya Ivaturi, Gordon Child
Copyright (c) 2014-2017 Daniel Gempesaw
Copyright (c) 2018-2021 George S. Baugh
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.
Module Install Instructions
To install Selenium::Remote::Driver, copy and paste the appropriate command in to your terminal.
perl -MCPAN -e shell install Selenium::Remote::Driver
For more information on module installation, please visit the detailed CPAN module installation guide.
|s||Focus search bar|
|?||Bring up this help dialog|
|g p||Go to pull requests|
|g i||go to github issues (only if github is preferred repository)|
|g a||Go to author|
|g c||Go to changes|
|g i||Go to issues|
|g d||Go to dist|
|g r||Go to repository/SCM|
|g s||Go to source|
|g b||Go to file browse|