easy-chrome 2.0.3

selenium chrome extension with shortcuts to control driver and element

Easy Chrome

Description

This package is used as an extension to selenium chrome WebDriver. It contains shortcuts to control driver more easily.

Features

1. Auto download chromedriver by webdriver_manager with custom cache.
2. Shortcuts to control driver and element.

Examples

• init chrome driver.

from easy_chrome import Driver
driver = Driver.set_chrome(detach_mode=True)

• wait an element located by XPATH to be visible in DOM.

// bare usage
WebDriverWait(driver, wait_time).until(EC.visibility_of_element_located((By.XPATH, xpath))

// with easy-chrome
driver.wait_visible(xpath)

• get local storage.

// bare usage
driver.execute_script("return window.sessionStorage.getItem(arguments[0]);", key)

// with easy-chrome
driver.get_local_storage(key)

• wait username input field to be visible in DOM, clear the content and write username to it.

input_xpath = "//input[@id='username']

// bare usage
WebDriverWait(driver, wait_time).until(EC.visibility_of_element_located((By.XPATH, input_xpath)).clear()
sleep(0.2)
WebDriverWait(driver, wait_time).until(EC.visibility_of_element_located((By.XPATH, input_xpath)).sendkeys(username)

// with easy-chrome
driver.wait_visible(input_xpath).clear_and_type(user_name)

Source Code

The source code is currently hosted on GitHub at: https://github.com/wcuong/easy-chrome

Release

The package is currently hosted on Pypi at: https://pypi.org/project/easy-chrome/

ChangeLog

2.0.1 2023-11-04

• Init project

2.0.2 2023-11-06

• Change headless mode to --headless=new
• Ignore DownloadBubble Feature, which enforces an download popup in incognito mode.

2.0.3 2023-11-08

• add custom windows chrome detect method because sometimes webdriver_manager fails to detect.