selenium-webdriver 2.53.4 → 3.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (152) hide show
  1. checksums.yaml +7 -0
  2. data/CHANGES +363 -10
  3. data/LICENSE +1 -1
  4. data/README.md +2 -3
  5. data/lib/selenium-webdriver.rb +0 -2
  6. data/lib/selenium/server.rb +69 -70
  7. data/lib/selenium/webdriver.rb +32 -23
  8. data/lib/selenium/webdriver/atoms.rb +18 -0
  9. data/lib/selenium/webdriver/atoms/getAttribute.js +8 -0
  10. data/lib/selenium/webdriver/chrome.rb +8 -6
  11. data/lib/selenium/webdriver/chrome/driver.rb +112 -0
  12. data/lib/selenium/webdriver/chrome/options.rb +168 -0
  13. data/lib/selenium/webdriver/chrome/profile.rb +17 -17
  14. data/lib/selenium/webdriver/chrome/service.rb +22 -89
  15. data/lib/selenium/webdriver/common.rb +13 -6
  16. data/lib/selenium/webdriver/common/action_builder.rb +49 -57
  17. data/lib/selenium/webdriver/common/alert.rb +5 -15
  18. data/lib/selenium/webdriver/common/bridge_helper.rb +10 -17
  19. data/lib/selenium/webdriver/common/driver.rb +53 -68
  20. data/lib/selenium/webdriver/common/driver_extensions/{has_input_devices.rb → has_addons.rb} +13 -23
  21. data/lib/selenium/webdriver/common/driver_extensions/has_location.rb +4 -8
  22. data/lib/selenium/webdriver/common/driver_extensions/has_network_connection.rb +4 -7
  23. data/lib/selenium/webdriver/common/driver_extensions/has_remote_status.rb +0 -4
  24. data/lib/selenium/webdriver/common/driver_extensions/has_session_id.rb +0 -4
  25. data/lib/selenium/webdriver/common/driver_extensions/has_touch_screen.rb +1 -5
  26. data/lib/selenium/webdriver/common/driver_extensions/has_web_storage.rb +0 -5
  27. data/lib/selenium/webdriver/common/driver_extensions/rotatable.rb +4 -9
  28. data/lib/selenium/webdriver/common/driver_extensions/takes_screenshot.rb +7 -7
  29. data/lib/selenium/webdriver/common/driver_extensions/uploads_files.rb +2 -7
  30. data/lib/selenium/webdriver/common/element.rb +57 -39
  31. data/lib/selenium/webdriver/common/error.rb +204 -106
  32. data/lib/selenium/webdriver/common/file_reaper.rb +3 -11
  33. data/lib/selenium/webdriver/common/html5/local_storage.rb +6 -10
  34. data/lib/selenium/webdriver/common/html5/session_storage.rb +6 -10
  35. data/lib/selenium/webdriver/common/html5/shared_web_storage.rb +7 -18
  36. data/lib/selenium/webdriver/{safari/options.rb → common/interactions/input_device.rb} +20 -31
  37. data/lib/selenium/webdriver/common/interactions/interaction.rb +50 -0
  38. data/lib/selenium/webdriver/{safari/browser.rb → common/interactions/interactions.rb} +16 -15
  39. data/lib/selenium/webdriver/common/interactions/key_actions.rb +143 -0
  40. data/lib/selenium/webdriver/common/interactions/key_input.rb +62 -0
  41. data/lib/selenium/webdriver/{android.rb → common/interactions/none_input.rb} +11 -6
  42. data/lib/selenium/webdriver/common/interactions/pointer_actions.rb +353 -0
  43. data/lib/selenium/webdriver/common/interactions/pointer_input.rb +132 -0
  44. data/lib/selenium/webdriver/common/keyboard.rb +7 -14
  45. data/lib/selenium/webdriver/common/keys.rb +99 -82
  46. data/lib/selenium/webdriver/common/log_entry.rb +3 -6
  47. data/lib/selenium/webdriver/common/logger.rb +140 -0
  48. data/lib/selenium/webdriver/common/logs.rb +2 -6
  49. data/lib/selenium/webdriver/common/mouse.rb +9 -14
  50. data/lib/selenium/webdriver/common/navigation.rb +2 -6
  51. data/lib/selenium/webdriver/common/options.rb +20 -23
  52. data/lib/selenium/webdriver/common/platform.rb +70 -97
  53. data/lib/selenium/webdriver/common/port_prober.rb +3 -4
  54. data/lib/selenium/webdriver/common/profile_helper.rb +6 -11
  55. data/lib/selenium/webdriver/common/proxy.rb +58 -72
  56. data/lib/selenium/webdriver/common/search_context.rb +22 -29
  57. data/lib/selenium/webdriver/common/service.rb +161 -0
  58. data/lib/selenium/webdriver/common/socket_lock.rb +6 -14
  59. data/lib/selenium/webdriver/common/socket_poller.rb +5 -12
  60. data/lib/selenium/webdriver/common/target_locator.rb +11 -15
  61. data/lib/selenium/webdriver/common/timeouts.rb +4 -8
  62. data/lib/selenium/webdriver/common/touch_action_builder.rb +2 -6
  63. data/lib/selenium/webdriver/common/touch_screen.rb +19 -23
  64. data/lib/selenium/webdriver/common/w3c_action_builder.rb +209 -0
  65. data/lib/selenium/webdriver/{phantomjs.rb → common/w3c_options.rb} +16 -14
  66. data/lib/selenium/webdriver/common/wait.rb +6 -13
  67. data/lib/selenium/webdriver/common/window.rb +48 -17
  68. data/lib/selenium/webdriver/common/zipper.rb +6 -10
  69. data/lib/selenium/webdriver/edge.rb +5 -12
  70. data/lib/selenium/webdriver/edge/bridge.rb +32 -63
  71. data/lib/selenium/webdriver/edge/driver.rb +73 -0
  72. data/lib/selenium/webdriver/edge/service.rb +18 -87
  73. data/lib/selenium/webdriver/firefox.rb +20 -11
  74. data/lib/selenium/webdriver/firefox/binary.rb +40 -56
  75. data/lib/selenium/webdriver/firefox/driver.rb +48 -0
  76. data/lib/selenium/webdriver/firefox/extension.rb +18 -8
  77. data/lib/selenium/webdriver/firefox/extension/prefs.json +3 -11
  78. data/lib/selenium/webdriver/firefox/extension/webdriver.xpi +0 -0
  79. data/lib/selenium/webdriver/firefox/launcher.rb +13 -22
  80. data/lib/selenium/webdriver/firefox/legacy/driver.rb +79 -0
  81. data/lib/selenium/webdriver/{iphone.rb → firefox/marionette/bridge.rb} +25 -6
  82. data/lib/selenium/webdriver/firefox/marionette/driver.rb +96 -0
  83. data/lib/selenium/webdriver/firefox/options.rb +149 -0
  84. data/lib/selenium/webdriver/firefox/profile.rb +46 -46
  85. data/lib/selenium/webdriver/firefox/profiles_ini.rb +8 -18
  86. data/lib/selenium/webdriver/firefox/service.rb +23 -83
  87. data/lib/selenium/webdriver/firefox/util.rb +0 -4
  88. data/lib/selenium/webdriver/ie.rb +4 -8
  89. data/lib/selenium/webdriver/ie/driver.rb +90 -0
  90. data/lib/selenium/webdriver/ie/options.rb +136 -0
  91. data/lib/selenium/webdriver/ie/service.rb +58 -0
  92. data/lib/selenium/webdriver/remote.rb +8 -16
  93. data/lib/selenium/webdriver/remote/bridge.rb +96 -565
  94. data/lib/selenium/webdriver/remote/capabilities.rb +76 -94
  95. data/lib/selenium/webdriver/remote/driver.rb +49 -0
  96. data/lib/selenium/webdriver/remote/http/common.rb +22 -20
  97. data/lib/selenium/webdriver/remote/http/curb.rb +9 -12
  98. data/lib/selenium/webdriver/remote/http/default.rb +54 -41
  99. data/lib/selenium/webdriver/remote/http/persistent.rb +9 -8
  100. data/lib/selenium/webdriver/remote/oss/bridge.rb +586 -0
  101. data/lib/selenium/webdriver/remote/oss/commands.rb +221 -0
  102. data/lib/selenium/webdriver/remote/response.rb +39 -27
  103. data/lib/selenium/webdriver/remote/server_error.rb +1 -5
  104. data/lib/selenium/webdriver/remote/w3c/bridge.rb +573 -0
  105. data/lib/selenium/webdriver/remote/w3c/capabilities.rb +290 -0
  106. data/lib/selenium/webdriver/remote/w3c/commands.rb +148 -0
  107. data/lib/selenium/webdriver/safari.rb +20 -29
  108. data/lib/selenium/webdriver/{firefox/w3c_bridge.rb → safari/driver.rb} +21 -30
  109. data/lib/selenium/webdriver/safari/service.rb +57 -0
  110. data/lib/selenium/webdriver/support.rb +1 -2
  111. data/lib/selenium/webdriver/support/abstract_event_listener.rb +17 -4
  112. data/lib/selenium/webdriver/support/block_event_listener.rb +1 -5
  113. data/lib/selenium/webdriver/support/color.rb +57 -42
  114. data/lib/selenium/webdriver/support/escaper.rb +41 -0
  115. data/lib/selenium/webdriver/support/event_firing_bridge.rb +36 -40
  116. data/lib/selenium/webdriver/support/select.rb +33 -86
  117. data/selenium-webdriver.gemspec +22 -25
  118. metadata +254 -261
  119. data/lib/selenium-client.rb +0 -21
  120. data/lib/selenium/client.rb +0 -57
  121. data/lib/selenium/client/base.rb +0 -151
  122. data/lib/selenium/client/driver.rb +0 -29
  123. data/lib/selenium/client/errors.rb +0 -28
  124. data/lib/selenium/client/extensions.rb +0 -132
  125. data/lib/selenium/client/idiomatic.rb +0 -507
  126. data/lib/selenium/client/javascript_expression_builder.rb +0 -135
  127. data/lib/selenium/client/javascript_frameworks/jquery.rb +0 -32
  128. data/lib/selenium/client/javascript_frameworks/prototype.rb +0 -32
  129. data/lib/selenium/client/legacy_driver.rb +0 -1722
  130. data/lib/selenium/client/protocol.rb +0 -123
  131. data/lib/selenium/client/selenium_helper.rb +0 -49
  132. data/lib/selenium/rake/server_task.rb +0 -176
  133. data/lib/selenium/webdriver/android/bridge.rb +0 -68
  134. data/lib/selenium/webdriver/chrome/bridge.rb +0 -139
  135. data/lib/selenium/webdriver/common/core_ext/base64.rb +0 -28
  136. data/lib/selenium/webdriver/common/core_ext/dir.rb +0 -61
  137. data/lib/selenium/webdriver/common/html5/location.rb +0 -19
  138. data/lib/selenium/webdriver/common/w3c_error.rb +0 -194
  139. data/lib/selenium/webdriver/edge/legacy_support.rb +0 -117
  140. data/lib/selenium/webdriver/firefox/bridge.rb +0 -89
  141. data/lib/selenium/webdriver/ie/bridge.rb +0 -88
  142. data/lib/selenium/webdriver/ie/server.rb +0 -133
  143. data/lib/selenium/webdriver/iphone/bridge.rb +0 -64
  144. data/lib/selenium/webdriver/phantomjs/bridge.rb +0 -78
  145. data/lib/selenium/webdriver/phantomjs/service.rb +0 -130
  146. data/lib/selenium/webdriver/remote/commands.rb +0 -211
  147. data/lib/selenium/webdriver/remote/w3c_bridge.rb +0 -668
  148. data/lib/selenium/webdriver/remote/w3c_capabilities.rb +0 -236
  149. data/lib/selenium/webdriver/remote/w3c_commands.rb +0 -132
  150. data/lib/selenium/webdriver/safari/bridge.rb +0 -135
  151. data/lib/selenium/webdriver/safari/resources/client.js +0 -7255
  152. data/lib/selenium/webdriver/safari/server.rb +0 -187
