Functions/GenXdev.Webbrowser.Playwright/Close-PlaywrightDriver.ps1
|
################################################################################ using namespace System.Management.Automation using namespace System.Collections.Concurrent using namespace Microsoft.Playwright <# .SYNOPSIS Closes a Playwright browser instance and removes it from the global cache. .DESCRIPTION This function safely closes a previously opened Playwright browser instance and removes its reference from the global browser dictionary. The function handles cleanup of browser resources and provides error handling for graceful shutdown. .PARAMETER BrowserType Specifies the type of browser instance to close (Chromium, Firefox, or Webkit). If not specified, defaults to Chromium. .PARAMETER ReferenceKey The unique identifier used to retrieve the browser instance from the global cache. If not specified, defaults to "Default". .EXAMPLE Close-PlaywrightDriver -BrowserType Chromium -ReferenceKey "MainBrowser" Closes a specific Chromium browser instance identified by "MainBrowser" .EXAMPLE Close-PlaywrightDriver Chrome Closes the default Chromium browser instance using position parameters #> function Close-PlaywrightDriver { [CmdletBinding()] [System.Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSAvoidGlobalVars", "")] param ( ######################################################################## [Parameter( Position = 0, Mandatory = $false, HelpMessage = "The type of browser to close" )] [ValidateSet("Chromium", "Firefox", "Webkit")] [string]$BrowserType = "Chromium", ######################################################################## [Parameter( Position = 1, Mandatory = $false, HelpMessage = "The unique key identifying the browser instance" )] [ValidateNotNullOrEmpty()] [string]$ReferenceKey = "Default" ######################################################################## ) begin { # ensure the browser cache dictionary is initialized Microsoft.PowerShell.Utility\Write-Verbose "Initializing browser cache dictionary" GenXdev.Webbrowser\Update-PlaywrightDriverCache } process { # normalize the reference key to handle null/empty cases Microsoft.PowerShell.Utility\Write-Verbose "Processing browser closure for key: $ReferenceKey" $referenceKey = [string]::IsNullOrWhiteSpace($ReferenceKey) ? "Default" : $ReferenceKey # attempt to retrieve the browser instance from cache Microsoft.PowerShell.Utility\Write-Verbose "Attempting to retrieve browser instance from cache" $browser = $null if ($Global:GenXdevPlaywrightBrowserDictionary.TryGetValue( $referenceKey, [ref]$browser)) { try { # close the browser instance asynchronously Microsoft.PowerShell.Utility\Write-Verbose "Closing browser instance..." $null = $browser.CloseAsync().Wait() } catch { Microsoft.PowerShell.Utility\Write-Warning "Failed to close browser: $_" } finally { # remove the browser reference from the global dictionary Microsoft.PowerShell.Utility\Write-Verbose "Removing browser reference from cache" $null = $Global:GenXdevPlaywrightBrowserDictionary.TryRemove( $referenceKey, [ref]$browser) } } else { Microsoft.PowerShell.Utility\Write-Verbose "No browser instance found for key: $ReferenceKey" } } end { } } ################################################################################ |