Class: Selenium::WebDriver::Options

Inherits:
Object
  • Object
show all
Defined in:
lib/selenium/webdriver/common/options.rb

Instance Method Summary collapse

Constructor Details

#initialize(bridge) ⇒ Options

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns a new instance of Options.



26
27
28
 
# File 'lib/selenium/webdriver/common/options.rb', line 26

def initialize(bridge)
  @bridge = bridge
end

Instance Method Details

Add a cookie to the browser

Parameters:

  • opts (Hash) (defaults to: {}) —

    the options to create a cookie with.

Options Hash (opts):

  • :name (String) —

    A name

  • :value (String) —

    A value

  • :path (String) — default: '/' —

    A path

  • :secure (String) — default: false —

    A boolean

  • :expires (Time, DateTime, Numeric, nil) — default: nil —

    Expiry date, either as a Time, DateTime, or seconds since epoch.

Raises:

  • (ArgumentError) —

    if :name or :value is not specified



43
44
45
46
47
48
49
50
51
52
53
54
55
56
 
# File 'lib/selenium/webdriver/common/options.rb', line 43

def add_cookie(opts = {})
  raise ArgumentError, "name is required" unless opts[:name]
  raise ArgumentError, "value is required" unless opts[:value]

  opts[:path] ||= "/"
  opts[:secure] ||= false

  if obj = opts.delete(:expires)
    opts[:expiry] = seconds_from(obj)
  end


  @bridge.addCookie opts
end

#all_cookies ⇒ Array<Hash>

Get all cookies

Returns:

  • (Array<Hash>) —

    list of cookies



93
94
95
96
97
98
99
100
101
102
103
104
 
# File 'lib/selenium/webdriver/common/options.rb', line 93

def all_cookies
  @bridge.getAllCookies.map do |cookie|
    {
      :name    => cookie["name"],
      :value   => cookie["value"],
      :path    => cookie["path"],
      :domain  => cookie["domain"] && strip_port(cookie["domain"]),
      :expires => cookie["expiry"] && datetime_at(cookie['expiry']),
      :secure  => cookie["secure"]
    }
  end
end

#cookie_named(name) ⇒ Hash?

Get the cookie with the given name

Parameters:

  • name (String) —

    the name of the cookie

Returns:

  • (Hash, nil) —

    the cookie, or nil if it wasn’t found.



65
66
67
 
# File 'lib/selenium/webdriver/common/options.rb', line 65

def cookie_named(name)
  all_cookies.find { |c| c[:name] == name }
end

#delete_all_cookies ⇒ Object

Delete all cookies



83
84
85
 
# File 'lib/selenium/webdriver/common/options.rb', line 83

def delete_all_cookies
  @bridge.deleteAllCookies
end

#delete_cookie(name) ⇒ Object

Delete the cookie with the given name

Parameters:

  • name (String) —

    the name of the cookie to delete



75
76
77
 
# File 'lib/selenium/webdriver/common/options.rb', line 75

def delete_cookie(name)
  @bridge.deleteCookie name
end

#logs ⇒ Object 



114
115
116
 
# File 'lib/selenium/webdriver/common/options.rb', line 114

def logs
  @logs ||= Logs.new(@bridge)
end

#timeouts ⇒ Object 



106
107
108
 
# File 'lib/selenium/webdriver/common/options.rb', line 106

def timeouts
  @timeouts ||= Timeouts.new(@bridge)
end

#window ⇒ Object 



122
123
124
 
# File 'lib/selenium/webdriver/common/options.rb', line 122

def window
  @window ||= Window.new(@bridge)
end