Handling CAPTCHAs (strategies) in Selenium Python

Introduction

CAPTCHAs stop automated tests from running smoothly. We need ways to handle them so tests don't get stuck.

When your test tries to log in and a CAPTCHA appears.

When filling forms that have CAPTCHA to prevent bots.

When scraping websites that use CAPTCHA to block automation.

When running repeated tests that trigger CAPTCHA challenges.

When you want to test user flows but CAPTCHA blocks automation.

Syntax

Selenium Python

from selenium import webdriver

# No direct syntax for CAPTCHA, but strategies include:
# 1. Wait for manual input
# 2. Use CAPTCHA solving services
# 3. Disable CAPTCHA in test environment
# 4. Use test keys or bypass methods

# Example: waiting for manual CAPTCHA solve

browser = webdriver.Chrome()
browser.get('https://example.com/login')

# Pause test to let user solve CAPTCHA manually
input('Please solve CAPTCHA and press Enter to continue...')

# Continue with test after CAPTCHA solved

CAPTCHAs are designed to stop automation, so Selenium cannot solve them directly.

Strategies depend on the test environment and goals.

Examples

Pauses test to let a human solve CAPTCHA before continuing.

Selenium Python

input('Solve CAPTCHA manually, then press Enter to continue...')

Automates CAPTCHA solving using external services, but needs extra work and may cost money.

Selenium Python

# Using third-party CAPTCHA solving service
# (Requires API key and service setup)

# send CAPTCHA image to service
# receive solution
# enter solution in form

# This is advanced and needs extra setup.

Best for automated tests: no CAPTCHA means smooth testing.

Selenium Python

# Disable CAPTCHA in test environment
# Ask developers to turn off CAPTCHA for testing

# Then run tests normally without CAPTCHA blocking.

Sample Program

This script opens a login page, waits for the user to solve CAPTCHA manually, then continues to fill login details and submit.

Selenium Python

from selenium import webdriver
from selenium.webdriver.common.by import By

# Open browser and go to login page
browser = webdriver.Chrome()
browser.get('https://example.com/login')

# Pause test to let user solve CAPTCHA manually
input('Please solve CAPTCHA on the page, then press Enter to continue...')

# After manual CAPTCHA solve, continue test
username = browser.find_element(By.ID, 'username')
password = browser.find_element(By.ID, 'password')

username.send_keys('testuser')
password.send_keys('password123')

login_button = browser.find_element(By.ID, 'login')
login_button.click()

print('Login attempted after CAPTCHA solved.')

browser.quit()

Important Notes

Always check if CAPTCHA can be disabled in test environments to avoid blocking tests.

Manual solving is simple but not suitable for fully automated pipelines.

Third-party services can solve CAPTCHAs but may violate site policies and add cost.

Summary

CAPTCHAs block automation, so direct solving is not possible with Selenium alone.

Common strategies: manual solve pause, disable CAPTCHA in test, or use solving services.

Choose strategy based on your test goals and environment.