Class: Selenium::WebDriver::Firefox::Profile

Inherits:
Object
  • Object
show all
Includes:
ProfileHelper
Defined in:
rb/lib/selenium/webdriver/firefox/profile.rb

Constant Summary

VALID_PREFERENCE_TYPES =
[TrueClass, FalseClass, Integer, Float, String]
WEBDRIVER_EXTENSION_PATH =
File.expand_path("#{WebDriver.root}/selenium/webdriver/firefox/extension/webdriver.xpi")
WEBDRIVER_PREFS =
{
  :native_events    => 'webdriver_enable_native_events',
  :untrusted_certs  => 'webdriver_accept_untrusted_certs',
  :untrusted_issuer => 'webdriver_assume_untrusted_issuer',
  :port             => 'webdriver_firefox_port',
  :log_file         => 'webdriver.log.file'
}

Instance Attribute Summary (collapse)

Class Method Summary (collapse)

Instance Method Summary (collapse)

Methods included from ProfileHelper

#as_json, included, #to_json

Constructor Details

- (Profile) initialize(model = nil)

Create a new Profile instance

Examples:

User configured profile

profile = Selenium::WebDriver::Firefox::Profile.new
profile['network.proxy.http'] = 'localhost'
profile['network.proxy.http_port'] = 9090

driver = Selenium::WebDriver.for :firefox, :profile => profile


48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
# File 'rb/lib/selenium/webdriver/firefox/profile.rb', line 48

def initialize(model = nil)
  @model = verify_model(model)

  model_prefs = read_model_prefs

  if model_prefs.empty?
    @native_events     = DEFAULT_ENABLE_NATIVE_EVENTS
    @secure_ssl        = DEFAULT_SECURE_SSL
    @untrusted_issuer  = DEFAULT_ASSUME_UNTRUSTED_ISSUER
    @load_no_focus_lib = DEFAULT_LOAD_NO_FOCUS_LIB

    @additional_prefs  = {}
  else
    # TODO: clean this up
    @native_events     = model_prefs.delete(WEBDRIVER_PREFS[:native_events]) == "true"
    @secure_ssl        = model_prefs.delete(WEBDRIVER_PREFS[:untrusted_certs]) != "true"
    @untrusted_issuer  = model_prefs.delete(WEBDRIVER_PREFS[:untrusted_issuer]) == "true"
    @load_no_focus_lib = model_prefs.delete(WEBDRIVER_PREFS[:load_no_focus_lib]) == "true" # not stored in profile atm, so will always be false.
    @additional_prefs  = model_prefs
  end

  @extensions        = {}
end

Instance Attribute Details

- (Object) load_no_focus_lib=(value) (writeonly)

Sets the attribute load_no_focus_lib

Parameters:

  • value

    the value to set the attribute load_no_focus_lib to.



18
19
20
# File 'rb/lib/selenium/webdriver/firefox/profile.rb', line 18

def load_no_focus_lib=(value)
  @load_no_focus_lib = value
end

- (Object) log_file

Returns the value of attribute log_file



17
18
19
# File 'rb/lib/selenium/webdriver/firefox/profile.rb', line 17

def log_file
  @log_file
end

- (Object) name (readonly)

Returns the value of attribute name



17
18
19
# File 'rb/lib/selenium/webdriver/firefox/profile.rb', line 17

def name
  @name
end

- (Object) native_events=(value) (writeonly)

Sets the attribute native_events

Parameters:

  • value

    the value to set the attribute native_events to.



18
19
20
# File 'rb/lib/selenium/webdriver/firefox/profile.rb', line 18

def native_events=(value)
  @native_events = value
end

- (Object) secure_ssl=(value) (writeonly)

Sets the attribute secure_ssl

Parameters:

  • value

    the value to set the attribute secure_ssl to.



18
19
20
# File 'rb/lib/selenium/webdriver/firefox/profile.rb', line 18

def secure_ssl=(value)
  @secure_ssl = value
end

Class Method Details

+ (Object) default_preferences



29
30
31
32
33
# File 'rb/lib/selenium/webdriver/firefox/profile.rb', line 29

def default_preferences
  @default_preferences ||= WebDriver.json_load(
    File.read(File.expand_path("#{WebDriver.root}/selenium/webdriver/firefox/extension/prefs.json"))
  ).freeze
end

+ (Object) from_name(name)



25
26
27
# File 'rb/lib/selenium/webdriver/firefox/profile.rb', line 25

def from_name(name)
  ini[name]
end

+ (Object) ini



