<div id="toc_container" class="no_bullets">Table Of Contents<ul class="toc_list"><li><a href="#When_do_we_want_to_run_tests_on_existing_browser_instances">1 When do we want to run tests on existing browser instances?</a><ul><li><a href="#Prerequisites">1.1 Prerequisites</a></li><li><a href="#How_to_launch_Chrome_with_remote_debugging_enabled">1.2 How to launch Chrome with remote debugging enabled?</a></li><li><a href="#How_to_Connect_to_an_Existing_Chrome_Browser_from_Selenium">1.3 How to Connect to an Existing Chrome Browser from Selenium?</a></li></ul></li></ul></div>
<h2 id="When-do-we-want-to-run-tests-on-existing-browser-instances?">When do we want to run tests on existing browser instances?</h2>



There are many scenarios where we want Selenium to connect to and use an existing browser that was previously opened manually or by some other program.



Some of the typical use cases are as below.



<ul><li>When the user does not want to log in every time, they add a test step while drafting the <a href="https://testsigma.com/docs/projects/settings/test-case-types/" target="_blank" rel="noreferrer noopener">test case </a>or when they want a plugin to be added in the automation-controlled browser, the Chrome browser launched using the Selenium web driver will not have their log-in information or plugins that they might have installed.</li><li>When the user has logged into an account that requires two-factor authentication.</li><li>When the user has done a sequence of manual operations that might be hard to automate have already been done.</li><li>When the application has a bug, and the user does a manual intervention to bypass a few steps.</li></ul>



Example



The sample sequence of test steps to add a beneficiary and make a transaction are



<ol><li>Go to the net banking website login page.</li><li>Enter username and password.</li><li>Go to the money transfer page.</li><li>Add the beneficiary details.</li><li>Verify the details of the bank account and person.</li><li>Select from the various methods of online money transfer including RTGS, IMPS, NEFT, UPI, and digital wallet.</li><li>Select the beneficiary name, and the amount, and then submit the details.</li><li>Verify the amount and other information on the verification page.</li><li>Click submit for the final action of the fund transfer.</li></ol>



If you want to add an assertion case where you want to verify the text message displayed after a transaction, you will be looking for an option to run ONLY the test where you assert the success/failure message displayed on the page without repeating the entire test steps from logging into the website.



The default behavior in Selenium is that a new driver instance will be initiated every time when you write a new test. In the above example, if you add the 10th test step to an existing test or write a new test in Selenium, you will be able to verify it only by running from step 1.



You can run only the assertion use case from the above example in a previously opened chrome browser where the transaction case is tested either manually or using selenium script when the browser is opened in debugging mode.



When the Chrome browser application is opened in a remote debugger port, we could easily connect a new Selenium Chrome Driver to that existing chrome instance.



<h3 id="Prerequisites">Prerequisites</h3>



<ol><li>Chrome Browser — Version 63 or higher</li><li>Add Chrome Browser installation directory to Path variable (if you are using windows) — preferable as it would allow opening chrome browser from any directory using terminal/command prompt.</li></ol>



<h3 id="How-to-launch-Chrome-with-remote-debugging-enabled?">How to launch Chrome with remote debugging enabled?</h3>



ChromeDriver will communicate with Chrome via the <a href="https://chromedevtools.github.io/devtools-protocol/" target="_blank" rel="noreferrer noopener">remote DevTools Protocol</a>, which is not usually enabled when you open Chrome from the list of applications in the system.



So, you will need to enable the protocol by starting Chrome with the &#8211;remote-debugging-port command-line switch and choosing a port for it. Port <code>9222</code> is used by convention, but you can use any non-reserved port.



On Windows, you can run from the command prompt by appending a custom flag:



<styled-code>
start chrome.exe &#8211;remote-debugging-port=9222
</styled-code>



or



<styled-code>
<path to="" chrome="">/chrome.exe &#8211;remote-debugging-port=9222
</path></styled-code>



when the path is not set.



On macOS, you will need to find the path to the Chrome executable. Here&#8217;s an example to launch a Chrome executable that is in the default path:



<styled-code>
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome &#8211;remote-debugging-port=9222
</styled-code>



On Linux, launch the browser by running <code>google-chrome --remote-debugging-port=9222</code>



To launch Chrome with the remote DevTools protocol enabled without the need to use the command line:



<ul><li>On Windows,<ul> <li>Right-click the Chrome shortcut, and select <code>Properties</code></li><li>In the &#8220;target&#8221; field, append <code>--remote-debugging-port=9222</code> </li></ul></li><li>On macOS, either of the 3 ways mentioned below works<ul> <li>Create an <a href="https://support.apple.com/guide/automator/welcome/mac" target="_blank" rel="noreferrer noopener">Automator</a> workflow that runs a bash script to open the browser with the command line switch enabled.</li><li>Use the <code>.dmg</code> file that you can obtain from <a href="https://github.com/natkuhn/Chrome-debug/" target="_blank" rel="noreferrer noopener">this GitHub repository</a>.</li><li>You could create your executable with a tool like <a href="https://sveinbjorn.org/platypus" target="_blank" rel="noreferrer noopener">Platypus</a>.</li></ul></li></ul>



