File: //lib/ruby/vendor_ruby/selenium/webdriver/chrome/driver.rb
# frozen_string_literal: true
# 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::HasLocation
include DriverExtensions::TakesScreenshot
include DriverExtensions::DownloadsFiles
def initialize(opts = {})
opts[:desired_capabilities] = create_capabilities(opts)
opts[:url] ||= service_url(opts)
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
end
def execute_cdp(cmd, **params)
@bridge.send_command(cmd: cmd, params: params)
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
WebDriver.logger.deprecate 'Selenium::WebDriver::Chrome::Driver#new with `:profile` parameter',
'Selenium::WebDriver::Chrome::Options#profile or Options#add_option'
profile = profile.as_json
if options.args.none?(&/user-data-dir/.method(:match?))
options.add_argument("--user-data-dir=#{profile['directory']}")
end
if profile['extensions']
WebDriver.logger.deprecate 'Selenium::WebDriver::Chrome::Profile#extensions',
'Selenium::WebDriver::Chrome::Options#add_extension'
profile['extensions'].each do |extension|
options.add_encoded_extension(extension)
end
end
end
if opts.key?(:detach)
WebDriver.logger.deprecate 'Selenium::WebDriver::Chrome::Driver#new with `:detach` parameter',
'Selenium::WebDriver::Chrome::Options#new or Options#add_option'
options.add_option(:detach, opts.delete(:detach))
end
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?
if opts.key?(:proxy) || opts.key?('proxy')
WebDriver.logger.deprecate 'Selenium::WebDriver::Chrome::Driver#new with `:proxy` parameter',
'Selenium::WebDriver::Chrome::Capabilities#proxy='
caps[:proxy] = opts.delete(:proxy) if opts.key?(:proxy)
caps[:proxy] ||= opts.delete('proxy') if opts.key?('proxy')
end
caps
end
end # Driver
end # Chrome
end # WebDriver
end # Selenium