Google Chrome | Ranorex Help Center
Help CenterUser GuideInterfaces and connectivity

Google Chrome/Chromium Edge

On this page you’ll find out how to instrument Google Chrome and MS Edge based on Chromium with the Instrumentation Wizard. The process is essentially the same. You’ll also find some recommendations for settings when automating with these browsers at the end of the page.

In this chapter

    Install the Ranorex Automation Add-on

    When you see the technology limitation warning appear:

    Click Run Wizard…

    Select Google Chrome or Microsoft Edge (Chromium-based)  and click Next >.

    Select the desired options and click Next > to start the instrumentation process.

    Once instrumentation is complete, click Finish:

    For Google Chrome, you are done here. For Microsoft Edge (Chromium-based), the browser will open. There, confirm installation of the extension.

    Manual installation

    You can also install the add-on manually without the Instrumentation Wizard.

    Type chrome://extensions (Google Chrome) or edge://extensions (MS Edge based on Chromium) into the address bar.

    Click Load unpacked.

    Browse to the folder Ranorex Chrome Extension in your Ranorex Studio installation folder.

    Click OK.

    Important notes for testing with Google Chrome/MS Edge

    • If you want to test cross-domain iframe scripting, start the browser with the command line argument –disable-web-security –user-data-dir=””
    • Make sure that the extension ID of the Ranorex Add-on is listed in the “allowed_origins” section of the binRanorex.Plugin.ChromeMsgHost.manifest file.
    • If the NoScript Extension is installed, disable it.

    Test offline/local HTML files (“Allow access to file URLs”)

    To test offline/local HTML files, the option Allow access to file URLs must be enabled for the Ranorex extension. Unfortunately, due to some technical restrictions, this doesn’t work when instrumenting Google Chrome/MS Edge (Chromium) with the Instrumentation Wizard or the Open browser action.

    Here are the workarounds for both browsers.

    Google Chrome

    Make sure the extension is installed (through any method except directly through the Google Chrome store.)

    Go to the extension’s installation folder:
    %LOCALAPPDATA%\Google\Chrome\User Data\Default\Extensions\egdlgaljianpgdlmfijpphbadibfncdm

    Copy the folder named 1.2.9_0 to another location.

    Open this copied folder and find the file manifest.json.

    Open this file in a text editor and under “permissions”, add “storage”, so the line looks like this:

    "permissions": [ "background", "tabs", "nativeMessaging", "http://*/*", "https://*/*", "storage" ],

    Save and close the file.

    Uninstall the Ranorex extension with the Instrumentation Wizard.

    Open Chrome, go to Extensions, and ensure Developer Mode is active.

    Click Load unpacked extension and point to the copied 1.2.9_0 folder with the edited manifest file.

    Install the Chrome extension again through the Instrumentation Wizard to resolve any errors displayed in Chrome.

    MS Edge

    If the extension isn’t installed, start with step 2.

    Uninstall the extension with the Instrumentation Wizard.

    In Edge, go to the Google Chrome store.

    Find the Ranorex extension and install it.

    Once installed and enabled, make sure Allow access to file URLs is enabled in the extension’s settings.