Merge pull request #18 from LarrysGIT/master

Add a new cmdlet 'Get-SeKeys' to list supported keys, update 'Send-Se…

Author: adamdriscoll

README.md

@@ -10,6 +10,12 @@
 Install-Module Selenium
 ```
 
+OR
+
+```
+Import-Module "{FullPath}\selenium-powershell\Selenium.psm1"
+```
+
 # Usage
 
 ## Navigate to a URL
@@ -49,4 +55,12 @@ Send-SeKeys -Element $Element -Keys "[email protected]"
 
 ```powershell
 $Driver = Start-SeChrome -Arguments "headless","incognito" 
+```
+
+## Wait for an element
+```powershell
+$Driver = Start-SeChrome
+Enter-SeUrl https://www.google.com -Driver $Driver
+Wait-SeElementExists -Driver $Driver -Timeout 3 -Id "q"
+Wait-SeElementExists -Driver $Driver -Timeout 3 -Name "q"
 ```

Selenium.psd1

@@ -3,12 +3,17 @@
 function Start-SeChrome {
     Param(
         [Parameter(Mandatory = $false)]
-        [array]$Arguments
+        [array]$Arguments,
+        [switch]$HideVersionHint
     )
     if($Arguments) {
         $Chrome_Options = New-Object -TypeName "OpenQA.Selenium.Chrome.ChromeOptions"
         $Chrome_Options.AddArguments($Arguments)
     }
+    if(!$HideVersionHint)
+    {
+        Write-Host "Download the right chromedriver from 'http://chromedriver.chromium.org/downloads'" -ForegroundColor Yellow
+    }
     New-Object -TypeName "OpenQA.Selenium.Chrome.ChromeDriver" -ArgumentList $Chrome_Options
 }
 
@@ -121,9 +126,18 @@ function Invoke-SeClick {
 
 }
 
+function Get-SeKeys {
+    
+    [OpenQA.Selenium.Keys] | Get-Member -MemberType Property -Static | Select-Object -Property Name,@{N = "ObjectString"; E = {"[OpenQA.Selenium.Keys]::$($_.Name)"}}
+}
+
 function Send-SeKeys {
     param([OpenQA.Selenium.IWebElement]$Element, [string]$Keys)
-
+    
+    foreach($Key in @(Get-SeKeys).Name)
+    {
+        $Keys = $Keys -replace "{{$Key}}", [OpenQA.Selenium.Keys]::$Key
+    }
     $Element.SendKeys($Keys)
 }
 
@@ -184,3 +198,29 @@ function Save-SeScreenshot {
             $Screenshot.SaveAsFile($Path, $ImageFormat)
         }
 }
+
+function Wait-SeElementExists {
+    param(
+        $Driver,
+        $Timeout = 30,
+        $Id,
+        $Name
+    )
+    if($Id)
+    {
+        $TargetElement = [OpenQA.Selenium.By]::Id($Id)
+    }
+    elseif($Name)
+    {
+        $TargetElement = [OpenQA.Selenium.By]::Name($Name)
+    }
+    else
+    {
+        throw "Please specify -Id or -Name"
+    }
+    $WebDriverWait = New-Object OpenQA.Selenium.Support.UI.WebDriverWait $Driver, ($Timeout * 10000000) # ticks
+    $Condition = [OpenQA.Selenium.Support.UI.ExpectedConditions]::ElementExists($TargetElement)
+    $WebDriverWait.Until($Condition)
+}
+
+