RWebSpec::Driver

     # File lib/rwebspec/driver.rb, line 423
423:     def absolutify_url(src, base_url, parent_url)
424:       if src.nil? || src.empty? || src == "//:" || src =~ /\s*http:\/\//i
425:         return src
426:       end
427: 
428:       return "#{base_url}#{src}" if src =~ /^\s*\//
429:       return "#{parent_url}#{src}" if parent_url
430:       return src
431:     end

     # File lib/rwebspec/driver.rb, line 382
382:     def absolutize_page(content, base_url, current_url_parent)
383:       modified_content = ""
384:       content.each_line do |line|
385:         if line =~ /<script\s+.*src=["'']?(.*)["'].*/i then
386:           script_src = $1
387:           substitute_relative_path_in_src_line(line, script_src, base_url, current_url_parent)
388:         elsif line =~ /<link\s+.*href=["'']?(.*)["'].*/i then
389:           link_href = $1
390:           substitute_relative_path_in_src_line(line, link_href, base_url, current_url_parent)
391:         elsif line =~ /<img\s+.*src=["'']?(.*)["'].*/i then
392:           img_src = $1
393:           substitute_relative_path_in_src_line(line, img_src, base_url, current_url_parent)
394:         end
395: 
396:         modified_content += line
397:       end
398:       return modified_content
399:     end

     # File lib/rwebspec/driver.rb, line 403
403:     def absolutize_page_hpricot(content, base_url, parent_url)
404:       return  absolutize_page(content, base_url, parent_url) if RUBY_PLATFORM == 'java'
405:       begin
406:         require 'hpricot'
407:         doc = Hpricot(content)
408:         base_url.slice!(-1) if ends_with?(base_url, "/")
409:         (doc/'link').each { |e| e['href'] = absolutify_url(e['href'], base_url, parent_url) || ""}
410:         (doc/'img').each { |e| e['src'] = absolutify_url(e['src'], base_url, parent_url) || ""}
411:         (doc/'script').each { |e| e['src'] = absolutify_url(e['src'], base_url, parent_url) || ""}
412:         return doc.to_html
413:       rescue => e
414:         absolutize_page(content, base_url, parent_url)
415:       end
416:     end

     # File lib/rwebspec/driver.rb, line 598
598:     def ajax_wait_for_element(element_id, seconds, status='show', check_interval = @@default_polling_interval)
599:       count = 0
600:       check_interval = 1 if check_interval < 1 or check_interval > seconds
601:       while count < (seconds / check_interval) do
602:         search_indicator = @web_browser.element_by_id(element_id)
603:         search_indicator_outer_html = search_indicator.outerHtml if search_indicator
604:         if status == 'hide'
605:           return true if search_indicator_outer_html and !search_indicator_outer_html.include?('style="DISPLAY: none"')
606:         else
607:           return true if search_indicator_outer_html and search_indicator_outer_html.include?('style="DISPLAY: none"')
608:         end
609:         sleep check_interval if check_interval > 0 and check_interval < 5 * 60 # wait max 5 minutes
610:         count += 1
611:       end
612:       return false
613:     end

     # File lib/rwebspec/driver.rb, line 549
549:     def allow(&block)
550:       yield
551:     end

     # File lib/rwebspec/driver.rb, line 166
166:     def attach_browser(how, what, options = {})
167:       options.merge!(:browser => is_firefox? ? "Firefox" : "IE")
168:       begin
169:         options.merge!(:base_url => browser.context.base_url)
170:       rescue => e
171:         puts "error to attach to browser: #{e}"
172:       end
173:       WebBrowser.attach_browser(how, what, options)
174:     end

     # File lib/rwebspec/driver.rb, line 121
121:     def begin_at(url)
122:       dump_caller_stack
123:       @web_browser.begin_at(url)
124:     end

    # File lib/rwebspec/driver.rb, line 70
70:     def browser
71:       @web_browser
72:     end

     # File lib/rwebspec/driver.rb, line 485
485:     def cell_with_id(cell_id)
486:       cell(:id, cell_id).text
487:     end

     # File lib/rwebspec/driver.rb, line 292
292:     def click_button_with_image_src_contains(image_filename)
293:       dump_caller_stack
294:       operation_delay
295:       found = nil
296:       raise "no buttons in this page" if buttons.length <= 0
297:       buttons.each { |btn|
298:         if btn && btn.src  && btn.src.include?(image_filename) then
299:           found = btn
300:           break
301:         end
302:       }
303:       raise "not image button with src: #{image_filename} found" if found.nil?
304:       found.click
305:     end

    # File lib/rwebspec/driver.rb, line 92
92:     def close_all_browsers
93:       if is_firefox?
94:         FireWatir::Firefox.close_all
95:       else
96:         Watir::IE.close_all
97:       end
98:     end

    # File lib/rwebspec/driver.rb, line 78
78:     def close_browser
79:       if @web_browser
80:         # Old iTest2 version
81:         # @web_browser.close_browser unless $ITEST2_LEAVE_BROWSER_OPEN_AFTER_RUN
82:         @web_browser.close_browser
83:       else
84:         WebBrowser.close_all_browsers
85:       end
86:     end

     # File lib/rwebspec/driver.rb, line 284
284:     def contains_text(text)
285:       @web_browser.contains_text(text)
286:     end

     # File lib/rwebspec/driver.rb, line 113
113:     def context
114:       @web_browser.context
115:     end

     # File lib/rwebspec/driver.rb, line 327
327:     def dump_response(stream = nil)
328:       @web_browser.dump_response(stream)
329:     end

     # File lib/rwebspec/driver.rb, line 320
320:     def element_by_id(elem_id)
321:       @web_browser.element_by_id(elem_id)
322:     end

     # File lib/rwebspec/driver.rb, line 314
314:     def element_text(elem_id)
315:       @web_browser.element_value(elem_id)
316:     end

     # File lib/rwebspec/driver.rb, line 445
445:     def ends_with?(str, suffix)
446:       suffix = suffix.to_s
447:       str[-suffix.length, suffix.length] == suffix
448:     end

     # File lib/rwebspec/driver.rb, line 278
278:     def enter_text_with_id(textfield_id, value)
279:       dump_caller_stack
280:       operation_delay
281:       text_field(:id, textfield_id).set(value)
282:     end

     # File lib/rwebspec/driver.rb, line 105
105:     def expect_page(page_clazz, argument = nil)
106:       if argument
107:         page_clazz.new(@web_browser, argument)
108:       else
109:         page_clazz.new(@web_browser)
110:       end
111:     end

     # File lib/rwebspec/driver.rb, line 559
559:     def failsafe(&block)
560:       begin
561:         yield
562:       rescue =>e
563:       end
564:     end

     # File lib/rwebspec/driver.rb, line 134
134:     def firefox
135:       @web_browser.firefox
136:     end

     # File lib/rwebspec/driver.rb, line 148
148:     def goto_page(page)
149:       operation_delay
150:       dump_caller_stack
151:       @web_browser.goto_page(page) if @web_browser
152:     end

     # File lib/rwebspec/driver.rb, line 159
159:     def goto_url(url)
160:       @web_browser.goto_url url
161:     end

     # File lib/rwebspec/driver.rb, line 128
128:     def ie
129:       @web_browser.ie
130:     end

     # File lib/rwebspec/driver.rb, line 138
138:     def is_firefox?
139:       @web_browser.is_firefox? if @web_browser
140:     end

     # File lib/rwebspec/driver.rb, line 499
499:     def is_linux?
500:       RUBY_PLATFORM.downcase.include?("linux")
501:     end

     # File lib/rwebspec/driver.rb, line 491
491:     def is_mac?
492:       RUBY_PLATFORM.downcase.include?("darwin")
493:     end

     # File lib/rwebspec/driver.rb, line 495
495:     def is_windows?
496:       RUBY_PLATFORM.downcase.include?("mswin") or RUBY_PLATFORM.downcase.include?("mingw32")
497:     end

     # File lib/rwebspec/driver.rb, line 469
469:     def label_with_id(label_id)
470:       label(:id, label_id.to_s).text
471:     end

     # File lib/rwebspec/driver.rb, line 308
308:     def new_popup_window(options)
309:       @web_browser.new_popup_window(options)
310:     end

     # File lib/rwebspec/driver.rb, line 526
526:     def on(page, &block)
527:       yield page
528:     end

    # File lib/rwebspec/driver.rb, line 30
30:     def open_browser(base_url = nil, options = {})
31:       base_url ||= $ITEST2_PROJECT_BASE_URL
32:       base_url ||= $BASE_URL
33:       raise "base_url must be set" if base_url.nil?
34: 
35:       default_options = {:speed => "fast",
36:           :visible => true,
37:           :highlight_colour => 'yellow',
38:           :close_others => true,
39:           :start_new => false,   # start a new browser always
40:       :go => true}
41: 
42:       options = default_options.merge options
43:       options[:firefox] = true if "Firefox" == $ITEST2_BROWSER || "Firefox" == $BROWSER
44:       ($ITEST2_HIDE_BROWSER) ? $HIDE_IE = true : $HIDE_IE = false
45: 
46:       if base_url =~ /^file:/
47:         uri_base = base_url
48:       else
49:         uri = URI.parse(base_url)
50:         uri_base = "#{uri.scheme}://#{uri.host}:#{uri.port}"
51:       end
52: 
53:       if options[:start_new] || $celerity_loaded
54:         @web_browser = WebBrowser.new(uri_base, nil, options)
55:       else
56:         @web_browser = WebBrowser.reuse(uri_base, options) # Reuse existing browser
57:       end
58: 
59:       if base_url =~ /^file:/
60:         goto_url(base_url) # for files, no base url
61:       else
62:         (uri.path.length == 0) ?  begin_at("/") :  begin_at(uri.path) if options[:go]
63:       end
64: 
65:       return @web_browser
66:     end

     # File lib/rwebspec/driver.rb, line 456
456:     def page_source
457:       @web_browser.page_source
458:     end

     # File lib/rwebspec/driver.rb, line 461
461:     def page_text
462:       @web_browser.text
463:     end

     # File lib/rwebspec/driver.rb, line 451
451:     def page_title
452:       @web_browser.page_title
453:     end

     # File lib/rwebspec/driver.rb, line 667
667:     def repeat_try(num_tries = @@default_timeout || 30, interval = @@default_polling_interval || 1, &block)
668:       num_tries ||= 1
669:       (num_tries - 1).times do |num|
670:         begin
671:           yield
672:           return
673:         rescue => e
674:           # puts "debug: #{num} failed: #{e}"
675:           sleep interval
676:         end
677:       end
678: 
679:       # last try, throw error if still fails
680:       begin
681:         yield
682:       rescue => e
683:         raise e.to_s + " after trying #{num_tries} times every #{interval} seconds"
684:       end
685:       yield
686:     end

     # File lib/rwebspec/driver.rb, line 334
334:     def save_current_page(options = {})
335:       default_options = {:replacement => true}
336:       options = default_options.merge(options)
337:       if options[:dir]
338:         # already defined the dir
339:         to_dir = options[:dir]
340:       elsif $ITEST2_RUNNING_SPEC_ID && $ITEST2_WORKING_DIR
341: 
342:         $ITEST2_DUMP_DIR = File.join($ITEST2_WORKING_DIR, "dump")
343:         FileUtils.mkdir($ITEST2_DUMP_DIR) unless File.exists?($ITEST2_DUMP_DIR)
344: 
345:         spec_run_id = $ITEST2_RUNNING_SPEC_ID
346:         spec_run_dir_name = spec_run_id.to_s.rjust(4, "0") unless spec_run_id == "unknown"
347:         to_dir = File.join($ITEST2_DUMP_DIR, spec_run_dir_name)
348:       else
349:         to_dir = ENV['TEMP_DIR'] || (is_windows? ? "C:\\temp" : "/tmp") 
350:       end
351: 
352:       if options[:filename]
353:         file_name = options[:filename]
354:       else
355:         file_name = Time.now.strftime("%m%d%H%M%S") + ".html"
356:       end
357: 
358:       Dir.mkdir(to_dir) unless File.exists?(to_dir)
359:       file = File.join(to_dir, file_name)
360: 
361:       content = page_source
362:       base_url = @web_browser.context.base_url
363:       current_url = @web_browser.url
364:       current_url =~ /(.*\/).*$/
365:       current_url_parent = $1
366:       if options[:replacement] && base_url =~ /^http:/
367:         File.new(file, "w").puts absolutize_page_hpricot(content, base_url, current_url_parent)
368:       else
369:         File.new(file, "w").puts content
370:       end
371: 
372:     end

     # File lib/rwebspec/driver.rb, line 534
534:     def shall_not_allow(&block)
535:       operation_performed_ok = false
536:       begin
537:         yield
538:         operation_performed_ok  = true
539:       rescue
540:       end
541:       raise "Operation shall not be allowed" if operation_performed_ok
542:     end

     # File lib/rwebspec/driver.rb, line 477
477:     def span_with_id(span_id)
478:       span(:id, span_id).text
479:     end

     # File lib/rwebspec/driver.rb, line 434
434:     def substitute_relative_path_in_src_line(line, script_src, host_url, page_parent_url)
435:       unless script_src =~ /^["']?http:/
436:         host_url.slice!(-1) if ends_with?(host_url, "/")
437:         if script_src =~ /^\s*\// # absolute_path
438:           line.gsub!(script_src, "#{host_url}#{script_src}")
439:         else  #relative_path
440:           line.gsub!(script_src, "#{page_parent_url}#{script_src}")
441:         end
442:       end
443:     end

     # File lib/rwebspec/driver.rb, line 507
507:     def support_utf8
508:       if is_windows?
509:         require 'win32ole'
510:         WIN32OLE.codepage = WIN32OLE::CP_UTF8
511:       end
512:     end

     # File lib/rwebspec/driver.rb, line 717
717:     def symbol_to_sequence(symb)
718:       value = { :zero => 0,
719:           :first => 1,
720:           :second => 2,
721:           :third => 3,
722:           :fourth => 4,
723:           :fifth => 5,
724:           :sixth => 6,
725:           :seventh => 7,
726:           :eighth => 8,
727:           :ninth => 9,
728:           :tenth => 10 }[symb]
729:       return value || symb.to_i
730:     end

     # File lib/rwebspec/driver.rb, line 696
696:     def try(timeout = @@default_timeout, polling_interval = @@default_polling_interval || 1, &block)
697:       start_time = Time.now
698: 
699:       last_error = nil
700:       until (duration = Time.now - start_time) > timeout
701:         begin
702:           return if yield
703:           last_error = nil
704:         rescue => e
705:           last_error = e
706:         end
707:         sleep polling_interval
708:       end
709: 
710:       raise "Timeout after #{duration.to_i} seconds with error: #{last_error}." if last_error
711:       raise "Timeout after #{duration.to_i} seconds."
712:     end

     # File lib/rwebspec/driver.rb, line 180
180:     def use_current_browser(how = :title, what = /.*/)
181:       @web_browser = WebBrowser.attach_browser(how, what)
182:     end

     # File lib/rwebspec/driver.rb, line 618
618:     def wait_for_element(element_id, timeout = @@default_timeout, interval = @@default_polling_interval)
619:       start_time = Time.now
620:       #TODO might not work with Firefox
621:       until @web_browser.element_by_id(element_id) do
622:         sleep(interval)
623:         if (Time.now - start_time) > timeout
624:           raise RuntimeError, "failed to find element: #{element_id} for max #{timeout}"
625:         end
626:       end
627:     end

     # File lib/rwebspec/driver.rb, line 578
578:     def wait_until(timeout = @@default_timeout || 30, polling_interval = @@default_polling_interval || 1, &block)
579:       waiter = Watir::Waiter.new(timeout, polling_interval)
580:       waiter.wait_until { yield }
581:     end