-
Notifications
You must be signed in to change notification settings - Fork 91
/
Edge.pm
133 lines (93 loc) · 3.75 KB
/
Edge.pm
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
package Selenium::Edge;
use strict;
use warnings;
# ABSTRACT: Use EdgeDriver without a Selenium server
use Moo;
use Selenium::CanStartBinary::FindBinary qw/coerce_simple_binary/;
extends 'Selenium::Remote::Driver';
=head1 SYNOPSIS
my $driver = Selenium::Edge->new;
# when you're done
$driver->shutdown_binary;
=for Pod::Coverage has_binary
=head1 DESCRIPTION
This class allows you to use the EdgeDriver without needing the JRE
or a selenium server running. When you refrain from passing the
C<remote_server_addr> and C<port> arguments, we will search for the
edgedriver 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 MicrosoftWebDriver binary is not found, we'll fall back to the
default L<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::Edge instance is using a
separate MicrosoftWebDriver binary, or through the selenium server, you can
check the C<binary_mode> attr after instantiation.
=cut
has '+browser_name' => (
is => 'ro',
default => sub { 'MicrosoftEdge' }
);
=attr binary
Optional: specify the path to your binary. If you don't specify
anything, we'll try to find it on our own via L<File::Which/which>.
=cut
has 'binary' => (
is => 'lazy',
coerce => \&coerce_simple_binary,
default => sub { 'MicrosoftWebDriver.exe' },
predicate => 1
);
=attr binary_port
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.
See L<Selenium::CanStartBinary/port> for more details, and
L<Selenium::Remote::Driver/port> after instantiation to see what the
actual port turned out to be.
=cut
has 'binary_port' => (
is => 'lazy',
default => sub { 17556 }
);
has '_binary_args' => (
is => 'lazy',
builder => sub {
my ($self) = @_;
my $context = $self->wd_context_prefix;
$context =~ s{^/}{};
return ' --port=' . $self->port . ' --url-base=' . $context . ' ';
}
);
with 'Selenium::CanStartBinary';
=attr custom_args
Optional: specify any additional command line arguments you'd like
invoked during the binary startup. See
L<Selenium::CanStartBinary/custom_args> for more information.
=attr 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. It
accepts an integer number of seconds to wait: the following will wait
up to 20 seconds:
Selenium::Edge->new( startup_timeout => 20 );
See L<Selenium::CanStartBinary/startup_timeout> for more information.
=method shutdown_binary
Call this method instead of L<Selenium::Remote::Driver/quit> 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
C<quit> for 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 C<taskkill> on the binary CMD window.
$self->shutdown_binary;
It doesn't take any arguments, and it doesn't return anything.
We do our best to call this when the C<$driver> option goes out of
scope, but if that happens during global destruction, there's nothing
we can do.
=attr fixed_ports
Optional: Throw instead of searching for additional ports; see
L<Selenium::CanStartBinary/fixed_ports> for more info.
=cut
1;