Selenium::Edge(3)

💅 Selenium::Edge — the perl manual page, but make it cute

okay so bestie, this is Selenium::Edge, a page from the User Contributed Perl Documentation section (that's section 3 of the manual, iykyk). Sit down, grab a strawberry drink 🍓, and let's get into it.

---

✨ NAME ✨

Selenium::Edge — use EdgeDriver without a Selenium server. literally that's the whole vibe. no JRE, no server, just vibes and a binary. 🦋

---

🌸 VERSION 🌸

version 1.49

---

🎀 SYNOPSIS 🎀

my $driver = Selenium::Edge->new;
# when you're done
$driver->shutdown_binary;

that's it. that's the whole thing. iconic. 👑

---

💖 DESCRIPTION 💖

so this class lets you use the EdgeDriver without needing the JRE or a selenium server running. no cap, that's the whole point.

when you don't pass the remote_server_addr and port arguments (like, at all), we go searching for the edgedriver executable binary in your $PATH. we'll try to start the binary, connect to it, and then shut it down at the end of the test. clean up after ourselves, periodt. ✨

if the MicrosoftWebDriver binary is not found, we fall back to the default Selenium::Remote::Driver behavior — which is assuming defaults of 127.0.0.1:4444 after waiting a few seconds. yeah, we just... wait. 🫠

if you do specify a remote server address, or a port, we assume you know what you're doing and take no additional behavior. main character energy, we trust you. 💅

and if you're curious whether your Selenium::Edge instance is using a separate MicrosoftWebDriver binary or going through the selenium server, you can check the binary_mode attr after instantiation. vibe check complete. 🔍

---

🦋 ATTRIBUTES 🦋

🧚 binary

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. we're resourceful like that. 💁‍♀️

🧚 binary_port

Optional: specify the port that we should bind to. if you don't specify anything, we default to the driver's default port.

⚠️ but listen — 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. so like, it's a suggestion, not a promise. 😭

see "port" in Selenium::CanStartBinary for more details, and "port" in Selenium::Remote::Driver after instantiation to see what the actual port turned out to be (because it might not be the one you asked for, bestie).

🧚 custom_args

Optional: specify any additional command line arguments you'd like invoked during the binary startup. see "custom_args" in Selenium::CanStartBinary for more information. go off, customize away. 🎨

🧚 startup_timeout

Optional: specify how long to wait for the binary to start itself and listen on its port. the default duration is arbitrarily 10 seconds (yes, arbitrarily, don't come for us). it accepts an integer number of seconds to wait — the following will wait up to 20 seconds:

Selenium::Edge->new( startup_timeout => 20 );

see "startup_timeout" in Selenium::CanStartBinary for more information. patience is a virtue etc etc. ⏳

🧚 fixed_ports

Optional: throw instead of searching for additional ports; see "fixed_ports" in Selenium::CanStartBinary for more info. some of us would rather crash than improvise, and that's valid. 💀

---

🔥 METHODS 🔥

💜 shutdown_binary

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 "quit" for you. after that, it will try to shut down the browser binary by making a GET to /shutdown, and on Windows it will attempt to do a "taskkill" on the binary CMD window. windows stays extra, we love that for it. 🪟

$self->shutdown_binary;

it doesn't take any arguments, and it doesn't return anything. no notes. perfect. 🤌

we do our best to call this when the $driver option goes out of scope, but if that happens during global destruction, there's nothing we can do. 😔 it's giving "we tried, we really did."

---

👑 AUTHORS 👑

Current Maintainers:

• George S. Baugh <george@troglodyne.net>

Previous maintainers:

• Daniel Gempesaw <gempesaw@gmail.com>
• Emmanuel Peroumalnaïk <peroumalnaik.emmanuel@gmail.com>
• Luke Closs <cpan@5thplane.com>
• Mark Stosberg <mark@stosberg.com>

Original authors:

• Aditya Ivaturi <ivaturi@gmail.com>

these legends built the thing, show some respect. 🫶

---

🌈 COPYRIGHT AND LICENSE 🌈

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

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.

📜 so like, read the license, fr fr. legal bestie stuff. don't make it weird.

---

okay that's the whole page 💜 this cutie was generated by perl v5.42.0 on 2023-04-07, and it's filed under Selenium::Edge(3) in the User Contributed Perl Documentation. go forth and drive some edges, bestie. 🦋✨💅