@@ -1,88 +0,0 @@
1
- # encoding: utf-8
2
- #
3
- # Licensed to the Software Freedom Conservancy (SFC) under one
4
- # or more contributor license agreements. See the NOTICE file
5
- # distributed with this work for additional information
6
- # regarding copyright ownership. The SFC licenses this file
7
- # to you under the Apache License, Version 2.0 (the
8
- # "License"); you may not use this file except in compliance
9
- # with the License. You may obtain a copy of the License at
10
- #
11
- # http://www.apache.org/licenses/LICENSE-2.0
12
- #
13
- # Unless required by applicable law or agreed to in writing,
14
- # software distributed under the License is distributed on an
15
- # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
16
- # KIND, either express or implied. See the License for the
17
- # specific language governing permissions and limitations
18
- # under the License.
19
-
20
- module Selenium
21
- module WebDriver
22
- module IE
23
-
24
- #
25
- # @api private
26
- #
27
-
28
- class Bridge < Remote::Bridge
29
-
30
- HOST = Platform.localhost
31
- DEFAULT_PORT = 5555
32
- DEFAULT_TIMEOUT = 30
33
-
34
- def initialize(opts = {})
35
- caps = opts.delete(:desired_capabilities) { Remote::Capabilities.internet_explorer }
36
- timeout = opts.delete(:timeout) { DEFAULT_TIMEOUT }
37
- port = opts.delete(:port) { DEFAULT_PORT }
38
- http_client = opts.delete(:http_client)
39
- ignore_mode = opts.delete(:introduce_flakiness_by_ignoring_security_domains)
40
- native_events = opts.delete(:native_events) != false
41
- implementation = opts.delete(:implementation)
42
-
43
- @server = Server.get(:implementation => implementation)
44
-
45
- @server.log_level = opts.delete(:log_level) if opts[:log_level]
46
- @server.log_file = opts.delete(:log_file) if opts[:log_file]
47
-
48
- unless opts.empty?
49
- raise ArgumentError, "unknown option#{'s' if opts.size != 1}: #{opts.inspect}"
50
- end
51
-
52
- @port = @server.start Integer(port), timeout
53
-
54
- if ignore_mode
55
- caps['ignoreProtectedModeSettings'] = true
56
- end
57
-
58
- caps['nativeEvents'] = native_events
59
-
60
- remote_opts = {
61
- :url => @server.uri,
62
- :desired_capabilities => caps
63
- }
64
-
65
- remote_opts[:http_client] = http_client if http_client
66
-
67
- super(remote_opts)
68
- end
69
-
70
- def browser
71
- :internet_explorer
72
- end
73
-
74
- def driver_extensions
75
- [DriverExtensions::TakesScreenshot, DriverExtensions::HasInputDevices]
76
- end
77
-
78
- def quit
79
- super
80
- nil
81
- ensure
82
- @server.stop
83
- end
84
-
85
- end # Bridge
86
- end # IE
87
- end # WebDriver
88
- end # Selenium
@@ -1,133 +0,0 @@
1
- # encoding: utf-8
2
- #
3
- # Licensed to the Software Freedom Conservancy (SFC) under one
4
- # or more contributor license agreements. See the NOTICE file
5
- # distributed with this work for additional information
6
- # regarding copyright ownership. The SFC licenses this file
7
- # to you under the Apache License, Version 2.0 (the
8
- # "License"); you may not use this file except in compliance
9
- # with the License. You may obtain a copy of the License at
10
- #
11
- # http://www.apache.org/licenses/LICENSE-2.0
12
- #
13
- # Unless required by applicable law or agreed to in writing,
14
- # software distributed under the License is distributed on an
15
- # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
16
- # KIND, either express or implied. See the License for the
17
- # specific language governing permissions and limitations
18
- # under the License.
19
-
20
- module Selenium
21
- module WebDriver
22
- module IE
23
-
24
- #
25
- # @api private
26
- #
27
-
28
- class Server
29
-
30
- STOP_TIMEOUT = 5
31
- SOCKET_LOCK_TIMEOUT = 45
32
- MISSING_TEXT = "Unable to find standalone executable. Please download the IEDriverServer from http://selenium-release.storage.googleapis.com/index.html and place the executable on your PATH."
33
-
34
- def self.get(opts = {})
35
- binary = IE.driver_path || Platform.find_binary("IEDriverServer")
36
-
37
- if binary
38
- new binary, opts
39
- else
40
- raise Error::WebDriverError, MISSING_TEXT
41
- end
42
- end
43
-
44
- attr_accessor :log_level, :log_file
45
-
46
- def initialize(binary_path, opts = {})
47
- Platform.assert_executable binary_path
48
-
49
- @binary_path = binary_path
50
- @process = nil
51
-
52
- opts = opts.dup
53
-
54
- @log_level = opts.delete(:log_level)
55
- @log_file = opts.delete(:log_file)
56
- @implementation = opts.delete(:implementation)
57
-
58
- unless opts.empty?
59
- raise ArgumentError, "invalid option#{'s' if opts.size != 1}: #{opts.inspect}"
60
- end
61
- end
62
-
63
- def start(port, timeout)
64
- return @port if running?
65
-
66
- @port = port
67
- socket_lock.locked do
68
- find_free_port
69
- start_process
70
- connect_until_stable(timeout)
71
- end
72
-
73
- Platform.exit_hook { stop } # make sure we don't leave the server running
74
-
75
- @port
76
- end
77
-
78
- def stop
79
- if running?
80
- @process.stop STOP_TIMEOUT
81
- end
82
- end
83
-
84
- def port
85
- @port
86
- end
87
-
88
- def uri
89
- "http://#{Platform.localhost}:#{port}"
90
- end
91
-
92
- def running?
93
- @process && @process.alive?
94
- end
95
-
96
- private
97
-
98
- def server_args
99
- args = ["--port=#{@port}"]
100
-
101
- args << "--log-level=#{@log_level.to_s.upcase}" if @log_level
102
- args << "--log-file=#{@log_file}" if @log_file
103
- args << "--implementation=#{@implementation.to_s.upcase}" if @implementation
104
-
105
- args
106
- end
107
-
108
- def find_free_port
109
- @port = PortProber.above @port
110
- end
111
-
112
- def start_process
113
- @process = ChildProcess.new(@binary_path, *server_args)
114
- @process.io.inherit! if $DEBUG
115
- @process.start
116
- end
117
-
118
- def connect_until_stable(timeout)
119
- socket_poller = SocketPoller.new Platform.localhost, @port, timeout
120
-
121
- unless socket_poller.connected?
122
- raise Error::WebDriverError, "unable to connect to IE server within #{timeout} seconds"
123
- end
124
- end
125
-
126
- def socket_lock
127
- @socket_lock ||= SocketLock.new(@port - 1, SOCKET_LOCK_TIMEOUT)
128
- end
129
-
130
- end # Server
131
- end # IE
132
- end # WebDriver
133
- end # Selenium
@@ -1,64 +0,0 @@
1
- # encoding: utf-8
2
- #
3
- # Licensed to the Software Freedom Conservancy (SFC) under one
4
- # or more contributor license agreements. See the NOTICE file
5
- # distributed with this work for additional information
6
- # regarding copyright ownership. The SFC licenses this file
7
- # to you under the Apache License, Version 2.0 (the
8
- # "License"); you may not use this file except in compliance
9
- # with the License. You may obtain a copy of the License at
10
- #
11
- # http://www.apache.org/licenses/LICENSE-2.0
12
- #
13
- # Unless required by applicable law or agreed to in writing,
14
- # software distributed under the License is distributed on an
15
- # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
16
- # KIND, either express or implied. See the License for the
17
- # specific language governing permissions and limitations
18
- # under the License.
19
-
20
- module Selenium
21
- module WebDriver
22
- module IPhone
23
- #
24
- # @api private
25
- #
26
-
27
- class Bridge < Remote::Bridge
28
-
29
- DEFAULT_URL = "http://#{Platform.localhost}:3001/wd/hub/"
30
-
31
- def initialize(opts = {})
32
- warn 'The iPhone driver is deprecated - please use either http://appium.io/ or http://ios-driver.github.io/ios-driver/ instead'
33
-
34
- remote_opts = {
35
- :url => opts.fetch(:url, DEFAULT_URL),
36
- :desired_capabilities => opts.fetch(:desired_capabilities, capabilities),
37
- }
38
-
39
- remote_opts[:http_client] = opts[:http_client] if opts.has_key?(:http_client)
40
-
41
- super remote_opts
42
- end
43
-
44
- def browser
45
- :iphone
46
- end
47
-
48
- def driver_extensions
49
- [
50
- DriverExtensions::TakesScreenshot,
51
- DriverExtensions::HasInputDevices,
52
- DriverExtensions::HasWebStorage,
53
- DriverExtensions::HasLocation
54
- ]
55
- end
56
-
57
- def capabilities
58
- @capabilities ||= Remote::Capabilities.iphone
59
- end
60
-
61
- end # Bridge
62
- end # IPhone
63
- end # WebDriver
64
- end # Selenium
@@ -1,78 +0,0 @@
1
- # encoding: utf-8
2
- #
3
- # Licensed to the Software Freedom Conservancy (SFC) under one
4
- # or more contributor license agreements. See the NOTICE file
5
- # distributed with this work for additional information
6
- # regarding copyright ownership. The SFC licenses this file
7
- # to you under the Apache License, Version 2.0 (the
8
- # "License"); you may not use this file except in compliance
9
- # with the License. You may obtain a copy of the License at
10
- #
11
- # http://www.apache.org/licenses/LICENSE-2.0
12
- #
13
- # Unless required by applicable law or agreed to in writing,
14
- # software distributed under the License is distributed on an
15
- # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
16
- # KIND, either express or implied. See the License for the
17
- # specific language governing permissions and limitations
18
- # under the License.
19
-
20
- module Selenium
21
- module WebDriver
22
- module PhantomJS
23
-
24
-
25
- # @api private
26
- class Bridge < Remote::Bridge
27
-
28
- def initialize(opts = {})
29
- http_client = opts.delete(:http_client)
30
- caps = opts.delete(:desired_capabilities) { Remote::Capabilities.phantomjs }
31
-
32
- if opts.has_key?(:url)
33
- url = opts.delete(:url)
34
- else
35
- args = opts.delete(:args) || caps['phantomjs.cli.args']
36
- port = opts.delete(:port)
37
-
38
- @service = Service.default_service(port)
39
- @service.start(args)
40
-
41
- url = @service.uri
42
- end
43
-
44
- remote_opts = {
45
- :url => url,
46
- :desired_capabilities => caps
47
- }
48
-
49
- remote_opts.merge!(:http_client => http_client) if http_client
50
-
51
- super(remote_opts)
52
- end
53
-
54
- def browser
55
- :phantomjs
56
- end
57
-
58
- def driver_extensions
59
- [
60
- DriverExtensions::TakesScreenshot,
61
- DriverExtensions::HasInputDevices
62
- ]
63
- end
64
-
65
- def capabilities
66
- @capabilities ||= Remote::Capabilities.phantomjs
67
- end
68
-
69
- def quit
70
- super
71
- ensure
72
- @service.stop if @service
73
- end
74
-
75
- end # Bridge
76
- end # PhantomJS
77
- end # WebDriver
78
- end # Selenium
@@ -1,130 +0,0 @@
1
- # encoding: utf-8
2
- #
3
- # Licensed to the Software Freedom Conservancy (SFC) under one
4
- # or more contributor license agreements. See the NOTICE file
5
- # distributed with this work for additional information
6
- # regarding copyright ownership. The SFC licenses this file
7
- # to you under the Apache License, Version 2.0 (the
8
- # "License"); you may not use this file except in compliance
9
- # with the License. You may obtain a copy of the License at
10
- #
11
- # http://www.apache.org/licenses/LICENSE-2.0
12
- #
13
- # Unless required by applicable law or agreed to in writing,
14
- # software distributed under the License is distributed on an
15
- # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
16
- # KIND, either express or implied. See the License for the
17
- # specific language governing permissions and limitations
18
- # under the License.
19
-
20
- module Selenium
21
- module WebDriver
22
- module PhantomJS
23
-
24
- #
25
- # @api private
26
- #
27
-
28
- class Service
29
- START_TIMEOUT = 20
30
- SOCKET_LOCK_TIMEOUT = 45
31
- STOP_TIMEOUT = 5
32
- DEFAULT_PORT = 8910
33
- MISSING_TEXT = "Unable to find phantomjs executable."
34
-
35
- def self.executable_path
36
- @executable_path ||= (
37
- path = PhantomJS.path
38
- path or raise Error::WebDriverError, MISSING_TEXT
39
- Platform.assert_executable path
40
-
41
- path
42
- )
43
- end
44
-
45
- def self.default_service(port = nil)
46
- new executable_path, DEFAULT_PORT
47
- end
48
-
49
- def initialize(executable_path, port)
50
- @host = Platform.localhost
51
- @executable = executable_path
52
- @port = Integer(port)
53
- end
54
-
55
- def start(args = [])
56
- if @process && @process.alive?
57
- raise "already started: #{uri.inspect} #{@executable.inspect}"
58
- end
59
-
60
- Platform.exit_hook { stop } # make sure we don't leave the server running
61
-
62
- socket_lock.locked do
63
- find_free_port
64
- start_process(args)
65
- connect_until_stable
66
- end
67
- end
68
-
69
- def stop
70
- return if @process.nil? || @process.exited?
71
-
72
- Net::HTTP.start(@host, @port) do |http|
73
- http.open_timeout = STOP_TIMEOUT / 2
74
- http.read_timeout = STOP_TIMEOUT / 2
75
-
76
- http.get("/shutdown")
77
- end
78
- ensure
79
- stop_process
80
- if Platform.jruby? && !$DEBUG
81
- @process.io.close rescue nil
82
- end
83
- end
84
-
85
- def find_free_port
86
- @port = PortProber.above @port
87
- end
88
-
89
- def uri
90
- URI.parse "http://#{@host}:#{@port}"
91
- end
92
-
93
- private
94
-
95
- def start_process(args)
96
- server_command = [@executable, "--webdriver=#{@port}", *args]
97
- @process = ChildProcess.build(*server_command.compact)
98
-
99
- if $DEBUG == true
100
- @process.io.inherit!
101
- elsif Platform.jruby?
102
- # apparently we need to read the output for phantomjs to work on jruby
103
- @process.io.stdout = @process.io.stderr = File.new(Platform.null_device, 'w')
104
- end
105
-
106
- @process.start
107
- end
108
-
109
- def stop_process
110
- @process.poll_for_exit STOP_TIMEOUT
111
- rescue ChildProcess::TimeoutError
112
- @process.stop STOP_TIMEOUT
113
- end
114
-
115
- def connect_until_stable
116
- socket_poller = SocketPoller.new @host, @port, START_TIMEOUT
117
-
118
- unless socket_poller.connected?
119
- raise Error::WebDriverError, "unable to connect to phantomjs @ #{uri} after #{START_TIMEOUT} seconds"
120
- end
121
- end
122
-
123
- def socket_lock
124
- @socket_lock ||= SocketLock.new(@port - 1, SOCKET_LOCK_TIMEOUT)
125
- end
126
-
127
- end # Service
128
- end # PhantomJS
129
- end # WebDriver
130
- end # Service