Siapkan Python
Gunakan Gunakan Python 3.10+ dan pastikan perintah Python serta pip dapat dipanggil dari terminal.
1. Gambaran Umum
Selenium WebDriver mengontrol browser secara native seperti pengguna nyata. Untuk Python, alur kerjanya adalah: pasang Python, buat environment proyek, pasang paket Selenium, simpan script .py, lalu jalankan dengan interpreter Python.
Install Selenium
Paket Python Selenium dipasang di virtual environment agar dependency proyek tetap terisolasi.
Run Script
Gunakan Selenium Manager secara default, atau pilih webdriver-manager/chromedriver-autoinstaller bila perlu kontrol eksplisit.
Driver path biasanya tidak perlu diisi
Selenium modern menyertakan Selenium Manager. Saat script membuat webdriver.Chrome(), webdriver.Firefox(), atau webdriver.Edge() tanpa path driver, Selenium akan mencoba mengelola driver yang sesuai secara otomatis.
2. Prasyarat
Versi yang digunakan dalam panduan ini
Per 3 Agustus 2026, release stabil Selenium Python adalah 4.46.0 dan package terbaru memerlukan Python 3.10+. Gunakan python -m pip install -U selenium agar pip memilih release terbaru yang kompatibel.
Sebelum instalasi, pastikan perangkat memenuhi kebutuhan berikut.
Wajib
Python 3.10+ untuk Selenium terbaru, pip, terminal/command prompt, dan satu browser yang didukung.
Direkomendasikan
Virtual environment, editor kode seperti VS Code, dan koneksi internet saat run pertama.
| Komponen | Fungsi | Pengecekan |
|---|---|---|
| Python 3.10+ | Menjalankan release Selenium Python terbaru. Python lama mungkin hanya memperoleh release Selenium lama yang masih kompatibel. | python --version atau python3 --version |
| pip | Memasang package Selenium. | python -m pip --version |
| Browser | Target automation: Chrome, Firefox, atau Edge. | Buka browser dan cek menu About. |
| Internet | Download package dan driver pada eksekusi pertama. | Pastikan akses ke PyPI dan vendor browser tidak diblokir. |
Pilihan Instalasi Browser Driver
Pilih satu metode berikut. Selenium Manager adalah pilihan utama untuk proyek baru.
Selenium Manager
Built-in pada Selenium modern. Mendukung Chrome, Firefox, dan Edge tanpa package driver tambahan.
Recommended
python -m pip install --upgrade seleniumwebdriver-manager
Package pihak ketiga untuk download, cache, dan resolusi driver secara eksplisit dari Python.
Optional · multi-browser
python -m pip install --upgrade selenium webdriver-managerChromeDriver Autoinstaller
Package pihak ketiga khusus Chrome/Chromium. Memeriksa versi Chrome lalu menambahkan ChromeDriver ke PATH.
Optional · Chrome only
python -m pip install --upgrade selenium chromedriver-autoinstallerJangan gunakan pip install chromedriver secara sembarang
ChromeDriver adalah binary yang harus cocok dengan browser dan arsitektur OS. Gunakan Selenium Manager, webdriver-manager, chromedriver-autoinstaller, atau driver resmi manual. Package PyPI bernama mirip belum tentu resmi atau kompatibel.
3. Instalasi Selenium Berdasarkan Sistem Operasi
Pilih OS. Semua metode di bawah menggunakan virtual environment bernama .venv.
Install Python
Unduh installer resmi Python untuk Windows. Saat installer klasik digunakan, aktifkan opsi Add Python to PATH. Pada Windows terbaru, Python Install Manager resmi juga dapat digunakan.
Sumber resmi: Python for Windows.
Buka PowerShell dan verifikasi
PowerShell
py --version
py -m pip --versionJika perintah py tidak tersedia, coba python --version.
Buat folder proyek
PowerShell
mkdir selenium-project
cd selenium-projectBuat dan aktifkan virtual environment
PowerShell
py -m venv .venv
.\.venv\Scripts\Activate.ps1PowerShell memblokir activation script?
Jalankan hanya untuk sesi PowerShell saat ini:
PowerShell
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\.venv\Scripts\Activate.ps1Menggunakan Command Prompt, bukan PowerShell
Command Prompt
py -m venv .venv
.venv\Scripts\activate.batInstall Selenium
PowerShell
python -m pip install --upgrade pip setuptools wheel
python -m pip install --upgrade selenium
python -c "import selenium; print('Selenium:', selenium.__version__)"Opsional: install driver manager melalui pip
Pilih salah satu sesuai mode yang dipilih pada Generator:
Multi-browser
python -m pip install --upgrade webdriver-managerChrome only
python -m pip install --upgrade chromedriver-autoinstallerInstall Python
Gunakan installer resmi dari Python.org atau package manager yang dikelola sendiri. Jangan bergantung pada Python sistem lama.
Sumber resmi: Python for macOS.
Alternatif menggunakan Homebrew
Terminal
brew update
brew install pythonHomebrew adalah opsi pihak ketiga. Gunakan hanya bila Homebrew memang menjadi package manager standar Anda.
Verifikasi Python dan pip
Terminal
python3 --version
python3 -m pip --versionBuat proyek dan virtual environment
Terminal
mkdir -p selenium-project
cd selenium-project
python3 -m venv .venv
source .venv/bin/activateInstall Selenium
Terminal
python -m pip install --upgrade pip setuptools wheel
python -m pip install --upgrade selenium
python -c "import selenium; print('Selenium:', selenium.__version__)"Pastikan browser dapat dijalankan
Install Chrome, Firefox, atau Edge untuk macOS. Pada eksekusi pertama, macOS dapat meminta izin atau melakukan pemeriksaan keamanan terhadap komponen yang baru diunduh.
Install Python, pip, dan venv
Bash
sudo apt update
sudo apt install -y python3 python3-pip python3-venvVerifikasi instalasi
Bash
python3 --version
python3 -m pip --versionBuat proyek dan aktifkan environment
Bash
mkdir -p ~/selenium-project
cd ~/selenium-project
python3 -m venv .venv
source .venv/bin/activateInstall Selenium
Bash
python -m pip install --upgrade pip setuptools wheel
python -m pip install --upgrade selenium
python -c "import selenium; print('Selenium:', selenium.__version__)"Install browser
Install Chrome, Chromium, Firefox, atau Edge dari repositori distribusi atau repositori resmi vendor. Nama paket dapat berbeda antar versi distribusi.
Contoh Firefox pada Ubuntu/Debian
sudo apt install -y firefoxPada server minimal tanpa desktop, gunakan mode headless. Browser tetap harus terpasang walaupun jendelanya tidak ditampilkan.
Install Python dan pip
Fedora / RHEL family
sudo dnf install -y python3 python3-pipPada beberapa release, modul venv sudah termasuk dalam paket Python.
Buat virtual environment
Bash
mkdir -p ~/selenium-project
cd ~/selenium-project
python3 -m venv .venv
source .venv/bin/activateInstall Selenium
Bash
python -m pip install --upgrade pip setuptools wheel
python -m pip install --upgrade selenium
python -c "import selenium; print('Selenium:', selenium.__version__)"Install browser
Firefox biasanya tersedia dari repositori distribusi. Chrome atau Edge umumnya memakai repositori vendor.
Contoh Firefox
sudo dnf install -y firefoxInstall Python, pip, dan browser
Bash
sudo pacman -Syu
sudo pacman -S python python-pip firefoxBuat virtual environment
Bash
mkdir -p ~/selenium-project
cd ~/selenium-project
python -m venv .venv
source .venv/bin/activateInstall Selenium
Bash
python -m pip install --upgrade pip setuptools wheel
python -m pip install --upgrade selenium
python -c "import selenium; print('Selenium:', selenium.__version__)"Install Python, pip, dan browser
Bash
sudo zypper refresh
sudo zypper install python3 python3-pip python3-virtualenv MozillaFirefoxNama paket dapat berubah berdasarkan versi Leap atau Tumbleweed.
Buat virtual environment
Bash
mkdir -p ~/selenium-project
cd ~/selenium-project
python3 -m venv .venv
source .venv/bin/activateInstall Selenium
Bash
python -m pip install --upgrade pip setuptools wheel
python -m pip install --upgrade selenium
python -c "import selenium; print('Selenium:', selenium.__version__)"4. Quick Start: Pastikan Selenium Berfungsi
Sebelum menjalankan hasil generator, buat test sederhana untuk memastikan Python, Selenium, browser, dan Selenium Manager berfungsi.
Pastikan virtual environment aktif
Prompt terminal biasanya menampilkan awalan (.venv). Jika belum aktif, jalankan command activation sesuai OS pada bagian sebelumnya.
Buat file test_selenium.py
Python
from selenium import webdriver
driver = webdriver.Chrome()
try:
driver.get("https://example.com")
print("Title:", driver.title)
assert "Example Domain" in driver.title
print("Selenium berjalan dengan baik.")
finally:
driver.quit()Untuk Firefox ganti dengan webdriver.Firefox(). Untuk Edge ganti dengan webdriver.Edge().
Jalankan test
Semua OS saat environment aktif
python test_selenium.pyBrowser akan terbuka, membuka Example Domain, mencetak title, lalu menutup.
Contoh berdasarkan metode driver
Selenium Manager — rekomendasi
Python
from selenium import webdriver
driver = webdriver.Chrome() # Driver dikelola Selenium Managerwebdriver-manager via pip
Python · Chrome
from selenium import webdriver
from selenium.webdriver.chrome.service import Service
from webdriver_manager.chrome import ChromeDriverManager
driver = webdriver.Chrome(
service=Service(ChromeDriverManager().install())
)chromedriver-autoinstaller via pip — Chrome only
Python · Chrome
import chromedriver_autoinstaller
from selenium import webdriver
chromedriver_autoinstaller.install()
driver = webdriver.Chrome()Tanda instalasi berhasil
Terminal menampilkan Example Domain dan Selenium berjalan dengan baik. tanpa traceback.
5. Cara Menggunakan Hasil Generate Python Code
Setelah menekan tombol generate pada Selenium Code Generator, ikuti alur berikut.
Periksa konfigurasi generator
Pastikan Target URL, browser, timeout, dan setiap locator sudah benar.
Kosongkan Driver Path untuk memakai Selenium Manager. Isi driver path hanya pada lingkungan offline atau pengelolaan driver manual.
Generate dan unduh file Python
Klik Buat Kode Python, lalu pilih Unduh Python. File default biasanya bernama selenium_{UNIXTIME}.py; token tersebut otomatis menjadi timestamp saat diunduh.
Pindahkan file ke folder proyek
Hasil akhirnya disarankan seperti berikut:
Struktur Folder
selenium-project/
├── .venv/
├── selenium_1785763401.py
└── requirements.txtPeriksa bagian konfigurasi file
Contoh bagian awal script
TARGET_URL = "https://example.com/login"
DRIVER_PATH = ""
PAGE_LOAD_TIMEOUT = 30
WAIT_TIMEOUT = 10Pastikan TARGET_URL benar. Saat DRIVER_PATH = "", script menggunakan driver otomatis.
Ganti data contoh atau rahasia
Jangan menyimpan password asli langsung di source code untuk proyek nyata. Gunakan action Input dari Environment Variable pada generator atau akses os.environ secara manual.
Python
import os
USERNAME = os.environ["TEST_USERNAME"]
PASSWORD = os.environ["TEST_PASSWORD"]Contoh mengatur environment variable
PowerShell
$env:TEST_USERNAME = "user@example.com"
$env:TEST_PASSWORD = "your-password"macOS / Linux
export TEST_USERNAME="user@example.com"
export TEST_PASSWORD="your-password"Validasi syntax sebelum run
Semua OS
python -m py_compile selenium_1785763401.pyJika tidak ada output, syntax Python valid. File cache dapat dibuat di folder __pycache__.
6. Menjalankan Hasil Generate
Jalankan dari terminal yang berada di folder proyek dan pastikan virtual environment aktif.
Windows PowerShell
PowerShell
cd path\to\selenium-project
.\.venv\Scripts\Activate.ps1
python selenium_1785763401.pymacOS / Linux
Bash / Zsh
cd ~/selenium-project
source .venv/bin/activate
python selenium_1785763401.pyAmati browser dan terminal
Browser mengikuti skenario dari atas ke bawah. Jika assertion gagal atau element tidak ditemukan, terminal menampilkan traceback dan screenshot error dapat tersimpan sebagai selenium-error.png. Jika seluruh langkah berhasil, generator dapat menyimpan selenium-success.png.
Periksa exit code
Exit code 0 berarti script selesai tanpa exception.
Windows PowerShell
python selenium_1785763401.py
$LASTEXITCODEmacOS / Linux
python selenium_1785763401.py
echo $?Keluar dari virtual environment
Semua OS
deactivateGunakan hanya pada sistem yang Anda berhak uji
Automation harus mematuhi izin akses, kebijakan aplikasi, rate limit, privasi pengguna, dan aturan keamanan organisasi.
7. Menjalankan dalam Mode Headless atau Server
Headless menjalankan browser tanpa jendela visual. Cocok untuk server, CI/CD, cron, dan container.
Chrome / Edge
Python
options.add_argument("--headless=new")
options.add_argument("--window-size=1920,1080")Firefox
Python
options.add_argument("-headless")
options.add_argument("--width=1920")
options.add_argument("--height=1080")Mode headless tidak berarti browser boleh tidak terpasang. Browser executable tetap dibutuhkan kecuali Anda menggunakan Selenium Grid atau remote browser service.
Contoh menjalankan dari cron Linux
Gunakan path absolut untuk Python environment, script, dan log:
crontab
0 7 * * * /home/user/selenium-project/.venv/bin/python /home/user/selenium-project/selenium_1785763401.py >> /home/user/selenium-project/selenium.log 2>&18. Struktur Proyek yang Direkomendasikan
Untuk satu script sederhana, struktur minimal cukup. Untuk proyek bertumbuh, pisahkan test, page object, data, dan artefak.
Struktur Proyek
selenium-project/
├── .venv/
├── tests/
│ ├── test_login.py
│ └── test_checkout.py
├── pages/
│ ├── login_page.py
│ └── dashboard_page.py
├── screenshots/
├── reports/
├── requirements.txt
├── .gitignore
└── README.mdSimpan dependency
Semua OS
python -m pip freeze > requirements.txtInstall ulang dependency pada perangkat lain
Semua OS
python -m pip install -r requirements.txtContoh .gitignore
.gitignore
.venv/
__pycache__/
*.pyc
.env
selenium-success.png
selenium-error.png
selenium-error.html
screenshots/
reports/Pola generator yang sudah terverifikasi
Output v3.4 menggunakan locator berbasis atribut stabil, explicit wait multiline, Selenium Manager dengan fallback DRIVER_PATH, screenshot saat sukses, screenshot dan page source saat exception, serta driver.quit() pada blok finally.
9. Troubleshooting
Berikut masalah yang paling sering terjadi saat instalasi dan menjalankan Selenium.
NotOpenSSLWarning — Python macOS memakai LibreSSL
Peringatan ini berasal dari Python yang dikompilasi dengan LibreSSL lama, bukan dari locator Selenium. Gunakan Python dari installer resmi atau Homebrew, hapus virtual environment lama, lalu buat ulang.
macOS
brew install python
cd /path/to/project
rm -rf .venv
$(brew --prefix)/bin/python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip selenium
python -c "import ssl; print(ssl.OPENSSL_VERSION)"TimeoutException pada ID Angular seperti mat-input-2
ID dengan angka pada Angular Material sering dibuat dinamis. Gunakan locator yang lebih stabil seperti formcontrolname, name, data-testid, atau label.
Python
locator = (By.CSS_SELECTOR, 'input[formcontrolname="username"]')
element = WebDriverWait(driver, 30).until(
EC.element_to_be_clickable(locator)
)
element.clear()
element.send_keys("user@example.com")Jika tetap gagal, periksa iframe, URL aktif, overlay, dan simpan screenshot serta page source saat timeout.
python atau pip tidak ditemukan
Windows: coba py. macOS/Linux: coba python3. Pastikan Python terpasang dan PATH benar. Lebih aman menjalankan pip sebagai modul: python -m pip.
ModuleNotFoundError: No module named 'selenium'
Virtual environment yang digunakan saat run berbeda dari tempat Selenium di-install.
Diagnostik
python -c "import sys; print(sys.executable)"
python -m pip show seleniumUnable to obtain driver atau driver gagal diunduh
Periksa internet, proxy, firewall, sertifikat perusahaan, dan akses ke sumber download vendor. Pastikan browser benar-benar terpasang. Pada jaringan offline, unduh driver secara manual, cocokkan dengan versi browser, lalu isi DRIVER_PATH.
SessionNotCreatedException
Umumnya terjadi karena browser dan driver tidak kompatibel, binary browser tidak ditemukan, atau versi browser terlalu lama. Update browser dan Selenium, lalu coba kembali tanpa driver path manual.
Update Selenium
python -m pip install --upgrade seleniumNoSuchElementException
Locator salah, element berada di iframe, halaman belum selesai memuat, atau DOM berubah. Gunakan explicit wait dan verifikasi locator dari browser DevTools.
TimeoutException
Kondisi wait tidak terpenuhi dalam waktu yang ditentukan. Naikkan timeout secara wajar, periksa jaringan, locator, overlay, iframe, atau apakah element memang muncul.
Browser langsung tertutup
Script menggunakan driver.quit() pada blok finally. Ini perilaku yang benar untuk automation. Untuk debugging, tambahkan breakpoint, log, atau nonaktifkan opsi tutup browser dari generator sementara.
Script bekerja lokal tetapi gagal di server
Aktifkan headless, pastikan browser dan library OS tersedia, gunakan ukuran window eksplisit, cek permission folder screenshot/download, dan jangan mengandalkan path relatif dari working directory yang berbeda.
Website menggunakan iframe
Masuk ke iframe sebelum mencari element di dalamnya, lalu kembali ke default content.
Python
frame = driver.find_element(By.CSS_SELECTOR, "iframe")
driver.switch_to.frame(frame)
# Cari element di dalam iframe
driver.switch_to.default_content()10. Checklist Sebelum Menjalankan
Centang item berikut. Status tersimpan di browser lokal.
0 dari 8 selesai
Selesaikan checklist sebelum menjalankan test.
11. Referensi Resmi
Dokumentasi ini mengikuti pola instalasi dan penggunaan dari sumber resmi berikut.
- Selenium: Install a Selenium library
- Selenium Manager
- PyPI: webdriver-manager
- PyPI: chromedriver-autoinstaller
- Selenium WebDriver Documentation
- Python: venv
- Python: Installing modules
- Python Downloads
Command package manager Linux dapat berbeda menurut versi distribusi dan kebijakan repositori. Gunakan dokumentasi resmi distribusi jika nama paket tidak tersedia.