If you want to launch the browser using a custom chrome profile, you can do it by adding <code>--user-data-dir</code> flag when you launch the browser.



To enable Chrome to open a port for remote debugging in the new chrome profile, we need to launch it with a custom flag.



On Windows,



<styled-code>
start chrome.exe &#8211;remote-debugging-port=9222 &#8211;user-data-dir=&#8221;C:\selenum\ChromeProfile&#8221;
</styled-code>



On Mac,



<styled-code>
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome &#8211;remote-debugging-port=9222 &#8211;user-data-dir=&#8221;~/ChromeProfile&#8221;
</styled-code>



For <code>--user-data-dir</code> flag you can either pass the directory where a new folder will be created for storing details of the chrome profile or you can create a folder and pass it as a value for the flag. You can launch the browser in a new profile when you don’t want to pollute your default profile.



<h3 id="How-to-Connect-to-an-Existing-Chrome-Browser-from-Selenium?">How to Connect to an Existing Chrome Browser from Selenium?</h3>



Here is the sample snippet to initialize Chrome Driver in Selenium with Java/Python<code>1//Sample Java </code>



<styled-code>
//Sample Java Code
ChromeOptions options = new ChromeOptions();
options.setExperimentalOption(&#8220;debuggerAddress&#8221;,&#8221;localhost:<remote-port>&#8220;);
ChromeDriver driver = new ChromeDriver(options);
</remote-port></styled-code>



<styled-code>
#Sample Python Code
chrome_options = Options()
chrome_options.add_experimental_option(&#8220;debuggerAddress&#8221;, &#8220;127.0.0.1:9222&#8221;)
#Change chrome driver path accordingly
chrome_driver = &#8220;C:\chromedriver.exe&#8221;
driver = webdriver.Chrome(chrome_driver, chrome_options=chrome_options)
print driver.title
</styled-code>



*Replace remote-port with the port where you have launched chrome with the remote DevTools protocol enabled



A working example in a sample application is below &#8212;



<styled-code>
package com.sample.web;

import org.testng.annotations.BeforeClass;
import org.testng.annotations.Test;

import org.openqa.selenium.By;
import org.openqa.selenium.Capabilities;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.chrome.ChromeDriver;
import org.openqa.selenium.chrome.ChromeOptions;

import org.openqa.selenium.remote.*;
import org.testng.Assert;

import java.util.List;
import java.util.Map;
import java.util.concurrent.TimeUnit;

public class DebuggingMode {
 private WebDriver driver;

 @BeforeClass
 public void setUp() {
 System.setProperty(&#8220;webdriver.chrome.driver&#8221;, &#8220;resources/chromedriver&#8221;);
 ChromeOptions options = new ChromeOptions();
 options.setExperimentalOption(&#8220;debuggerAddress&#8221;, &#8220;127.0.0.1:9222&#8221;);

 driver = new ChromeDriver(options);
 driver.manage().window().maximize();
 driver.manage().timeouts().pageLoadTimeout(120, TimeUnit.SECONDS);
 driver.manage().timeouts().implicitlyWait(20, TimeUnit.SECONDS);

 Capabilities capability = ((RemoteWebDriver) driver).getCapabilities();
 Map<string, object=""> map = capability.asMap();
 for (Map.Entry<string, object=""> entry : map.entrySet()) {
 System.out.println(entry.getKey() + &#8220;:&#8221; + entry.getValue());
 }
 }

 @Test()
 public void testLoginWithWrongCredentials() {
 driver.get(&#8220;https://travel.testsigma.com/login&#8221;);
 driver.findElement(By.xpath(&#8220;//input[@name=&#8217;name&#8217;]&#8221;)).sendKeys(&#8220;admin&#8221;);
 driver.findElement(By.xpath(&#8220;//input[@name=&#8217;password&#8217;]&#8221;)).sendKeys(&#8220;abcde&#8221;);
 driver.findElement(By.xpath(&#8220;//button[@type=&#8217;submit&#8217;]&#8221;)).click();
 Assert.assertTrue(driver.findElement(By.xpath(&#8220;div[text()=&#8217;Wrong username/password&#8217;]&#8221;)).isDisplayed());

 }

 //Below test does not launch the new browser session, and you are not entering the username again
 @Test()
 public void testLoginWithCorrectPassword() {
 driver.findElement(By.xpath(&#8220;//input[@name=&#8217;password&#8217;]&#8221;)).clear();
 driver.findElement(By.xpath(&#8220;//input[@name=&#8217;password&#8217;]&#8221;)).sendKeys(&#8220;12345&#8221;);
 driver.findElement(By.xpath(&#8220;//button[@type=&#8217;submit&#8217;]&#8221;)).click();
 List<webelement> message = driver.findElements(By.xpath(&#8220;div[text()=&#8217;Wrong username/password&#8217;]&#8221;));
 Assert.assertTrue(message.isEmpty());
 }
}
</webelement></string,></string,></styled-code>

Executing Tests on existing Chrome Browser Instance