Google Chrome/Microsoft Edge

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

In this chapter

    Install Ranorex Automation Add-on in Chrome

    To install the Ranorex Automation add-on, open the instrumentation wizard:

    Select Instrument a browser.

    Enable the Chrome slider option.

    After the wizard displays the Instrumentation successful message, click Finish.

    Restart your browser. Review that the Ranorex add-on has been installed correctly by clicking the Extensions icon located on the toolbar.

    Note icon

    Note

    After installing Ranorex Studio and instrumenting Google Chrome, the Customize and Control Google Chrome settings display the “Managed by your organization” message.

    The message remains after uninstalling Ranorex Studio. Follow these instructions to remove it from your browser settings: Stop managing Chrome browser.

    Install Ranorex Automation Add-on in Edge

    To install the Ranorex Automation add-on, open the instrumentation wizard:

    Select Instrument a browser.

    Enable the Microsoft Edge slider option.

    After the wizard displays the Instrumentation successful message, click Finish.

    Restart your browser. Click the browser menu icon that shows a warning symbol and select the Ranorex Automation extension has been added message.

    Click Enable to activate the add-on.

    Manual installation

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

    Type chrome://extensions (Google Chrome) or edge://extensions (MS Edge) 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.