Enchanced Start-SeFirefox with many new features

Added many features to Start-SeFirefox and appropriate tests
-StartURL
-DefaultDownloadPath
-Maximized
-Minimize
-Fullscreen
-Headless
-PrivateBrowsing

Removed profile support since its broken.
Will re-evaluate at a later date.

Author: the-mentor

Selenium.psm1

@@ -111,14 +111,12 @@ function Start-SeChrome {
 
         if($Minimized){
             $driver.Manage().Window.Minimize();
-
         }
 
         if($Headless -and $DefaultDownloadPath) {
             $HeadlessDownloadParams = New-Object 'system.collections.generic.dictionary[[System.String],[System.Object]]]'
             $HeadlessDownloadParams.Add('behavior', 'allow')
             $HeadlessDownloadParams.Add('downloadPath', $DefaultDownloadPath.FullName)
-
             $Driver.ExecuteChromeCommand('Page.setDownloadBehavior', $HeadlessDownloadParams)
         }
 
@@ -142,32 +140,88 @@ function Start-SeEdge {
 }
 
 function Start-SeFirefox {
-    param([Switch]$Profile)
+    param(
+        [array]$Arguments,
+        [string]$StartURL,
+        [System.IO.FileInfo]$DefaultDownloadPath,
+        [switch]$Headless,
+        [switch]$PrivateBrowsing,
+        [switch]$Maximized,
+        [switch]$Minimized,
+        [switch]$Fullscreen
+    )
 
-    if ($Profile) {
-        #Doesn't work....
-        $ProfilePath = Join-Path $PSScriptRoot "Assets\ff-profile\rust_mozprofile.YwpEBLY3hCRX"
-        $firefoxProfile = New-Object OpenQA.Selenium.Firefox.FirefoxProfile -ArgumentList ($ProfilePath)
-        $firefoxProfile.WriteToDisk()
-        if($IsLinux -or $IsMacOS){
-            New-Object -TypeName "OpenQA.Selenium.Firefox.FirefoxDriver" -ArgumentList $AssembliesPath,$firefoxProfile
+    BEGIN{
+        if($Maximized -ne $false -and $Minimized -ne $false) {
+            throw 'Maximized and Minimized may not be specified together.'
         }
-        else{
-            New-Object -TypeName "OpenQA.Selenium.Firefox.FirefoxDriver" -ArgumentList $firefoxProfile
+        elseif($Maximized -ne $false -and $Fullscreen -ne $false){
+            throw 'Maximized and Fullscreen may not be specified together.'
+        }
+        elseif($Minimized -ne $false -and $Fullscreen -ne $false){
+            throw 'Minimized and Fullscreen may not be specified together.'
+        }
+
+        if($StartURL){
+            if(![system.uri]::IsWellFormedUriString($StartURL,[System.UriKind]::Absolute)){
+                throw 'Incorrect StartURL please make sure the URL starts with http:// or https://'
+            }
         }
     }
-    else {
+    PROCESS{
+        $Firefox_Options = New-Object -TypeName "OpenQA.Selenium.Firefox.FirefoxOptions"
+
+        if($Headless) {
+            $Firefox_Options.AddArguments('-headless')
+        }
+
+        if($DefaultDownloadPath){
+            Write-Verbose "Setting Default Download directory: $DefaultDownloadPath"
+            $Firefox_Options.setPreference("browser.download.folderList",2);
+            $Firefox_Options.SetPreference("browser.download.dir", "$DefaultDownloadPath");
+        }
+        
+        if($PrivateBrowsing){
+            $Firefox_Options.SetPreference("browser.privatebrowsing.autostart", $true)
+        }
+
+        if ($Arguments) {
+            foreach ($Argument in $Arguments){
+                $Firefox_Options.AddArguments($Argument)
+            }
+        }
+
         if($IsLinux -or $IsMacOS){
-            $Driver = New-Object -TypeName "OpenQA.Selenium.Firefox.FirefoxDriver" -ArgumentList $AssembliesPath
+            $Driver = New-Object -TypeName "OpenQA.Selenium.Firefox.FirefoxDriver" -ArgumentList $AssembliesPath,$Firefox_Options
         }
         else{
-            $Driver = New-Object -TypeName "OpenQA.Selenium.Firefox.FirefoxDriver"
+            $Driver = New-Object -TypeName "OpenQA.Selenium.Firefox.FirefoxDriver" -ArgumentList $Firefox_Options
+        }
+
+        $Driver.Manage().Timeouts().ImplicitWait = [TimeSpan]::FromSeconds(10)
+        
+        if($Minimized){
+            $Driver.Manage().Window.Minimize()
+        }
+
+        if($Maximized){
+            $Driver.Manage().Window.Maximize()
+        }
+
+        if($Fullscreen){
+            $Driver.Manage().Window.FullScreen()
+        }
+
+        if($StartURL){
+            Enter-SeUrl -Driver $Driver -Url $StartURL
         }
     }
-    $Driver.Manage().Timeouts().ImplicitWait = [TimeSpan]::FromSeconds(10)
-    $Driver
+    END{
+        return $Driver
+    }
 }
 
+
 function Stop-SeDriver {
     param($Driver) 
 

Selenium.tests.ps1

@@ -72,11 +72,21 @@ Describe "Start-SeChrome" {
 
 Describe "Start-SeChrome with Options" {
     Context "Should Start Chrome Driver with different startup options" {
+        It "Start Chrome with StartURL" {
+            $Driver = Start-SeChrome -StartURL 'https://github.com/adamdriscoll/selenium-powershell'
+            Stop-SeDriver $Driver
+        }
+
         It "Start Chrome in Headless mode" {
             $Driver = Start-SeChrome -Headless
             Stop-SeDriver $Driver
         }
 
+        It "Start Chrome Minimize" {
+            $Driver = Start-SeChrome -Minimize
+            Stop-SeDriver $Driver
+        }
+
         It "Start Chrome Maximized" {
             $Driver = Start-SeChrome -Maximized
             Stop-SeDriver $Driver
@@ -99,6 +109,7 @@ Describe "Start-SeChrome with Options" {
 
         It "Start Chrome with Multiple arguments" {
             $Driver = Start-SeChrome -Arguments @('Incognito','start-maximized')
+            Stop-SeDriver $Driver
         }
     }
 }
@@ -110,6 +121,50 @@ Describe "Start-SeFirefox"{
     }
 }
 
+Describe "Start-SeFirefox with Options" {
+    Context "Should Start Firefox Driver with different startup options" {
+        It "Start Firefox with StartURL" {
+            $Driver = Start-SeFirefox -StartURL 'https://github.com/adamdriscoll/selenium-powershell'
+            Stop-SeDriver $Driver
+        }
+
+        It "Start Firefox in Headless mode" {
+            $Driver = Start-SeFirefox -Headless
+            Stop-SeDriver $Driver
+        }
+
+        It "Start Firefox Minimize" {
+            $Driver = Start-SeFirefox -Minimize
+            Stop-SeDriver $Driver
+        }
+
+        It "Start Firefox Maximized" {
+            $Driver = Start-SeFirefox -Maximized
+            Stop-SeDriver $Driver
+        }
+
+        It "Start Firefox PrivateBrowsing (Incognito)" {
+            $Driver = Start-SeFirefox -PrivateBrowsing
+            Stop-SeDriver $Driver
+        }
+        
+        It "Start Firefox Fullscreen" {
+            $Driver = Start-SeFirefox -Fullscreen
+            Stop-SeDriver $Driver
+        }
+
+        It "Start Firefox Maximized and PrivateBrowsing (Incognito)" {
+            $Driver = Start-SeFirefox -Maximized -PrivateBrowsing
+            Stop-SeDriver $Driver
+        }
+
+        It "Start Firefox with Multiple arguments" {
+            $Driver = Start-SeFirefox -Arguments @('-headless','-private')
+            Stop-SeDriver $Driver
+        }
+    }
+}
+
 Describe "Start-SeEdge" {
     Context "Should Start Edge Driver" {
         if(!$IsLinux -and !$IsMacOS){