webdriver-manager

4.0.2 · active · verified Thu Apr 09

webdriver-manager is a Python library that automatically manages browser drivers for Selenium. It handles downloading, installing, and caching the correct driver executable for your installed browser, eliminating manual driver management. The current version is 4.0.2, and it maintains an active release cadence with frequent bug fixes and support for new browser versions.

Warnings

breaking Version 4.0.0 introduced significant internal refactoring of driver classes. While the primary `.install()` method generally remained stable, custom or advanced integrations with internal driver manager components may require updates.
Fix: Review the official documentation and adapt custom code for changes in internal driver class structure if you were interacting with private APIs.
gotcha Prior to v4.0.0, the library could raise unhandled `NameError` or `TypeError` exceptions if running offline or if it failed to detect the installed browser's version, leading to script failures.
Fix: Upgrade to `webdriver-manager` v4.0.0 or newer to benefit from improved error handling, network resilience, and better browser detection.
gotcha Users working with Chrome browser versions less than 113 might encounter issues with driver downloads due to changes in Chrome's driver distribution method. This was specifically addressed in `webdriver-manager` v4.0.1.
Fix: Ensure `webdriver-manager` is at least v4.0.1 to correctly handle driver downloads for older Chrome browser versions.
gotcha Chromedriver download URLs for Apple M1/M2 (ARM) Macs changed, causing download failures for users on this architecture with `webdriver-manager` versions prior to v3.8.4.
Fix: Upgrade to `webdriver-manager` v3.8.4 or newer for correct Chromedriver downloads on Apple M1/M2/ARM architectures.

Install

pip install webdriver-manager Install latest version

Imports

ChromeDriverManager

from webdriver_manager.chrome import ChromeDriverManager

GeckoDriverManager

from webdriver_manager.firefox import GeckoDriverManager

EdgeChromiumDriverManager

from webdriver_manager.microsoft import EdgeChromiumDriverManager

OperaDriverManager
```
from webdriver_manager.opera import OperaDriverManager
```
OperaDriverManager is often confused as being part of the chrome submodule, but it resides in its own 'opera' submodule.

Quickstart

This quickstart demonstrates how to use `webdriver-manager` to automatically obtain the correct Chrome driver, then integrate it with `selenium` to launch a browser, navigate to a URL, and print its title. Replace `ChromeDriverManager` with `GeckoDriverManager` for Firefox, `EdgeChromiumDriverManager` for Edge, etc.

from selenium import webdriver
from selenium.webdriver.chrome.service import Service
from webdriver_manager.chrome import ChromeDriverManager

# Automatically download and install the correct ChromeDriver
driver_path = ChromeDriverManager().install()

# Initialize the Chrome service with the installed driver
service = Service(driver_path)

# Initialize the Chrome WebDriver
driver = webdriver.Chrome(service=service)

# Example usage: navigate to a page
driver.get("https://www.google.com")
print(f"Page title: {driver.title}")

# Close the browser
driver.quit()

view raw JSON →