NAME

Win32::Watir - Perl extension for automating Internet Explorer.

SYNOPSIS

 use Win32::Watir;

 # Creating new instance of Internet Explorer
 my $ie = Win32::Watir::new(
   visible => 1,
   maximize => 1,
 );

DESCRIPTION

Win32::Watir helps you to write tests that are easy to read and easy to maintain.

Watir drives browsers the same way people do. It clicks links, fills in forms, presses buttons. Watir also checks results, such as whether expected text appears on the page.

Win32::Watir is inspired on Ruby/Watir, then fork Win32::IEAutomation.

 Win32::IEAutomation special nice interface at perl and windows, but
 some method doesn't support IE7, IE8 for Window/Dialog name changes.
 Win32::Watir are support IE7, IE8 and use more compatible/like Ruby/Watir
 method names, ..etc.

* Ruby/Watir : http://wtr.rubyforge.org/

* Win32::IEAutomation : http://search.cpan.org/perldoc?Win32::IEAutomation

you may require setup Multiple_IE when using this with IE6.0

options are supported to this method in hash format.

warnings => 0 or 1 0: output no warning. 1: output some warnings.

maximize => 0 or 1 0: default window size. 1: maximize IE window when IE start.

visible => 0 or 1 0: IE window invisible. 1: IE window visible.

codepage => undef or 'utf8' undef: use default codepage at your Windows. utf8 : use Win32::OLE::CP_UTF8 codepage.

if no options specified, use those default.

 $ie = new Win32::Watir(
        warnings => 0,
        maximize => 0,
        visible  => 1,
        codepage => undef,
        );

close

closeIE

close IE window.

goto(url)

gotoURL(url)

 # Site navigation
 $ie->goto('http://www.google.com');

back()

Back()

IE window back. same as "back button" or type Backspace key.

reload()

Reload()

reload, refresh IE page. same as type 'F5' key.

URL()

return current page URL.

title

Title

return current page title.

html

Content

return current page html.

 notice: "CR" code (\r) removed from html.

getLink(how, value)

 # Finding hyperlinks and clicking them
 # Using 'linktext:' option (text of the link shown on web page)
 $ie->getLink('linktext:', "About Google")->Click;      
 # Or using 'linktext:' option with pattern matching
 $ie->getLink('linktext:', qr/About Google/)->Click;
 # Or using 'id:' option ( <a id=1a class=q href=......>)
 $ie->getLink('id:', "1a")->Click;

register_autoitx_dll(dll_path)

Register specified dll to Server.

 arg[0] : dll path.

maximize_ie()

maximize specified title window.

 arg[0] : window Title name (optional)

trim_white_spacs()

 return string - trim \s+

SEE ALSO

 Win32
 Win32::OLE
 Win32::IEAutomation

AUTHOR

 Kazuhito Shimizu, <kazuhito.shimizu@gmail.com>

COPYRIGHT AND LICENSE

same as Win32::IEAutomation..

[ToDO] more detail..

cpanm Win32::Watir

perl -MCPAN -e shell
install Win32::Watir