Starting Different Browsers
python
from selenium import webdriver
chrome = webdriver.Chrome()
firefox = webdriver.Firefox()
edge = webdriver.Edge()
safari = webdriver.Safari() # macOS only; enable "Allow Remote Automation" in Safari's Develop menu
Selenium Manager finds the matching driver for each one. The commands you use after that (get, find_element, click) are the same for every browser.
Using Options
An Options object lets you change browser behavior before it starts.
python
from selenium import webdriver
from selenium.webdriver.chrome.options import Options
options = Options()
options.add_argument("--start-maximized")
options.add_argument("--incognito")
options.add_argument("--disable-notifications")
options.add_argument("--window-size=1366,768")
driver = webdriver.Chrome(options=options)
| Argument | Effect |
--start-maximized | Open the window maximized |
--incognito | Private session with no stored data |
--disable-notifications | Block 'Allow notifications' pop-ups |
--window-size=W,H | Exact size (important for responsive layouts) |
--headless=new | Run without a visible window |
--ignore-certificate-errors | Continue on bad SSL certificates (test sites only) |
--lang=en-US | Set browser language |
Headless Mode
Headless means the browser runs invisibly. It is faster and is required on servers (CI) that have no screen.
python
options = Options()
options.add_argument("--headless=new")
options.add_argument("--window-size=1920,1080") # headless defaults to a small window
driver = webdriver.Chrome(options=options)
driver.get("https://www.selenium.dev")
print(driver.title)
driver.quit()
Always set a window size in headless mode: Without it some elements may be hidden by a small layout and the test fails only in CI.
Firefox and Edge Options
python
from selenium.webdriver.firefox.options import Options as FirefoxOptions
from selenium.webdriver.edge.options import Options as EdgeOptions
ff = FirefoxOptions()
ff.add_argument("-headless")
ff_driver = webdriver.Firefox(options=ff)
edge = EdgeOptions()
edge.add_argument("--headless=new")
edge_driver = webdriver.Edge(options=edge)
Preferences: Download Folder and Pop-ups
python
import os
options = Options()
prefs = {
"download.default_directory": os.path.abspath("downloads"),
"download.prompt_for_download": False,
"profile.default_content_setting_values.notifications": 2,
"credentials_enable_service": False,
}
options.add_experimental_option("prefs", prefs)
Page Load Strategy
python
options.page_load_strategy = "eager" # normal (default), eager, none
| Strategy | get() returns when |
normal | Everything including images has loaded |
eager | HTML is parsed (DOMContentLoaded). Faster |
none | Immediately. You must use waits |
Choose the Browser from a Variable
python
import os
def create_driver(name: str = "chrome"):
name = name.lower()
if name == "chrome":
return webdriver.Chrome()
if name == "firefox":
return webdriver.Firefox()
if name == "edge":
return webdriver.Edge()
raise ValueError(f"Unsupported browser: {name}")
driver = create_driver(os.getenv("BROWSER", "chrome"))
Now BROWSER=firefox pytest switches the browser without changing code. This idea is used again in the framework section.
Conclusion
Use Options to configure the browser before launch. Run headless with a fixed window size on servers, and keep the browser name in a variable so you can test on several browsers.
Quick Summary: Options + add_argument; --headless=new + window size for CI; same commands on every browser.