Skip to main content

Browser - Homepage - Manage

Summary

This script serves as a wrapper for configuring the homepage of three browsers: Google Chrome, Microsoft Edge, and Mozilla Firefox. It leverages the following scripts:

The 'Action' parameter can be used to specify the desired action (Set/Remove/Replace), and the 'Browser' parameter indicates the target browser for the operation. If the 'Browser' parameter is left unspecified, the script will perform the specified action on all three browsers.

Dependencies

Importing this script will also import the following scripts:

User Parameters

NameExampleRequiredDescription
ActionSetTrueThe 'Action' parameter can be used to specify the desired action (Set/Remove).
  • Set -> To set the Homepage
  • Remove -> To remove the Homepage
  • Replace -> To replace the current Homepage
    • Use this to override previously configured settings (such as EnforceOnNewTab)
BrowserChromeFalseThe 'Browser' parameter specifies the browser for setting/removing the homepage. Only 'Chrome', 'Edge', and 'Firefox' are acceptable values. If unspecified, the script will perform the action on all three browsers. Each value should be separated by a comma without any additional spaces, e.g., chrome,firefox.
Homepagehttps://www.provaltech.comTrueThe string value of the homepage to set in the browser. Only useful with the Set and Replace actions.
EnforceOnNewTab1FalseSet to 1 to force the homepage on each new tab instead of the new tab page. Only useful with the Set and Replace actions and only works on Chromium Browsers (Chrome and Edge).
EnforceHomepageStartup1FalseSet to 1 to force the homepage to be the only open tab at the startup of the browser. Only useful with the Set and Replace actions.

Action

Set:

The Set action can be used for setting a specific homepage for the concerned browser(s).

Parameters Used:
Set Parameters

Output:
Set Output

Remove:

The Remove action can be used to remove the currently applied homepage from the concerned browser(s).

Parameters Used:
Remove Parameters

Output:
Google Chrome:
Remove Chrome Output
Mozilla Firefox:
Remove Firefox Output
Microsoft Edge:
Remove Edge Output

Replace:

The Replace action serves to substitute the existing homepage configuration in the specified browser(s) with a new one. This functionality proves useful when you intend to replace the current homepage with an alternative one. Another scenario where this action is beneficial is when a homepage has been erroneously configured with the EnforceOnNewTab option. In such cases, users can rectify the error by employing the Replace action in the script, leaving the EnforceOnNewTab parameter empty. This ensures a seamless correction of the previous misconfiguration.

Parameters Used:
Replace Parameters

Output:
Replace Output

Sample Run

  • Set the Homepage on a single browser.
    Example: Setting https://www.provaltech.com to the homepage of Google Chrome:
    Set Chrome Homepage

  • Remove the Homepage from a single browser:
    Example: Removing the homepage from Mozilla Firefox:
    Remove Firefox Homepage

  • Replace the current homepage on a single browser.
    Example: Replacing the homepage on Microsoft Edge with https://www.provaltech.com:
    Replace Edge Homepage

  • Perform an action against multiple browsers:
    Example: Replacing the homepage with https://www.provaltech.com for Google Chrome and Mozilla Firefox:
    Replace Chrome and Firefox Homepage

  • Perform an action against all browsers:
    Example: Removing the homepage from all three browsers (Google Chrome, Microsoft Edge, Mozilla Firefox):
    Remove All Browsers Homepage

  • Enforce the homepage on browser startup.
    Example: Configuring Google Chrome and Microsoft Edge to open https://www.provaltech.com as the homepage upon startup and ensuring that this setting is enforced in both browsers.
    Enforce Homepage on Startup

Output

  • Script logs