Selenium Basics Explained in Plain Simple Language

Selenium in one sentence:
Selenium is a tool that lets your code act like a user
in a web browser.

What it can do:
- Open a page
- Click buttons and links
- Type into input fields
- Read text from the page
- Check if something is visible

What it is not:
- It is not a browser
- It is not a testing framework by itself
- It does not replace manual thinking

Think of Selenium like a robot user:
- You give it instructions: "Open this page"
- It opens the page
- You say: "Find the username box"
- It finds it
- You say: "Type 'student'"
- It types it
- You say: "Click Login"
- It clicks

Selenium follows your instructions.
You still decide what to test and why.

Selenium WebDriver:
- The most important part
- You write code in Python, Java, C#, etc.
- The code tells the browser what to do

Selenium IDE:
- A record-and-playback tool
- Good for beginners
- Not enough for serious projects

Selenium Grid:
- Runs the same test on many browsers
- Saves time in large projects
- Useful for cross-browser testing

Simple flow:
Your code
   ↓
Selenium WebDriver
   ↓
Browser driver (ChromeDriver, GeckoDriver, etc.)
   ↓
Real browser (Chrome, Firefox, Edge)

The browser driver is the bridge.
If the browser and driver versions do not match,
your script may fail before it even starts.

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

# Start the browser
driver = webdriver.Chrome()

# Open a page
driver.get("https://example.com")

# Find the heading
heading = driver.find_element(By.TAG_NAME, "h1")

# Read and print its text
print(heading.text)

# Close the browser
driver.quit()

from selenium import webdriver
→ Brings in the tool that controls the browser

from selenium.webdriver.common.by import By
→ Brings in the locator helpers (ID, CSS, XPath, etc.)

driver = webdriver.Chrome()
→ Starts a Chrome browser

driver.get("https://example.com")
→ Opens the given URL

driver.find_element(By.TAG_NAME, "h1")
→ Finds the first h1 element on the page

heading.text
→ Reads the visible text inside that element

driver.quit()
→ Closes the browser and ends the session

Common locators in Selenium:
- By.ID                 → best when the element has a unique id
- By.NAME               → useful for form fields
- By.CLASS_NAME         → finds elements by class
- By.CSS_SELECTOR       → flexible and fast
- By.XPATH              → powerful, but can be brittle
- By.LINK_TEXT          → for links by visible text
- By.TAG_NAME           → for simple tags like h1, p

from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
from selenium.webdriver.common.by import By

# Wait up to 10 seconds until the button is clickable
button = WebDriverWait(driver, 10).until(
    EC.element_to_be_clickable((By.ID, "login-btn"))
)

button.click()