devtools.inspectedWindow.reload()

Reloads the window that the devtools are attached to.

Syntax

browser.devtools.inspectedWindow.reload(
  reloadOptions       // object
)

Parameters

reloadOptionsOptional
object. Options for the function, as follows:
ignoreCacheOptional
boolean. If true, this makes the reload ignore the browser cache (as if the user had pressed Shift+Ctrl+R).
userAgentOptional
string. Set a custom user agent for the page. The string supplied here will be sent in the browser's User-Agent header, and will be returned by calls to navigator.userAgent made by scripts running in the page.
injectedScript Optional
string. Inject the given JavaScript expression into all frames in the page, before any other scripts.

Browser compatibility

Report problems with this compatibility data on GitHub
webextensions-desktopwebextensions-mobile
ChromeEdgeFirefoxOperaSafariFirefox for Android
reload

Legend

Full support
Full support
No support
No support

Examples

Reload the inspected window, setting the user agent and injecting a script:

const reloadButton = document.querySelector("#reload-button");

reloadButton.addEventListener("click", () => {
  browser.devtools.inspectedWindow.reload({
    injectedScript:"alert(navigator.userAgent);",
    userAgent: "Not a real UA"
  });
});

Acknowledgements

This API is based on Chromium's chrome.devtools API.

Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.