Huddled Masses » WebDesign http://huddledmasses.org You can do more than breathe for free... Sat, 28 Jan 2012 21:37:20 +0000 en hourly 1 http://wordpress.org/?v=3.3.1 Using PowerShell and WatiN (PowerWatin?) http://huddledmasses.org/using-powershell-and-watin-powerwatin/ http://huddledmasses.org/using-powershell-and-watin-powerwatin/#comments Wed, 11 Mar 2009 06:10:50 +0000 Joel 'Jaykul' Bennett http://huddledmasses.org/?p=1111 This is an update to a previous article.

Someone asked (on Twitter) about using WatiN from PowerShell, and pointed to this old post by Scott Hanselman saying he was having the same problems … so I wrote this to help them out:

WatiN requires -STA mode

Note: WatiN requires Single Threaded Apartment mode, so you need to be using PowerShell 2.0 (currently in CTP3) in order for any of this to work, and you need to pass the -STA parameter to PowerShell. Regardless, I thought I’d throw two tips out here:

Don’t use LoadFile, use LoadFrom

I’m not 100% sure when it’s appropriate to use LoadFile in PowerShell, but I can tell you that if your assembly is in a folder with a bunch of other assemblies upon which it depends … you need to use [Reflection.Assembly]::LoadFrom( $path ) instead — because the .net loader will be able to find the dependencies.

Generate some functions to help yourself out

It’s trivial to do code-generation in PowerShell, and WatiN is not friendly to the PowerShell syntax, so you’re going to want to generate a bunch of them. To get you started, here’s a set of Find-* functions to let you find each type of element that WatiN recognizes and automates… by name, id, class, style … well, by any attribute, really:


Function Start-Watin {
## CHANGE this to point to your WatiN.Core.dll
$WatinPath = Convert-Path (Resolve-Path "$(Split-Path $Profile)\Libraries\WatiN.Core.dll")
## Load the assembly
$global:watin = [Reflection.Assembly]::LoadFrom( $WatinPath )
## Create an initial window (I'm creating IE, but WatiN handles Firefox too)
$global:ie = new-object WatiN.Core.IE("http://www.google.com")
## Generate Find-Button, Find-TextField, etc:
$ie | Get-Member -Type Method |
      Where-Object {
         $type = $_.Definition.Split(" ")[0]
         [WatiN.Core.Element].IsAssignableFrom( ([type]$type) )
      } | ForEach-Object {
         New-Item -Path "Function:Find-$($_.Name)" -Value $( iex @"
{
Param(`$Attribute, [regex]`$value)
`$ie.$($_.Name)( ([Watin.Core.Find]::By( `$Attribute, `$value)) )
}
"@      )
      }
}

With just that little bit of code, I generated all of these functions:

  • Find-Area
  • Find-Button
  • Find-CheckBox
  • Find-Div
  • Find-Element
  • Find-FileUpload
  • Find-Form
  • Find-Image
  • Find-Label
  • Find-Link
  • Find-Para
  • Find-RadioButton
  • Find-SelectList
  • Find-Span
  • Find-Table
  • Find-TableBody
  • Find-TableCell
  • Find-TableRow
  • Find-TextField

And each function takes the name of an attribute, like say: Alt, Class, For, Id, Index, Name, Src, Style, Text, Title, Url, Value … or just “Element” ... and a regular expression to match against the value of that attribute, and finds the control(s) that match. So for instance … since I’ve got a browser open to Google, I could trigger a search for my name by just doing:


Find-TextField Name q | % { $_.TypeText( "Joel Bennett" ) }
Find-Button Name btnG | % { $_.Click() }
 

Drat, the lawyer and that pottery guy still beat me out, maybe I should stop using “Jaykul” everywhere and start using my real name more …

[new] Edit: Another example

Someone asked in the comments about how to parse a table, and I thought I’d post an example, because it’s pretty cool how well PowerShell works for stuff like this. Lets say I wanted to scan down a column in a table, and depending on the values, return a value from another column. For an example, I’ll take a table off Wikipedia which lists multi-protocol IM clients, and try to return the names of the clients which support IRC.


## Using the function defined earlier ...
Start-Watin
## Now navigate to the page
$ie.Goto( "http://en.wikipedia.org/wiki/Multiprotocol_instant_messaging_application" )
## Find that first table (yeah, you just have to know the ID):
$table = Find-Table Id sortable_table_id_0

## we COULD do this to figure out which column is the IRC column:
## It's hard because there's no mapping for TH in WatiN
## Personally, I think they should show up in .TableCells
## -1 for the "th" element that's missing from TableRow[1..n].TableCells
$column=-1;
$table.TableRows[0].Elements | Where-Object {$_.TagName -eq "th"} |
   ForEach-Object{ if($_.Text -match "IRC"){ break } $column++ }

## Now we loop all rows, and examine that column
## If we find a "Yes", print out the table header for that row:
$table.TableRows | Where-Object { $_.TableCells[$column] -match "Yes" } |
   ForEach-Object { $_.Elements } |
   Where-Object   { $_.TagName -eq "th"} |
   ForEach-Object { $_.Text }
 

Clearly WatiN needs to fix the missin <th> TableHeader problem, but other than that, this wasn’t too painful. Of course, it would be a lot easier if we could cast ScriptBlocks as the generic Predicate<T> that the various .Find methods accept, but if I try this, it just freezes up and never returns:

$table.TableRows[0].Element( {$arg[0].TagName -eq "th"} )

Future Work

You could easily take this a lot further: dump those functions into a file for reusing next time (so you don’t have to regenerate them each time), and in fact, it would be relatively simple to make functions for each of the methods on each of the types we found above, so you would have a Click-Button function, and a TypeText-TextField function which could take those same search parameters (attribute and regular expression) and you could even generate appropriate parameters to take, for example, the text to type. In fact, you could generate a whole DSL for yourself … this guy did it using MGrammar … but why not PowerShell. ;)

]]> http://huddledmasses.org/using-powershell-and-watin-powerwatin/feed/ 8