class Selenium::WebDriver::ServiceManager
@api private
responsible for starting and stopping driver implementations.
Base class implementing default behavior of service_manager object,
def build_process(*command)
def build_process(*command) WebDriver.logger.debug("Executing Process #{command}", id: :driver_service) @process = ChildProcess.build(*command) @io ||= WebDriver.logger.io if WebDriver.logger.debug? @process.io = @io if @io @process end
def cannot_connect_error_text
def cannot_connect_error_text "unable to connect to #{@executable_path} #{@host}:#{@port}" end
def connect_to_server
def connect_to_server Net::HTTP.start(@host, @port) do |http| http.open_timeout = STOP_TIMEOUT / 2 http.read_timeout = STOP_TIMEOUT / 2 yield http end end
def connect_until_stable
def connect_until_stable socket_poller = SocketPoller.new @host, @port, START_TIMEOUT return if socket_poller.connected? raise Error::WebDriverError, cannot_connect_error_text end
def find_free_port
def find_free_port @port = PortProber.above(@port) end
def initialize(config)
def initialize(config) @executable_path = config.executable_path @host = Platform.localhost @port = config.port @io = config.log @extra_args = config.args @shutdown_supported = config.shutdown_supported raise Error::WebDriverError, "invalid port: #{@port}" if @port < 1 end
def process_exited?
def process_exited? @process.nil? || @process.exited? end
def process_running?
def process_running? defined?(@process) && @process&.alive? end
def socket_lock
def socket_lock @socket_lock ||= SocketLock.new(@port - 1, SOCKET_LOCK_TIMEOUT) end
def start
def start raise "already started: #{uri.inspect} #{@executable_path.inspect}" if process_running? Platform.exit_hook { stop } # make sure we don't leave the server running socket_lock.locked do find_free_port start_process connect_until_stable end end
def start_process
def start_process @process = build_process(@executable_path, "--port=#{@port}", *@extra_args) @process.start end
def stop
def stop return unless @shutdown_supported return if process_exited? stop_server @process.poll_for_exit STOP_TIMEOUT rescue ChildProcess::TimeoutError, Errno::ECONNREFUSED nil # noop ensure stop_process end
def stop_process
def stop_process return if process_exited? @process.stop STOP_TIMEOUT end
def stop_server
def stop_server connect_to_server do |http| headers = WebDriver::Remote::Http::Common::DEFAULT_HEADERS.dup WebDriver.logger.debug('Sending shutdown request to server', id: :driver_service) http.get('/shutdown', headers) end end
def uri
def uri @uri ||= URI.parse("http://#{@host}:#{@port}") end