W3cubDocs

/Web Extensions

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

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
reload
Yes
79
54
?
Yes
No
?
?
No
?
?
?

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"
  });
});

Note: 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.

© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/devtools/inspectedWindow/reload