# Licensed to the Software Freedom Conservancy (SFC) under one # or more contributor license agreements. See the NOTICE file # distributed with this work for additional information # regarding copyright ownership. The SFC licenses this file # to you 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. module Selenium module WebDriver module Chrome # # Driver implementation for Chrome. # @api private # class Driver < WebDriver::Driver include DriverExtensions::HasNetworkConditions include DriverExtensions::HasTouchScreen include DriverExtensions::HasWebStorage include DriverExtensions::TakesScreenshot include DriverExtensions::DownloadsFiles def initialize(opts = {}) opts[:desired_capabilities] = create_capabilities(opts) unless opts.key?(:url) driver_path = opts.delete(:driver_path) || Chrome.driver_path driver_opts = opts.delete(:driver_opts) || {} port = opts.delete(:port) || Service::DEFAULT_PORT @service = Service.new(driver_path, port, driver_opts) @service.start opts[:url] = @service.uri end listener = opts.delete(:listener) @bridge = Remote::Bridge.handshake(opts) @bridge.extend Bridge super(@bridge, listener: listener) end def browser :chrome end def quit super ensure @service.stop if @service end private def create_capabilities(opts) caps = opts.delete(:desired_capabilities) { Remote::Capabilities.chrome } options = opts.delete(:options) { Options.new } args = opts.delete(:args) || opts.delete(:switches) if args WebDriver.logger.deprecate ':args or :switches', 'Selenium::WebDriver::Chrome::Options#add_argument' raise ArgumentError, ':args must be an Array of Strings' unless args.is_a? Array args.each { |arg| options.add_argument(arg.to_s) } end profile = opts.delete(:profile) if profile profile = profile.as_json if options.args.none? { |arg| arg =~ /user-data-dir/ } options.add_argument("--user-data-dir=#{profile[:directory]}") end if profile[:extensions] WebDriver.logger.deprecate 'Using Selenium::WebDriver::Chrome::Profile#extensions', 'Selenium::WebDriver::Chrome::Options#add_extension' profile[:extensions].each do |extension| options.add_encoded_extension(extension) end end end detach = opts.delete(:detach) options.add_option(:detach, true) if detach prefs = opts.delete(:prefs) if prefs WebDriver.logger.deprecate ':prefs', 'Selenium::WebDriver::Chrome::Options#add_preference' prefs.each do |key, value| options.add_preference(key, value) end end options = options.as_json caps.merge!(options) unless options[Options::KEY].empty? caps[:proxy] = opts.delete(:proxy) if opts.key?(:proxy) caps[:proxy] ||= opts.delete('proxy') if opts.key?('proxy') caps end end # Driver end # Chrome end # WebDriver end # Selenium