WWW::Scripter::WindowGroup - Multiple-window browsing environment
Version 0.030
use WWW'Scripter'WindowGroup; $browser = new WWW'Scripter'WindowGroup; # This has one window already # OR: $browser = new WWW'Scripter'WindowGroup empty => 1; $browser->attach($w = new WWW'Scripter); $w = $browser->active_window; $w->get('http://ghare.dr/'); $w->close; $w = $browser->new_window; @w = $browser->windows;
This module provides a virtual multiple-window browsing environment for WWW::Scripter. It does not actually create any windows on the screen, but it can be used to script websites that make use of multiple windows. The individual windows themselves are WWW::Scripter objects.
Before you start using this, consider whether the site you are scripting actually needs multiple windows. If a single-window environment will do, use WWW::Scripter directly.
Note: Window groups hold strong references to their windows, but the windows themselves hold weak references to the window group. So if you let a window group go out of scope while retaining a reference to a window, that window will revert to single-window mode.
The constructor. Call this method on the class, not on an object thereof. It takes no arguments.
Returns the window that is currently 'active'. This can be changed by scripts calling the focus method on a window, or opening a new one, so keep your own reference to it if you need to refer to a specific window repeatedly.
focus
Returns a list of all windows in list context, or the number of windows in scalar context.
Adds a new WWW::Scripter to the window group and returns it.
This methods adds a window to the group, making it the frontmost window and setting its window_group attribute appropriately.
window_group
If you attach a window that is already attached to another group, strange things may happen. Detach it first.
This removes the window from the group and sets its window_group attribute to undef. This is used internally by WWW::Scripter's close method.
undef
close
This makes $window the active window.
$window
See WWW::Scripter
WWW::Scripter
To install WWW::Scripter::WindowGroup, copy and paste the appropriate command in to your terminal.
cpanm
cpanm WWW::Scripter::WindowGroup
CPAN shell
perl -MCPAN -e shell install WWW::Scripter::WindowGroup
For more information on module installation, please visit the detailed CPAN module installation guide.