bio-cona: Watir 方法

Class

Watir::IE

In:

watir.rb

Parent:

Object

This class is the main Internet Explorer Controller An instance of this must be created to access Internet Explorer.

http://wtr.rubyforge.org/rdoc/classes/Watir/IE.html#M000293

Methods

Included Modules

Watir::Exception SupportsSubElements

Constants

REVISION	=	"$Revision: 1.211.2.2 $"	The revision number ( according to CVS )
VERSION	=	"1.4.1"	the Release number
READYSTATE_COMPLETE	=	4	Used internally to determine when IE has finished loading a page
DEFAULT_TYPING_SPEED	=	0.08	The default delay when entering text on a web page.
DEFAULT_SLEEP_TIME	=	0.1	The default time we wait after a page has loaded.
DEFAULT_HIGHLIGHT_COLOR	=	"yellow"	The default color for highlighting objects as they are accessed.

Attributes

activeObjectHighLightColor	[RW]	The color we want to use for the active object. This can be any valid web-friendly color.
defaultSleepTime	[RW]	This is used to change how long after a page has finished loading that we wait for.
down_load_time	[R]	use this to get the time for the last page download
enable_spinner	[RW]	use this to switch the spinner on and off
ie	[R]	Use this to gain access to the ‘raw’ internet explorer object.
logger	[RW]	access to the logger object
newWindow	[RW]	When a new window is created it is stored in newWindow
typingspeed	[RW]	This is used to change the typing speed when entering text on a page.
url_list	[R]	this contains the list of unique urls that have been visited

Public Class methods

attach(how, what)

Attach to an existing IE window, either by url or title. IE.attach(:url, ‘www.google.com’) IE.attach(:title, ‘Google’)

new(suppress_new_window=nil)

start( url = nil )

Create a new IE Window, starting at the specified url. If no url is given, start empty.

Public Instance methods

add_checker( checker)

this method is used to add an error checker that gets executed on every page load

checker Proc Object, that contains the code to be run

attach_init( how, what )

this method is used internally to attach to an existing window dont make private

back()

Go to the previous page - the same as clicking the browsers back button an WIN32OLERuntimeError exception is raised if the browser cant go back

bring_to_front()

Make the window come to the front

check_for_http_error(ie)

This method checks the currently displayed page for http errors, 404, 500 etc It gets called internally by the wait method, so a user does not need to call it explicitly

clear_url_list()

clear the list of urls that we have visited

close()

Closes the Browser

contains_text(text)

Search the current page for specified text or regexp. Returns true if the specified text was found. Returns matchdata object if the specified regexp was found.

 * text - string or regular expression - the string to look for

dir()

used by the popup code only

disable_checker( checker )

this allows a checker to be disabled

checker Proc Object, the checker that is to be disabled

document()

Return the current document

focus()

This method gives focus to the frame It may be removed and become part of the frame object

forward()

Go to the next page - the same as clicking the browsers forward button an WIN32OLERuntimeError exception is raised if the browser cant go forward

front?()

getIE()

Deprecated: Use IE#ie instead This method returns the Internet Explorer object. Methods, properties, etc. that the IE object does not support can be accessed.

goto( url )

Navigate to the specified URL.

 * url  - string - the URL to navigate to

html()

The HTML of the current page

log( what )

maximize()

Maximize the window (expands to fill the screen)

minimize()

Minimize the window (appears as icon on taskbar)

refresh()

Refresh the current page - the same as clicking the browsers refresh button an WIN32OLERuntimeError exception is raised if the browser cant refresh

restore()

Restore the window (after minimizing or maximizing)

run_error_checks()

this method runs the predefined error checks

send_keys(key_string)

Send key events to IE window. See www.autoitscript.com/autoit3/docs/appendix/SendKeys.htm for complete documentation on keys supported and syntax.

set_fast_speed()

set_logger( logger )

deprecated: use logger= instead

set_slow_speed()

show_active()

this method shows the name, id etc of the object that is currently active - ie the element that has focus its mostly used in irb when creating a script

show_all_objects()

This method shows the available objects on the current page. This is usually only used for debugging or writing new test scripts. This is a nice feature to help find out what HTML objects are on a page when developing a test case using Watir.

show_divs()

this method shows all the divs availble in the document

show_forms()

Show all forms displays all the forms that are on a web page.

show_frames()

This method is used to display the available html frames that Internet Explorer currently has loaded. This method is usually only used for debugging test scripts.

show_images()

this method shows all the images availble in the document

show_labels()

show_links()

this method shows all the links availble in the document

show_spans()

this method shows all the spans availble in the document

show_tables()

this method is used to show all the tables that are available

status()

Return the status of the window, typically from the status bar at the bottom.

text()