GenXdev.Webbrowser
A Windows PowerShell module that allows you to run scripts against your casual desktop webbrowser-tab
* âś… full controll of the webbrowser with the 'wbctrl' cmdlet
* âś… retreiving and manipulating of webbrowser-tab DOM nodes with 'wl' cmdlet
* âś… evaluating javascript-strings, javascript-files in opened webbrowser-tab
* âś… adding html script tags, by url, to opened webbrowser-tabs, for normal javascript files or modules
* âś… evaluating scripts, with support for async patterns, like promises
* âś… evaluating asynchronous scripts, with support for yielded PowerShell pipeline returns
* âś… exporting of favourites/bookmarks from Microsoft Edge, Google Chrome or Firefox
* âś… launching of default browser, Microsoft Edge, Google Chrome or Firefox
* âś… launching of webbrowser with full control of window positioning
* âś… launching of webbrowser with a large set of options
In your PowerShell profile script,
you can set a global variable named DefaultSecondaryMonitor.
This allows you to setup your prefered webbrowser launch monitor.
e.g.
# Disable default placement of browser window
Set-Variable -Name DefaultSecondaryMonitor -Value -1 -Scope Global
# Place browser windows by default on 3th monitor (0 = Primary monitor, 1 = first, 2 = second, etc)
Set-Variable -Name DefaultSecondaryMonitor -Value 3 -Scope Global
-------------------------- EXAMPLE 1 --------------------------
PS C:\> Invoke-WebbrowserEvaluation "document.title = 'hello world'"
-------------------------- EXAMPLE 2 --------------------------
PS C:\>
# Synchronizing data
Select-WebbrowserTab;
$Global:Data = @{ files= (Get-ChildItem *.* -file | % FullName)};
[int] $number = Invoke-WebbrowserEvaluation "
document.body.innerHTML = JSON.stringify(data.files);
data.title = document.title;
return 123;
";
Write-Host "
Document title : $($Global:Data.title)
return value : $Number
";
-------------------------- EXAMPLE 3 --------------------------
PS C:\>
# Support for promises
Select-WebbrowserTab;
Invoke-WebbrowserEvaluation "
let myList = [];
return new Promise((resolve) => {
let i = 0;
let a = setInterval(() => {
myList.push(++i);
if (i == 10) {
clearInterval(a);
resolve(myList);
}
}, 1000);
});
"
-------------------------- EXAMPLE 4 --------------------------
PS C:\>
# Support for promises and more
# this function returns all rows of all tables/datastores of all databases of indexedDb in the selected tab
# beware, not all websites use indexedDb, it could return an empty set
Select-WebbrowserTab;
Set-WebbrowserTabLocation "https://www.youtube.com/"
Start-Sleep 3
$AllIndexedDbData = Invoke-WebbrowserEvaluation "
// enumerate all indexedDB databases
for (let db of await indexedDB.databases()) {
// request to open database
let openRequest = await indexedDB.open(db.name);
// wait for eventhandlers to be called
await new Promise((resolve,reject) => {
openRequest.onsuccess = resolve;
openRequest.onerror = reject
});
// obtain reference
let openedDb = openRequest.result;
// initialize result
let result = { DatabaseName: db.name, Version: db.version, Stores: [] }
// itterate object store names
for (let i = 0; i < openedDb.objectStoreNames.length; i++) {
// reference
let storeName = openedDb.objectStoreNames[i];
// start readonly transaction
let tr = openedDb.transaction(storeName);
// get objectstore handle
let store = tr.objectStore(storeName);
// request all data
let getRequest = store.getAll();
// await result
await new Promise((resolve,reject) => {
getRequest.onsuccess = resolve;
getRequest.onerror = reject;
});
// add result
result.Stores.push({ StoreName: storeName, Data: getRequest.result});
}
// stream this database contents to the PowerShell pipeline, and continue
yield result;
}
";
$AllIndexedDbData | Out-Host
-------------------------- EXAMPLE 5 --------------------------
PS C:\>
# Support for yielded pipeline results
Select-WebbrowserTab;
Invoke-WebbrowserEvaluation "
for (let i = 0; i < 10; i++) {
await (new Promise((resolve) => setTimeout(resolve, 1000)));
yield i;
}
";
-------------------------- EXAMPLE 6 --------------------------
PS C:\> Get-ChildItem *.js | Invoke-WebbrowserEvaluation -Edge
-------------------------- EXAMPLE 7 --------------------------
PS C:\> ls *.js | et -e
Install-Module "GenXdev.Webbrowser"
Import-Module "GenXdev.Webbrowser"Update-Module| Command                 | aliases         | Description |
|---|---|---|
| Approve-FirefoxDebugging | Enables remote debugging and standalone app mode (SSB) capabilities in Firefox bymodifying user preferences in the prefs.js file of all Firefox profiledirectories. This function updates or adds required debugging preferences toenable development tools and remote debugging while disabling connection prompts. | |
| Clear-WebbrowserTabSiteApplicationData | clearsitedata | The Clear-WebbrowserTabSiteApplicationData cmdlet executes a JavaScript snippetthat clears various types of browser storage for the current tab, including:- Local storage- Session storage- Cookies- IndexedDB databases- Cache storage- Service worker registrations |
| Close-Webbrowser | wbc | Provides granular control over closing web browser instances. Can target specificbrowsers (Edge, Chrome, Firefox) or close all browsers. Supports closing both mainwindows and background processes. |
| Close-WebbrowserTab | CloseTab, ct | Closes the currently selected webbrowser tab using ChromeDriver's CloseAsync()method. If no tab is currently selected, the function will automatically attemptto select the last used tab before closing it. |
| Export-BrowserBookmarks | The Export-BrowserBookmarks cmdlet exports bookmarks from a specified web browser(Microsoft Edge, Google Chrome, or Mozilla Firefox) to a JSON file. Only onebrowser type can be specified at a time. The bookmarks are exported with fullpreservation of their structure and metadata. | |
| Find-BrowserBookmarks | bookmarks | Searches through bookmarks from Microsoft Edge, Google Chrome, or Mozilla Firefox.Returns bookmarks that match one or more search queries in their name, URL, orfolder path. If no queries are provided, returns all bookmarks from the selectedbrowsers. |
| Get-BrowserBookmarks | gbm | Retrieves bookmarks from Microsoft Edge, Google Chrome, or Mozilla Firefoxbrowsers installed on the system. The function can filter by browser type andreturns detailed bookmark information including name, URL, folder location, andtimestamps. |
| Get-ChromeRemoteDebuggingPort | Get-ChromePort | Retrieves and manages the remote debugging port configuration for Google Chrome.The function first checks for a custom port number stored in $Global:ChromeDebugPort.If not found or invalid, it defaults to port 9222. The port number is then storedglobally for use by other Chrome automation functions. |
| Get-ChromiumRemoteDebuggingPort | Get-BrowserDebugPort | Detects whether Microsoft Edge or Google Chrome is the default browser andreturns the appropriate debugging port number. If Chrome is the default browser,returns the Chrome debugging port. Otherwise returns the Edge debugging port(also used when no default browser is detected). |
| Get-ChromiumSessionReference | Returns a hashtable containing debugger URI, port, and session data for thecurrent browser tab. This reference can be used with Select-WebbrowserTab-ByReference to reconnect to the same tab, especially useful in background jobsor across different PowerShell sessions.The function validates the existence of an active chrome session and ensuresthe browser controller is still running before returning the session reference. | |
| Get-DefaultWebbrowser | Retrieves information about the system's default web browser by querying theWindows Registry. Returns a hashtable containing the browser's name, description,icon path, and executable path. The function checks both user preferences andsystem-wide browser registrations to determine the default browser. | |
| Get-EdgeRemoteDebuggingPort | Retrieves the remote debugging port number used for connecting to Microsoft Edgebrowser's debugging interface. If no custom port is configured via the globalvariable $Global:EdgeDebugPort, returns the default port 9223. The functionvalidates any custom port configuration and falls back to the default if invalid. | |
| Get-Webbrowser | Discovers and returns details about modern web browsers installed on the system.Retrieves information including name, description, icon path, executable path anddefault browser status by querying the Windows registry. Only returns browsersthat have the required capabilities registered in Windows. | |
| Get-WebbrowserTabDomNodes | wl | Uses browser automation to find elements matching a CSS selector and returns theirHTML content or executes custom JavaScript on each matched element. This functionis useful for web scraping and browser automation tasks. |
| Import-BrowserBookmarks | Imports bookmarks into Microsoft Edge or Google Chrome from either a CSV file ora collection of bookmark objects. The bookmarks are added to the browser'sbookmark bar or specified folders. Firefox import is not currently supported. | |
| Invoke-WebbrowserEvaluation | et, Eval | Executes JavaScript code in a selected browser tab with support for async/await,promises, and data synchronization between PowerShell and the browser context.Can execute code from strings, files, or URLs. |
| Open-BrowserBookmarks | sites | Searches bookmarks across Microsoft Edge, Google Chrome, and Mozilla Firefoxbrowsers based on provided search queries. Opens matching bookmarks in theselected browser with configurable window settings and browser modes. |
| Open-Webbrowser | wb | Opens one or more webbrowsers in a configurable manner, using commandlineswitches to control window position, size, and browser-specific features. |
| Select-WebbrowserTab | Select-BrowserTab, st | Manages browser tab selection for automation tasks. Can select tabs by ID, name,or reference. Shows available tabs when no selection criteria are provided.Supports both Chrome and Edge browsers. Handles browser connection and sessionmanagement. |
| Set-BrowserVideoFullscreen | fsvideo | Executes JavaScript code to locate and maximize the first video element on thecurrent webpage. The video is set to cover the entire viewport with maximumz-index to ensure visibility. Page scrollbars are hidden for a clean fullscreenexperience. |
| Set-RemoteDebuggerPortInBrowserShortcuts | Set-BrowserDebugPorts | Modifies Chrome and Edge browser shortcuts to include remote debugging portparameters. This enables automation scripts to interact with the browsers throughtheir debugging interfaces. Handles both user-specific and system-wide shortcuts.The function:- Removes any existing debugging port parameters- Adds current debugging ports for Chrome and Edge- Updates shortcuts in common locations (Desktop, Start Menu, Quick Launch)- Requires administrative rights for system-wide shortcuts |
| Set-WebbrowserTabLocation | lt, Nav | Sets the location (URL) of the currently selected webbrowser tab. Supports bothEdge and Chrome browsers through optional switches. The navigation includesvalidation of the URL and ensures proper page loading through async operations. |
| Show-WebsiteInAllBrowsers | Show-UrlInAllBrowsers | This function creates a mosaic layout of browser windows by opening the specifiedURL in Chrome, Edge, Firefox, and a private browsing window. The browsers arearranged in a 2x2 grid pattern:- Chrome: Top-left quadrant- Edge: Bottom-left quadrant- Firefox: Top-right quadrant- Private window: Bottom-right quadrant |
| Write-Bookmarks |
Â
| Command                  | aliases          | Description |
|---|---|---|
| _AssureTypes | This internal function ensures the required Microsoft Playwright assemblies areloaded and initializes the global concurrent dictionary used to store browserinstances. The function is called automatically when the module loads and sets upthe foundation for browser automation tasks. | |
| Close-PlaywrightDriver | This function safely closes a previously opened Playwright browser instance andremoves its reference from the global browser dictionary. The function handlescleanup of browser resources and provides error handling for graceful shutdown. | |
| Connect-PlaywrightViaDebuggingPort | Establishes a connection to a running Chromium-based browser instance using theWebSocket debugger URL. Creates a Playwright instance and connects over CDP(Chrome DevTools Protocol). The connected browser instance is stored in a globaldictionary for later reference. | |
| Get-PlaywrightDriver | Manages Playwright browser instances with support for Chrome, Firefox and Webkit.Handles browser window positioning, state persistence, and reconnection toexisting instances. Provides a unified interface for browser automation tasks. | |
| Get-PlaywrightProfileDirectory | Creates and manages browser profile directories for Playwright automated testing.Profiles are stored in LocalAppData under GenXdev.Powershell/Playwright.profiles.These profiles enable persistent sessions across browser automation runs. | |
| Resume-WebbrowserTabVideo | wbvideoplay | Finds the active YouTube browser tab and resumes video playback by executing theplay() method on any video elements found in the page. If no YouTube tab isfound, the function throws an error. This function is particularly useful forautomating video playback control in browser sessions. |
| Stop-WebbrowserVideos | ssst, wbsst, wbvideostop | Iterates through all active browser sessions and pauses any playing videos byexecuting JavaScript commands. The function maintains the original session stateand handles errors gracefully. |
| Unprotect-WebbrowserTab | wbctrl | This function enables interactive control of a browser tab that was previouslyselected using Select-WebbrowserTab. It provides direct access to the MicrosoftPlaywright Page object's properties and methods, allowing for automated browserinteraction. |
| Update-PlaywrightDriverCache | This function performs maintenance on the global Playwright browser instancedictionary by removing any browser instances that are either null or have becomedisconnected. This helps prevent memory leaks and ensures the cache remainshealthy. |
Â
Approve-FirefoxDebugging Configures Firefox's debugging and standalone app mode features.
Approve-FirefoxDebugging [<CommonParameters>] Enables remote debugging and standalone app mode (SSB) capabilities in Firefox by
modifying user preferences in the prefs.js file of all Firefox profile
directories. This function updates or adds required debugging preferences to
enable development tools and remote debugging while disabling connection prompts.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Clear-WebbrowserTabSiteApplicationData --> clearsitedata Clears all browser storage data for the current tab in Edge or Chrome.
Clear-WebbrowserTabSiteApplicationData [-Edge] [-Chrome] [<CommonParameters>] The Clear-WebbrowserTabSiteApplicationData cmdlet executes a JavaScript snippet
that clears various types of browser storage for the current tab, including:
- Local storage
- Session storage
- Cookies
- IndexedDB databases
- Cache storage
- Service worker registrations
-Edge [<SwitchParameter>]
Specifies to clear data in Microsoft Edge browser.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Chrome [<SwitchParameter>]
Specifies to clear data in Google Chrome browser.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Close-Webbrowser --> wbc Closes one or more webbrowser instances selectively.
Close-Webbrowser [[-Edge]] [[-Chrome]] [[-Chromium]] [[-Firefox]] [[-IncludeBackgroundProcesses]] [<CommonParameters>]
Close-Webbrowser [[-All]] [[-IncludeBackgroundProcesses]] [<CommonParameters>] Provides granular control over closing web browser instances. Can target specific
browsers (Edge, Chrome, Firefox) or close all browsers. Supports closing both main
windows and background processes.
-Edge [<SwitchParameter>]
Closes all Microsoft Edge browser instances.
Required? false
Position? 1
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Chrome [<SwitchParameter>]
Closes all Google Chrome browser instances.
Required? false
Position? 2
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Chromium [<SwitchParameter>]
Closes the default Chromium-based browser (Edge or Chrome).
Required? false
Position? 3
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Firefox [<SwitchParameter>]
Closes all Firefox browser instances.
Required? false
Position? 4
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-All [<SwitchParameter>]
Closes all detected modern browser instances.
Required? false
Position? 1
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-IncludeBackgroundProcesses [<SwitchParameter>]
Also closes background processes and tasks for the selected browsers.
Required? false
Position? 5
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Close-WebbrowserTab --> CloseTab, ct Closes the currently selected webbrowser tab.
Close-WebbrowserTab [-Edge] [<CommonParameters>]
Close-WebbrowserTab [-Chrome] [<CommonParameters>] Closes the currently selected webbrowser tab using ChromeDriver's CloseAsync()
method. If no tab is currently selected, the function will automatically attempt
to select the last used tab before closing it.
-Edge [<SwitchParameter>]
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Chrome [<SwitchParameter>]
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Export-BrowserBookmarks Exports browser bookmarks to a JSON file.
Export-BrowserBookmarks [-OutputFile] <String> [-Edge] [<CommonParameters>]
Export-BrowserBookmarks [-OutputFile] <String> [-Chrome] [<CommonParameters>]
Export-BrowserBookmarks [-OutputFile] <String> [-Firefox] [<CommonParameters>] The Export-BrowserBookmarks cmdlet exports bookmarks from a specified web browser
(Microsoft Edge, Google Chrome, or Mozilla Firefox) to a JSON file. Only one
browser type can be specified at a time. The bookmarks are exported with full
preservation of their structure and metadata.
-OutputFile <String>
The path to the JSON file where the bookmarks will be saved. The path will be
expanded to a full path before use.
Required? true
Position? 1
Default value
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Chrome [<SwitchParameter>]
Switch parameter to export bookmarks from Google Chrome browser.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Edge [<SwitchParameter>]
Switch parameter to export bookmarks from Microsoft Edge browser.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Firefox [<SwitchParameter>]
Switch parameter to export bookmarks from Mozilla Firefox browser.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Find-BrowserBookmarks --> bookmarks Finds bookmarks from one or more web browsers.
Find-BrowserBookmarks [[-Queries] <String[]>] [-Edge] [-Chrome] [-Firefox] [-Count <Int32>] [-PassThru] [<CommonParameters>] Searches through bookmarks from Microsoft Edge, Google Chrome, or Mozilla Firefox.
Returns bookmarks that match one or more search queries in their name, URL, or
folder path. If no queries are provided, returns all bookmarks from the selected
browsers.
-Queries <String[]>
One or more search terms to find matching bookmarks. Matches are found in the
bookmark name, URL, or folder path using wildcard pattern matching.
Required? false
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Aliases
Accept wildcard characters? false
-Edge [<SwitchParameter>]
Switch to include Microsoft Edge bookmarks in the search.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Chrome [<SwitchParameter>]
Switch to include Google Chrome bookmarks in the search.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Firefox [<SwitchParameter>]
Switch to include Mozilla Firefox bookmarks in the search.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Count <Int32>
Maximum number of results to return. Must be a positive integer.
Default is 99999999.
Required? false
Position? named
Default value 99999999
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-PassThru [<SwitchParameter>]
Switch to return complete bookmark objects instead of just URLs. Each bookmark
object contains Name, URL, and Folder properties.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Get-BrowserBookmarks --> gbm Returns all bookmarks from installed web browsers.
Get-BrowserBookmarks [<CommonParameters>]
Get-BrowserBookmarks [[-Chrome]] [<CommonParameters>]
Get-BrowserBookmarks [[-Edge]] [<CommonParameters>]
Get-BrowserBookmarks [[-Firefox]] [<CommonParameters>] Retrieves bookmarks from Microsoft Edge, Google Chrome, or Mozilla Firefox
browsers installed on the system. The function can filter by browser type and
returns detailed bookmark information including name, URL, folder location, and
timestamps.
-Chrome [<SwitchParameter>]
Retrieves bookmarks specifically from Google Chrome browser.
Required? false
Position? 1
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Edge [<SwitchParameter>]
Retrieves bookmarks specifically from Microsoft Edge browser.
Required? false
Position? 1
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Firefox [<SwitchParameter>]
Retrieves bookmarks specifically from Mozilla Firefox browser.
Required? false
Position? 1
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Get-ChromeRemoteDebuggingPort --> Get-ChromePort Returns the configured remote debugging port for Google Chrome.
Get-ChromeRemoteDebuggingPort [<CommonParameters>] Retrieves and manages the remote debugging port configuration for Google Chrome.
The function first checks for a custom port number stored in $Global:ChromeDebugPort.
If not found or invalid, it defaults to port 9222. The port number is then stored
globally for use by other Chrome automation functions.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Get-ChromiumRemoteDebuggingPort --> Get-BrowserDebugPort Returns the remote debugging port for the system's default Chromium browser.
Get-ChromiumRemoteDebuggingPort [<CommonParameters>] Detects whether Microsoft Edge or Google Chrome is the default browser and
returns the appropriate debugging port number. If Chrome is the default browser,
returns the Chrome debugging port. Otherwise returns the Edge debugging port
(also used when no default browser is detected).
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Get-ChromiumSessionReference Gets a serializable reference to the current browser tab session.
Get-ChromiumSessionReference [<CommonParameters>] Returns a hashtable containing debugger URI, port, and session data for the
current browser tab. This reference can be used with Select-WebbrowserTab
-ByReference to reconnect to the same tab, especially useful in background jobs
or across different PowerShell sessions.
The function validates the existence of an active chrome session and ensures
the browser controller is still running before returning the session reference.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Get-DefaultWebbrowser Returns the configured default web browser for the current user.
Get-DefaultWebbrowser [<CommonParameters>] Retrieves information about the system's default web browser by querying the
Windows Registry. Returns a hashtable containing the browser's name, description,
icon path, and executable path. The function checks both user preferences and
system-wide browser registrations to determine the default browser.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Requires Windows 10 or later operating system
-------------------------- EXAMPLE 1 --------------------------
PS C:\> # Get detailed information about the default browser
Get-DefaultWebbrowser | Format-List
-------------------------- EXAMPLE 2 --------------------------
PS C:\> # Launch the default browser with a specific URL
$browser = Get-DefaultWebbrowser
& $browser.Path https://www.github.com/ Get-EdgeRemoteDebuggingPort Returns the configured remote debugging port for Microsoft Edge browser.
Get-EdgeRemoteDebuggingPort [<CommonParameters>] Retrieves the remote debugging port number used for connecting to Microsoft Edge
browser's debugging interface. If no custom port is configured via the global
variable $Global:EdgeDebugPort, returns the default port 9223. The function
validates any custom port configuration and falls back to the default if invalid.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
The function ensures $Global:EdgeDebugPort is always set to the returned value
for consistency across the session.
-------------------------- EXAMPLE 1 --------------------------
PS C:\> Get-EdgeRemoteDebuggingPort
Returns the configured debug port (default 9223 if not configured) Get-Webbrowser Returns a collection of installed modern web browsers.
Get-Webbrowser [<CommonParameters>] Discovers and returns details about modern web browsers installed on the system.
Retrieves information including name, description, icon path, executable path and
default browser status by querying the Windows registry. Only returns browsers
that have the required capabilities registered in Windows.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Requires Windows 10 or later Operating System
-------------------------- EXAMPLE 1 --------------------------
PS C:\> Get-Webbrowser | Select-Object Name, Description | Format-Table
-------------------------- EXAMPLE 2 --------------------------
PS C:\> # Get just the default browser
Get-Webbrowser | Where-Object { $_.IsDefaultBrowser } Get-WebbrowserTabDomNodes --> wl Queries and manipulates DOM nodes in the active browser tab using CSS selectors.
Get-WebbrowserTabDomNodes [-QuerySelector] <String> [[-ModifyScript] <String>] [<CommonParameters>] Uses browser automation to find elements matching a CSS selector and returns their
HTML content or executes custom JavaScript on each matched element. This function
is useful for web scraping and browser automation tasks.
-QuerySelector <String>
CSS selector string to find matching DOM elements. Uses standard CSS selector
syntax like '#id', '.class', 'tag', etc.
Required? true
Position? 1
Default value
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-ModifyScript <String>
JavaScript code to execute on each matched element. The code runs as an async
function with parameters:
- e: The matched DOM element
- i: Index of the element (0-based)
- n: Complete NodeList of matching elements
- modifyScript: The script being executed
Required? false
Position? 2
Default value
Accept pipeline input? false
Aliases
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Import-BrowserBookmarks Imports bookmarks from a file or collection into a web browser.
Import-BrowserBookmarks [-Chrome] [-Edge] [-Firefox] [<CommonParameters>]
Import-BrowserBookmarks [[-InputFile] <String>] [-Chrome] [-Edge] [-Firefox] [<CommonParameters>]
Import-BrowserBookmarks [[-Bookmarks] <Array>] [-Chrome] [-Edge] [-Firefox] [<CommonParameters>] Imports bookmarks into Microsoft Edge or Google Chrome from either a CSV file or
a collection of bookmark objects. The bookmarks are added to the browser's
bookmark bar or specified folders. Firefox import is not currently supported.
-InputFile <String>
The path to a CSV file containing bookmarks to import. The CSV should have
columns for Name, URL, Folder, DateAdded, and DateModified.
Required? false
Position? 1
Default value
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Bookmarks <Array>
An array of bookmark objects to import. Each object should have properties for
Name, URL, Folder, DateAdded, and DateModified.
Required? false
Position? 1
Default value
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Chrome [<SwitchParameter>]
Switch to import bookmarks into Google Chrome.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Edge [<SwitchParameter>]
Switch to import bookmarks into Microsoft Edge.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Firefox [<SwitchParameter>]
Switch to indicate Firefox as target (currently not supported).
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Invoke-WebbrowserEvaluation --> et, Eval Executes JavaScript code in a selected web browser tab.
Invoke-WebbrowserEvaluation [[-Scripts] <Object[]>] [-Inspect] [-NoAutoSelectTab] [-Edge] [-Chrome] [<CommonParameters>]
Invoke-WebbrowserEvaluation [[-Scripts] <Object[]>] [-Inspect] -Page <Object> -ByReference <PSObject> [<CommonParameters>] Executes JavaScript code in a selected browser tab with support for async/await,
promises, and data synchronization between PowerShell and the browser context.
Can execute code from strings, files, or URLs.
-Scripts <Object[]>
JavaScript code to execute. Can be string content, file paths, or URLs.
Accepts pipeline input.
Required? false
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Aliases
Accept wildcard characters? false
-Inspect [<SwitchParameter>]
Adds debugger statement before executing to enable debugging.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-NoAutoSelectTab [<SwitchParameter>]
Prevents automatic tab selection if no tab is currently selected.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Edge [<SwitchParameter>]
Selects Microsoft Edge browser for execution.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Chrome [<SwitchParameter>]
Selects Google Chrome browser for execution.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Page <Object>
Browser page object for execution when using ByReference mode.
Required? true
Position? named
Default value
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-ByReference <PSObject>
Session reference object when using ByReference mode.
Required? true
Position? named
Default value
Accept pipeline input? false
Aliases
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Requires the Windows 10+ Operating System
-------------------------- EXAMPLE 1 --------------------------
PS C:\> # Execute simple JavaScript
Invoke-WebbrowserEvaluation "document.title = 'hello world'"
-------------------------- EXAMPLE 2 --------------------------
PS>
# Synchronizing data
Select-WebbrowserTab -Force;
$Global:Data = @{ files= (Get-ChildItem *.* -file | % FullName)};
[int] $number = Invoke-WebbrowserEvaluation "
document.body.innerHTML = JSON.stringify(data.files);
data.title = document.title;
return 123;
";
Write-Host "
Document title : $($Global:Data.title)
return value : $Number
";
-------------------------- EXAMPLE 3 --------------------------
PS>
# Support for promises
Select-WebbrowserTab -Force;
Invoke-WebbrowserEvaluation "
let myList = [];
return new Promise((resolve) => {
let i = 0;
let a = setInterval(() => {
myList.push(++i);
if (i == 10) {
clearInterval(a);
resolve(myList);
}
}, 1000);
});
"
-------------------------- EXAMPLE 4 --------------------------
PS>
# Support for promises and more
# this function returns all rows of all tables/datastores of all databases of indexedDb in the selected tab
# beware, not all websites use indexedDb, it could return an empty set
Select-WebbrowserTab -Force;
Set-WebbrowserTabLocation "https://www.youtube.com/"
Start-Sleep 3
$AllIndexedDbData = Invoke-WebbrowserEvaluation "
// enumerate all indexedDB databases
for (let db of await indexedDB.databases()) {
// request to open database
let openRequest = await indexedDB.open(db.name);
// wait for eventhandlers to be called
await new Promise((resolve,reject) => {
openRequest.onsuccess = resolve;
openRequest.onerror = reject
});
// obtain reference
let openedDb = openRequest.result;
// initialize result
let result = { DatabaseName: db.name, Version: db.version, Stores: [] }
// itterate object store names
for (let i = 0; i < openedDb.objectStoreNames.length; i++) {
// reference
let storeName = openedDb.objectStoreNames[i];
// start readonly transaction
let tr = openedDb.transaction(storeName);
// get objectstore handle
let store = tr.objectStore(storeName);
// request all data
let getRequest = store.getAll();
// await result
await new Promise((resolve,reject) => {
getRequest.onsuccess = resolve;
getRequest.onerror = reject;
});
// add result
result.Stores.push({ StoreName: storeName, Data: getRequest.result});
}
// stream this database contents to the PowerShell pipeline, and continue
yield result;
}
";
$AllIndexedDbData | Out-Host
-------------------------- EXAMPLE 5 --------------------------
PS>
# Support for yielded pipeline results
Select-WebbrowserTab -Force;
Invoke-WebbrowserEvaluation "
for (let i = 0; i < 10; i++) {
await (new Promise((resolve) => setTimeout(resolve, 1000)));
yield i;
}
";
-------------------------- EXAMPLE 6 --------------------------
PS>Get-ChildItem *.js | Invoke-WebbrowserEvaluation -Edge
-------------------------- EXAMPLE 7 --------------------------
PS>ls *.js | et -e Open-BrowserBookmarks --> sites Opens browser bookmarks that match specified search criteria.
Open-BrowserBookmarks [[-Queries] <String[]>] [-Edge] [-Chrome] [-Firefox] [-OpenInEdge] [-OpenInChrome] [-OpenInFirefox] [-Monitor
<Int32>] [-Private] [-Force] [-FullScreen] [-Width <Int32>] [-Height <Int32>] [-X <Int32>] [-Y <Int32>] [-Left] [-Right] [-Top]
[-Bottom] [-Centered] [-ApplicationMode] [-NoBrowserExtensions] [-AcceptLang <String>] [-RestoreFocus] [-NewWindow] [-Count <Int32>]
[<CommonParameters>] Searches bookmarks across Microsoft Edge, Google Chrome, and Mozilla Firefox
browsers based on provided search queries. Opens matching bookmarks in the
selected browser with configurable window settings and browser modes.
-Queries <String[]>
Search terms used to filter bookmarks by title or URL.
Required? false
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Aliases
Accept wildcard characters? false
-Edge [<SwitchParameter>]
Use Microsoft Edge browser bookmarks as search source.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Chrome [<SwitchParameter>]
Use Google Chrome browser bookmarks as search source.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Firefox [<SwitchParameter>]
Use Mozilla Firefox browser bookmarks as search source.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-OpenInEdge [<SwitchParameter>]
Open found bookmarks in Microsoft Edge browser.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-OpenInChrome [<SwitchParameter>]
Open found bookmarks in Google Chrome browser.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-OpenInFirefox [<SwitchParameter>]
Open found bookmarks in Mozilla Firefox browser.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Monitor <Int32>
Specifies target monitor: 0=default, -1=discard, -2=secondary monitor.
Required? false
Position? named
Default value -1
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Private [<SwitchParameter>]
Opens bookmarks in private/incognito browsing mode.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Force [<SwitchParameter>]
Forces enabling of debugging port, stops existing browser instances if needed.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-FullScreen [<SwitchParameter>]
Opens browser windows in fullscreen mode.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Width <Int32>
Sets initial browser window width in pixels.
Required? false
Position? named
Default value -1
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Height <Int32>
Sets initial browser window height in pixels.
Required? false
Position? named
Default value -1
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-X <Int32>
Sets initial browser window X position.
Required? false
Position? named
Default value -999999
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Y <Int32>
Sets initial browser window Y position.
Required? false
Position? named
Default value -999999
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Left [<SwitchParameter>]
Places browser window on left side of screen.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Right [<SwitchParameter>]
Places browser window on right side of screen.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Top [<SwitchParameter>]
Places browser window on top of screen.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Bottom [<SwitchParameter>]
Places browser window on bottom of screen.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Centered [<SwitchParameter>]
Centers browser window on screen.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-ApplicationMode [<SwitchParameter>]
Hides browser controls for clean app-like experience.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-NoBrowserExtensions [<SwitchParameter>]
Prevents loading of browser extensions.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-AcceptLang <String>
Sets browser accept-language HTTP header.
Required? false
Position? named
Default value
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-RestoreFocus [<SwitchParameter>]
Restores PowerShell window focus after opening bookmarks.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-NewWindow [<SwitchParameter>]
Creates new browser window instead of reusing existing one.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Count <Int32>
Maximum number of bookmarks to open (default 50).
Required? false
Position? named
Default value 50
Accept pipeline input? false
Aliases
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Open-Webbrowser --> wb Opens one or more webbrowser instances.
Open-Webbrowser [[-Url] <String[]>] [-Private] [-Force] [-Edge] [-Chrome] [-Chromium] [-Firefox] [-All] [-Monitor <Int32>] [-FullScreen]
[-Width <Int32>] [-Height <Int32>] [-X <Int32>] [-Y <Int32>] [-Left] [-Right] [-Top] [-Bottom] [-Centered] [-ApplicationMode]
[-NoBrowserExtensions] [-AcceptLang <String>] [-RestoreFocus] [-NewWindow] [-PassThru] [<CommonParameters>] Opens one or more webbrowsers in a configurable manner, using commandline
switches to control window position, size, and browser-specific features.
-Url <String[]>
The URL or URLs to open in the browser. Can be provided via pipeline.
Required? false
Position? 1
Default value
Accept pipeline input? true (ByValue)
Aliases
Accept wildcard characters? false
-Private [<SwitchParameter>]
Opens in incognito/private browsing mode.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Force [<SwitchParameter>]
Forces debugging port enabled, stopping existing browser processes if needed.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Edge [<SwitchParameter>]
Opens URLs in Microsoft Edge.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Chrome [<SwitchParameter>]
Opens URLs in Google Chrome.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Chromium [<SwitchParameter>]
Opens URLs in Microsoft Edge or Google Chrome, depending on default browser.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Firefox [<SwitchParameter>]
Opens URLs in Firefox.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-All [<SwitchParameter>]
Opens URLs in all registered modern browsers.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Monitor <Int32>
The monitor to use (0=default, -1=discard, -2=configured secondary).
Required? false
Position? named
Default value -2
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-FullScreen [<SwitchParameter>]
Opens browser in fullscreen mode.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Width <Int32>
Initial width of browser window.
Required? false
Position? named
Default value -1
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Height <Int32>
Initial height of browser window.
Required? false
Position? named
Default value -1
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-X <Int32>
Initial X position of browser window.
Required? false
Position? named
Default value -999999
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Y <Int32>
Initial Y position of browser window.
Required? false
Position? named
Default value -999999
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Left [<SwitchParameter>]
Places browser window on left side of screen.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Right [<SwitchParameter>]
Places browser window on right side of screen.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Top [<SwitchParameter>]
Places browser window on top of screen.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Bottom [<SwitchParameter>]
Places browser window on bottom of screen.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Centered [<SwitchParameter>]
Places browser window in center of screen.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-ApplicationMode [<SwitchParameter>]
Hides browser controls.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-NoBrowserExtensions [<SwitchParameter>]
Prevents loading of browser extensions.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-AcceptLang <String>
Sets browser accept-lang HTTP header.
Required? false
Position? named
Default value
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-RestoreFocus [<SwitchParameter>]
Restores PowerShell window focus after opening browser.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-NewWindow [<SwitchParameter>]
Creates new browser window instead of reusing existing one.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-PassThru [<SwitchParameter>]
Returns browser process object.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Requires the Windows 10+ Operating System
This cmdlet was mend to be used, interactively.
It performs some strange tricks to position windows, including invoking alt-tab keystrokes.
It is best not to touch the keyboard or mouse, while it is doing that.
For fast launches of multple urls:
SET : -Monitor -1
AND : DO NOT use any of these switches: -X, -Y, -Left, -Right, -Top, -Bottom or -RestoreFocus
For browsers that are not installed on the system, no actions may be performed or errors occur - at all.
-------------------------- EXAMPLE 1 --------------------------
PS C:\> url from parameter
PS> Open-Webbrowser -Chrome -Left -Top -Url "https://genxdev.net/"
urls from pipeline
PS> @("https://genxdev.net/", "https://github.com/genXdev/") | Open-Webbrowser
re-position already open window to primary monitor on right side
PS> Open-Webbrowser -Monitor 0 -right
re-position already open window to secondary monitor, full screen
PS> Open-Webbrowser -Monitor 0
re-position already open window to secondary monitor, left top
PS> Open-Webbrowser -Monitor 0 -Left -Top
PS> wb -m 0 -left -top Select-WebbrowserTab --> Select-BrowserTab, st Selects a browser tab for automation in Chrome or Edge.
Select-WebbrowserTab [[-Id] <Int32>] [-Edge] [-Chrome] [-Force] [<CommonParameters>]
Select-WebbrowserTab [-Name] <String> [-Edge] [-Chrome] [-Force] [<CommonParameters>]
Select-WebbrowserTab [-Edge] [-Chrome] -ByReference <PSObject> [-Force] [<CommonParameters>] Manages browser tab selection for automation tasks. Can select tabs by ID, name,
or reference. Shows available tabs when no selection criteria are provided.
Supports both Chrome and Edge browsers. Handles browser connection and session
management.
-Id <Int32>
Numeric identifier for the tab, shown when listing available tabs.
Required? false
Position? 1
Default value -1
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Name <String>
URL pattern to match when selecting a tab. Selects first matching tab.
Required? true
Position? 1
Default value
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Edge [<SwitchParameter>]
Switch to force selection in Microsoft Edge browser.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Chrome [<SwitchParameter>]
Switch to force selection in Google Chrome browser.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-ByReference <PSObject>
Session reference object from Get-ChromiumSessionReference to select specific tab.
Required? true
Position? named
Default value
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Force [<SwitchParameter>]
Switch to force browser restart if needed during selection.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Set-BrowserVideoFullscreen --> fsvideo Maximizes the first video element found in the current browser tab.
Set-BrowserVideoFullscreen [<CommonParameters>] Executes JavaScript code to locate and maximize the first video element on the
current webpage. The video is set to cover the entire viewport with maximum
z-index to ensure visibility. Page scrollbars are hidden for a clean fullscreen
experience.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Set-RemoteDebuggerPortInBrowserShortcuts --> Set-BrowserDebugPorts Updates browser shortcuts to enable remote debugging ports.
Set-RemoteDebuggerPortInBrowserShortcuts [<CommonParameters>] Modifies Chrome and Edge browser shortcuts to include remote debugging port
parameters. This enables automation scripts to interact with the browsers through
their debugging interfaces. Handles both user-specific and system-wide shortcuts.
The function:
- Removes any existing debugging port parameters
- Adds current debugging ports for Chrome and Edge
- Updates shortcuts in common locations (Desktop, Start Menu, Quick Launch)
- Requires administrative rights for system-wide shortcuts
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Requires administrative access to modify system shortcuts.
-------------------------- EXAMPLE 1 --------------------------
PS C:\> Set-RemoteDebuggerPortInBrowserShortcuts
Updates all Chrome and Edge shortcuts with their respective debugging ports. Set-WebbrowserTabLocation --> lt, Nav Navigates the current webbrowser tab to a specified URL.
Set-WebbrowserTabLocation [-Url] <String> [<CommonParameters>]
Set-WebbrowserTabLocation [-Url] <String> [-Edge] [<CommonParameters>]
Set-WebbrowserTabLocation [-Url] <String> [-Chrome] [<CommonParameters>] Sets the location (URL) of the currently selected webbrowser tab. Supports both
Edge and Chrome browsers through optional switches. The navigation includes
validation of the URL and ensures proper page loading through async operations.
-Url <String>
The target URL for navigation. Accepts pipeline input and must be a valid URL
string. This parameter is required.
Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Aliases
Accept wildcard characters? false
-Edge [<SwitchParameter>]
Switch parameter to specifically target Microsoft Edge browser. Cannot be used
together with -Chrome parameter.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Chrome [<SwitchParameter>]
Switch parameter to specifically target Google Chrome browser. Cannot be used
together with -Edge parameter.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Show-WebsiteInAllBrowsers --> Show-UrlInAllBrowsers Opens a URL in multiple browsers simultaneously in a mosaic layout.
Show-WebsiteInAllBrowsers [-Url] <String> [<CommonParameters>] This function creates a mosaic layout of browser windows by opening the specified
URL in Chrome, Edge, Firefox, and a private browsing window. The browsers are
arranged in a 2x2 grid pattern:
- Chrome: Top-left quadrant
- Edge: Bottom-left quadrant
- Firefox: Top-right quadrant
- Private window: Bottom-right quadrant
-Url <String>
The URL to open in all browsers. Accepts pipeline input and can be specified by
position or through properties.
Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Aliases
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Write-Bookmarks Write-Bookmarks [[-BookmarksFilePath] <string>] [[-BookmarksToWrite] <array>] -BookmarksFilePath <string>
Required? false
Position? 0
Accept pipeline input? false
Parameter set name (All)
Aliases None
Dynamic? false
Accept wildcard characters? false
-BookmarksToWrite <array>
Required? false
Position? 1
Accept pipeline input? false
Parameter set name (All)
Aliases None
Dynamic? false
Accept wildcard characters? false
Â
_AssureTypes Initializes required Playwright types and assemblies for web automation.
_AssureTypes [<CommonParameters>] This internal function ensures the required Microsoft Playwright assemblies are
loaded and initializes the global concurrent dictionary used to store browser
instances. The function is called automatically when the module loads and sets up
the foundation for browser automation tasks.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Close-PlaywrightDriver Closes a Playwright browser instance and removes it from the global cache.
Close-PlaywrightDriver [[-BrowserType] <String>] [[-ReferenceKey] <String>] [<CommonParameters>] 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.
-BrowserType <String>
Specifies the type of browser instance to close (Chromium, Firefox, or Webkit).
If not specified, defaults to Chromium.
Required? false
Position? 1
Default value Chromium
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-ReferenceKey <String>
The unique identifier used to retrieve the browser instance from the global
cache. If not specified, defaults to "Default".
Required? false
Position? 2
Default value Default
Accept pipeline input? false
Aliases
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Connect-PlaywrightViaDebuggingPort Connects to an existing browser instance via debugging port.
Connect-PlaywrightViaDebuggingPort [-WsEndpoint] <String> [<CommonParameters>] Establishes a connection to a running Chromium-based browser instance using the
WebSocket debugger URL. Creates a Playwright instance and connects over CDP
(Chrome DevTools Protocol). The connected browser instance is stored in a global
dictionary for later reference.
-WsEndpoint <String>
The WebSocket URL for connecting to the browser's debugging port. This URL
typically follows the format 'ws://hostname:port/devtools/browser/<id>'.
Required? true
Position? 1
Default value
Accept pipeline input? false
Aliases
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Get-PlaywrightDriver Creates or retrieves a configured Playwright browser instance.
Get-PlaywrightDriver [[-BrowserType] <String>] [[-ReferenceKey] <String>] [-Visible] [-Url <String>] [-Monitor <Int32>] [-Width <Int32>]
[-Height <Int32>] [-X <Int32>] [-Y <Int32>] [-Left] [-Right] [-Top] [-Bottom] [-Centered] [-FullScreen] [-PersistBrowserState]
[<CommonParameters>]
Get-PlaywrightDriver -WsEndpoint <String> [<CommonParameters>] Manages Playwright browser instances with support for Chrome, Firefox and Webkit.
Handles browser window positioning, state persistence, and reconnection to
existing instances. Provides a unified interface for browser automation tasks.
-BrowserType <String>
The browser engine to use (Chromium, Firefox, or Webkit).
Required? false
Position? 1
Default value Chromium
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-ReferenceKey <String>
Unique identifier to track browser instances across sessions.
Required? false
Position? 2
Default value Default
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Visible [<SwitchParameter>]
Shows the browser window instead of running headless.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Url <String>
Initial URL to navigate after launching the browser.
Required? false
Position? named
Default value
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Monitor <Int32>
Target monitor for window placement (0=primary, -1=discard, -2=secondary).
Required? false
Position? named
Default value -2
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Width <Int32>
Browser window width in pixels.
Required? false
Position? named
Default value -1
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Height <Int32>
Browser window height in pixels.
Required? false
Position? named
Default value -1
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-X <Int32>
Horizontal window position in pixels.
Required? false
Position? named
Default value -999999
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Y <Int32>
Vertical window position in pixels.
Required? false
Position? named
Default value -999999
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Left [<SwitchParameter>]
Aligns window to screen left.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Right [<SwitchParameter>]
Aligns window to screen right.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Top [<SwitchParameter>]
Aligns window to screen top.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Bottom [<SwitchParameter>]
Aligns window to screen bottom.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Centered [<SwitchParameter>]
Centers window on screen.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-FullScreen [<SwitchParameter>]
Launches browser in fullscreen mode.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-PersistBrowserState [<SwitchParameter>]
Maintains browser profile between sessions.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-WsEndpoint <String>
WebSocket URL for connecting to existing browser instance.
Required? true
Position? named
Default value
Accept pipeline input? false
Aliases
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Get-PlaywrightProfileDirectory Gets the Playwright browser profile directory for persistent sessions.
Get-PlaywrightProfileDirectory [[-BrowserType] <String>] [<CommonParameters>] Creates and manages browser profile directories for Playwright automated testing.
Profiles are stored in LocalAppData under GenXdev.Powershell/Playwright.profiles.
These profiles enable persistent sessions across browser automation runs.
-BrowserType <String>
Specifies the browser type to create/get a profile directory for. Can be
Chromium, Firefox, or Webkit. Defaults to Chromium if not specified.
Required? false
Position? 1
Default value Chromium
Accept pipeline input? false
Aliases
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Resume-WebbrowserTabVideo --> wbvideoplay Resumes video playback in a YouTube browser tab.
Resume-WebbrowserTabVideo [<CommonParameters>] Finds the active YouTube browser tab and resumes video playback by executing the
play() method on any video elements found in the page. If no YouTube tab is
found, the function throws an error. This function is particularly useful for
automating video playback control in browser sessions.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Requires an active Chrome browser session with at least one YouTube tab open.
The function will throw an error if no YouTube tab is found.
-------------------------- EXAMPLE 1 --------------------------
PS C:\> Resume-WebbrowserTabVideo
-------------------------- EXAMPLE 2 --------------------------
PS C:\> wbvideoplay Stop-WebbrowserVideos --> ssst, wbsst, wbvideostop Pauses video playback in all active browser sessions.
Stop-WebbrowserVideos [<CommonParameters>] Iterates through all active browser sessions and pauses any playing videos by
executing JavaScript commands. The function maintains the original session state
and handles errors gracefully.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Unprotect-WebbrowserTab --> wbctrl Takes control of a selected web browser tab for interactive manipulation.
Unprotect-WebbrowserTab [[-UseCurrent]] [[-Force]] [<CommonParameters>] This function enables interactive control of a browser tab that was previously
selected using Select-WebbrowserTab. It provides direct access to the Microsoft
Playwright Page object's properties and methods, allowing for automated browser
interaction.
-UseCurrent [<SwitchParameter>]
When specified, uses the currently assigned browser tab instead of prompting to
select a new one. This is useful for continuing work with the same tab.
Required? false
Position? 1
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Force [<SwitchParameter>]
Forces a browser restart by closing all tabs if no debugging server is detected.
Use this when the browser connection is in an inconsistent state.
Required? false
Position? 2
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Update-PlaywrightDriverCache Maintains the Playwright browser instance cache by removing stale entries.
Update-PlaywrightDriverCache [<CommonParameters>] This function performs maintenance on the global Playwright browser instance
dictionary by removing any browser instances that are either null or have become
disconnected. This helps prevent memory leaks and ensures the cache remains
healthy.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).