Reloads the window that the devtools are attached to.

Syntax

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

Parameters

• reloadOptions

  • : object. Options for the function, as follows:

    • ignoreCache

      • : boolean. If true, this makes the reload ignore the browser cache (as if the user had pressed Shift+Ctrl+R).

      userAgent

      • : 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

      • : string. Inject the given JavaScript expression into all frames in the page, before any other scripts.

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

Browser compatibility

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