21
22
23
# File 'rb/lib/selenium/webdriver/firefox/profile.rb', line 21

def ini
  @ini ||= ProfilesIni.new
end

Instance Method Details

- (Object) []=(key, value)

Set a preference for this particular profile.



92
93
94
95
96
97
98
99
100
101
102
# File 'rb/lib/selenium/webdriver/firefox/profile.rb', line 92

def []=(key, value)
  unless VALID_PREFERENCE_TYPES.any? { |e| value.kind_of? e }
    raise TypeError, "expected one of #{VALID_PREFERENCE_TYPES.inspect}, got #{value.inspect}:#{value.class}"
  end

  if value.kind_of?(String) && Util.stringified?(value)
    raise ArgumentError, "preference values must be plain strings: #{key.inspect} => #{value.inspect}"
  end

  @additional_prefs[key.to_s] = value
end

- (Object) add_extension(path, name = extension_name_for(path))

Add the extension (directory, .zip or .xpi) at the given path to the profile.



123
124
125
# File 'rb/lib/selenium/webdriver/firefox/profile.rb', line 123

def add_extension(path, name = extension_name_for(path))
  @extensions[name] = Extension.new(path)
end

- (Object) add_webdriver_extension



113
114
115
116
117
# File 'rb/lib/selenium/webdriver/firefox/profile.rb', line 113

def add_webdriver_extension
  unless @extensions.has_key?(:webdriver)
    add_extension(WEBDRIVER_EXTENSION_PATH, :webdriver)
  end
end

- (Object) assume_untrusted_certificate_issuer=(bool)



143
144
145
# File 'rb/lib/selenium/webdriver/firefox/profile.rb', line 143

def assume_untrusted_certificate_issuer=(bool)
  @untrusted_issuer = bool
end

- (Boolean) assume_untrusted_certificate_issuer?

Returns:

  • (Boolean)


139
140
141
# File 'rb/lib/selenium/webdriver/firefox/profile.rb', line 139

def assume_untrusted_certificate_issuer?
  @untrusted_issuer == true
end

- (Object) layout_on_disk



72
73
74
75
76
77
78
79
80
81
82
# File 'rb/lib/selenium/webdriver/firefox/profile.rb', line 72

def layout_on_disk
  profile_dir = @model ? create_tmp_copy(@model) : Dir.mktmpdir("webdriver-profile")
  FileReaper << profile_dir

  install_extensions(profile_dir)
  delete_lock_files(profile_dir)
  delete_extensions_cache(profile_dir)
  update_user_prefs_in(profile_dir)

  profile_dir
end

- (Boolean) load_no_focus_lib?

Returns:

  • (Boolean)


131
132
133
# File 'rb/lib/selenium/webdriver/firefox/profile.rb', line 131

def load_no_focus_lib?
  @load_no_focus_lib == true
end

- (Boolean) native_events?

Returns:

  • (Boolean)


127
128
129
# File 'rb/lib/selenium/webdriver/firefox/profile.rb', line 127

def native_events?
  @native_events == true
end

- (Object) port=(port)



104
105
106
# File 'rb/lib/selenium/webdriver/firefox/profile.rb', line 104

def port=(port)
  self[WEBDRIVER_PREFS[:port]] = port
end

- (Object) proxy=(proxy)



147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
# File 'rb/lib/selenium/webdriver/firefox/profile.rb', line 147

def proxy=(proxy)
  unless proxy.kind_of? Proxy
    raise TypeError, "expected #{Proxy.name}, got #{proxy.inspect}:#{proxy.class}"
  end

  case proxy.type
  when :manual
    self['network.proxy.type'] = 1

    set_manual_proxy_preference "ftp", proxy.ftp
    set_manual_proxy_preference "http", proxy.http
    set_manual_proxy_preference "ssl", proxy.ssl

    if proxy.no_proxy
      self["network.proxy.no_proxies_on"] = proxy.no_proxy
    else
      self["network.proxy.no_proxies_on"] = ""
    end
  when :pac
    self['network.proxy.type'] = 2
    self['network.proxy.autoconfig_url'] = proxy.pac
  when :auto_detect
    self['network.proxy.type'] = 4
  else
    raise ArgumentError, "unsupported proxy type #{proxy.type}"
  end

  proxy
end

- (Boolean) secure_ssl?

Returns:

  • (Boolean)


135
136
137
# File 'rb/lib/selenium/webdriver/firefox/profile.rb', line 135

def secure_ssl?
  @secure_ssl == true
end