module Watir::HasWindow

Public Instance Methods

original_window() click to toggle source

Returns original window if defined, current window if not See Window#use

@example

browser.window(title: 'closeable window').use
browser.original_window.use

@return [Window]

# File lib/watir/has_window.rb, line 44
def original_window
  @original_window ||= window
end
switch_window() click to toggle source

Waits for and returns second window if present See Window#use

@example

browser.switch_window

@return [Window]

# File lib/watir/has_window.rb, line 58
def switch_window
  current_window = window
  wins = windows
  wait_until { (wins = windows) && wins.size > 1 } if wins.size == 1
  raise StandardError, 'Unable to determine which window to switch to' if wins.size > 2

  wins.find { |w| w != current_window }.use
  window
end
window(*args, &blk) click to toggle source

Returns browser window.

@example

browser.window(title: 'closeable window')

@return [Window]

# File lib/watir/has_window.rb, line 25
def window(*args, &blk)
  win = Window.new self, extract_selector(args)

  win.use(&blk) if block_given?

  win
end
windows(*args) click to toggle source

Returns browser windows array.

@example

browser.windows(title: 'closeable window')

@return [Array<Window>]

# File lib/watir/has_window.rb, line 12
def windows(*args)
  WindowCollection.new self, extract_selector(args)
end