Class: Selenium::WebDriver::Firefox::Binary Private

Inherits:
Object
  • Object
show all
Defined in:
lib/selenium/webdriver/firefox/binary.rb

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

Constant Summary collapse

NO_FOCUS_LIBRARY_NAME =

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

"x_ignore_nofocus.so"
NO_FOCUS_LIBRARIES =

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

[
  ["#{WebDriver.root}/selenium/webdriver/firefox/native/linux/amd64/#{NO_FOCUS_LIBRARY_NAME}", "amd64/#{NO_FOCUS_LIBRARY_NAME}"],
  ["#{WebDriver.root}/selenium/webdriver/firefox/native/linux/x86/#{NO_FOCUS_LIBRARY_NAME}", "x86/#{NO_FOCUS_LIBRARY_NAME}"],
]
WAIT_TIMEOUT =

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

90
QUIT_TIMEOUT =

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

5

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.path ⇒ Object

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.

[View source]

101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
 
# File 'lib/selenium/webdriver/firefox/binary.rb', line 101

def path
  @path ||= case Platform.os
            when :macosx
              macosx_path
            when :windows
              windows_path
            when :linux, :unix
              Platform.find_binary("firefox3", "firefox2", "firefox") || "/usr/bin/firefox"
            else
              raise Error::WebDriverError, "unknown platform: #{Platform.os}"
            end

  @path = Platform.cygwin_path(@path) if Platform.cygwin?

  unless File.file?(@path.to_s)
    raise Error::WebDriverError, "Could not find Firefox binary (os=#{Platform.os}). Make sure Firefox is installed or set the path manually with #{self}.path="
  end

  @path
end

.path=(path) ⇒ Object

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.

See Also:

[View source]

96
97
98
99
 
# File 'lib/selenium/webdriver/firefox/binary.rb', line 96

def path=(path)
  Platform.assert_executable(path)
  @path = path
end

Instance Method Details

#quit ⇒ Object

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.

[View source]

34
35
36
37
38
39
40
 
# File 'lib/selenium/webdriver/firefox/binary.rb', line 34

def quit
  return unless @process
  @process.poll_for_exit QUIT_TIMEOUT
rescue ChildProcess::TimeoutError
  # ok, force quit
  @process.stop QUIT_TIMEOUT
end

#start_with(profile, profile_path, *args) ⇒ Object

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.

[View source]

17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
 
# File 'lib/selenium/webdriver/firefox/binary.rb', line 17

def start_with(profile, profile_path, *args)
  profile_path = profile_path.gsub("/", "\\") if Platform.win?

  ENV['XRE_CONSOLE_LOG']           = profile.log_file if profile.log_file
  ENV['XRE_PROFILE_PATH']          = profile_path
  ENV['MOZ_NO_REMOTE']             = '1' # able to launch multiple instances
  ENV['MOZ_CRASHREPORTER_DISABLE'] = '1' # disable breakpad
  ENV['NO_EM_RESTART']             = '1' # prevent the binary from detaching from the console

  if Platform.linux? && (profile.native_events? || profile.load_no_focus_lib?)
    modify_link_library_path profile_path
  end

  execute(*args)
  cope_with_mac_strangeness(args) if Platform.mac?
end

#wait ⇒ Object

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.

[View source]

42
43
44
 
# File 'lib/selenium/webdriver/firefox/binary.rb', line 42

def wait
  @process.poll_for_exit(WAIT_TIMEOUT) if @process
end