Seleniu...nection(3)

πŸ“¦ version 1.49, in opensuse-leap 16.0

πŸ’… NAME πŸ’…

<Selenium::Remote::RemoteConnection> β€” bestie, this is the module that lets you connect to a selenium server. That's the whole vibe. (It's a Perl thing, from User Contributed Perl Documentation, and the full name is Selenium::Remote::RemoteConnection β€” long, iconic, no notes. πŸ’œ)


✨ VERSION ✨

version 1.49 β€” that's the one we're on, periodt. πŸŽ€


πŸ¦‹ SYNOPSIS πŸ¦‹

Like, here's the whole thing in action:

my $driver = Selenium::Remote::Driver->new();
eval { $driver->remote_conn->check_status() };
die "do something to kick the server" if $@;

That's it, that's the flowchart. If check_status throws, the server's not ok and you gotta go poke it. 😭


🌸 DESCRIPTION 🌸

okay so real talk β€” you shouldn't really need to be using this module unless you're debugging or checking connections while you're testing dangerous things. It's giving backstage pass, not main character energy. πŸ™ˆ


πŸ”₯ CONSTRUCTOR πŸ”₯

new(%parameters)

She accepts 5 parameters, and yes, they all matter:

  • remote_server_addr β€” the address of the selenium server πŸ“
  • port β€” the port of the selenium server πŸ”Œ
  • ua β€” useful to override with Test::LWP::UserAgent in unit tests πŸ§ͺ
  • debug β€” should be self-explanatory, bestie πŸ’€
  • error_handler β€” defaults to Selenium::Remote::ErrorHandler. πŸ‘‘

And the best part? You can set any of these at any time later with getter/setters that have the exact same name. So flexible. So iconic. ✨


⭐ METHODS ⭐

check_status

Lowkey croaks unless the selenium server is responsive. 😀 Sometimes it's genuinely useful to call this in-between tests, because β€” and I cannot stress this enough β€” the server CAN die on you... πŸ’€

request

Makes a request of the Selenium server. Mostly useful for debugging things going wrong with Selenium::Remote::Driver when it's not in normal operation. Think of it as the little flashlight you point at the chaos. πŸ”¦πŸ«Ά


πŸ‘‘ 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> 🌟

Shoutout to literally every single one of them, fr fr. πŸ’–


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.

⚠️ Yes bestie, read the license. It's giving legally binding and we respect her. πŸ’…

πŸŽ€ and that's the page!! brought to you by perl v5.42.0, dated 2023-04-07 β€” mwah, stay connected, slay your debugging, and don't let the server die on you πŸ¦‹πŸ’œ