浏览器操作综合作业

# 点上方任意开关 → 这里立即显示完整 Python 启动脚本
# 默认：Chrome + 启动最大化 + 禁用自动化提示（推荐基础配置）

from selenium import webdriver
from selenium.webdriver.chrome.options import Options

options = Options()
options.add_argument("--start-maximized")
options.add_experimental_option("excludeSwitches", ["enable-automation"])
options.add_experimental_option("useAutomationExtension", False)

driver = webdriver.Chrome(options=options)
driver.get("https://www.example.com")
print("标题：", driver.title)
driver.quit()

from selenium import webdriver

driver = webdriver.Chrome()

# ① 打开页面
driver.get("https://www.example.com")
print(driver.title)

# ② 新开标签（JS 方式，最常用）
driver.execute_script("window.open('https://www.baidu.com');")

# ③ 切换到新标签
handles = driver.window_handles
driver.switch_to.window(handles[-1])
print(driver.current_url)     # → 百度

# ④ 切回原来的标签
driver.switch_to.window(handles[0])

# ⑤ 关闭当前标签（如果只剩一个，driver.close() 之后 driver 会失效！）
driver.close()

# ⑥ 退出整个浏览器（关所有标签 + 杀 chromedriver）
driver.quit()

# ⚠️ close() 只关当前 tab；quit() 全关
# ⚠️ 脚本结束必须调 quit()，否则 chromedriver 残留进程！

"""
历史导航三部曲 —— 完整示例
"""
from selenium import webdriver

driver = webdriver.Chrome()
driver.implicitly_wait(1)

# ===== 构建 history stack =====
driver.get("https://www.page-a.com")     # stack: [A]         cursor → A
driver.get("https://www.page-b.com")     # stack: [A, B]      cursor → B
driver.get("https://www.page-c.com")     # stack: [A, B, C]   cursor → C

# ===== back() / forward() =====
driver.back()                            # cursor → B, 显示 page-b
driver.back()                            # cursor → A, 显示 page-a
driver.back()                            # ⚠️ 到顶了！不会报错，静默 no-op
print(driver.current_url)                # → 还是 page-a

driver.forward()                         # cursor → B
driver.forward()                         # cursor → C
driver.forward()                         # ⚠️ 到底了！也不会报错

# ===== refresh() =====
driver.refresh()
# 等价于：在当前页重新发送一次请求（浏览器的 F5）
# ⚠️ 不等价于 driver.get(driver.current_url)
#    refresh() 会带上 cache-control / 表单重提交提示
#    get() 就是一次全新的导航

# ===== get() 会截断 forward 队列 =====
driver.back()                            # cursor → B
driver.get("https://www.page-d.com")     # stack 变成 [A, B, D] ← C 被砍掉！
# 此时再 forward() 不会回到 C 了 —— 它已经被 purge 掉

driver.quit()

"""
窗口控制完整示例
- maximize/minimize 直接调 driver 方法
- size/position/rect 需要 Options 或 driver 方法
"""
from selenium import webdriver

driver = webdriver.Chrome()

# ===== 方式 1：快捷方法 =====
driver.maximize_window()               # 一键最大化到屏幕
driver.minimize_window()               # 最小化到任务栏（Selenium 4）
driver.fullscreen_window()             # 全屏（F11 效果，Chrome 支持）

# ===== 方式 2：精确控制 =====
driver.set_window_size(1200, 800)      # 宽 × 高
driver.set_window_position(100, 100)   # 左上角 x, y
# ⚠️ 上面两次调用 → 可能有闪烁（独立动作）

# ===== 方式 3：set_window_rect（推荐 Selenium 4 用法）=====
driver.set_window_rect(x=900, y=300, width=600, height=500)
# 原子操作！位置和尺寸同时生效，无闪烁

# ===== 读取当前窗口信息 =====
size = driver.get_window_size()        # {'width': 1920, 'height': 1080}
pos  = driver.get_window_position()    # {'x': 0, 'y': 0}
rect = driver.get_window_rect()        # {'x': 0, 'y': 0, 'width': 1920, 'height': 1080}
# 💡 Selenium 4 推荐统一用 get_window_rect()，包含所有字段

# ===== 居中窗口实战 =====
screen_w = driver.execute_script("return window.screen.width")
screen_h = driver.execute_script("return window.screen.height")
win_w, win_h = 1200, 800
x = (screen_w - win_w) // 2
y = (screen_h - win_h) // 2
driver.set_window_rect(x, y, win_w, win_h)

driver.quit()

# 页面信息获取 + Selenium 4 新方法
print("标题：",  driver.title)
print("URL：",   driver.current_url)
print("源码长度：", len(driver.page_source))
print("所有标签：", driver.window_handles)
print("当前句柄：", driver.current_window_handle)
print("Session：", driver.session_id)

# Selenium 4 新写法
driver.print_page_source("page.html")   # 一行保存源码到文件
logs = driver.get_log("browser")        # 读取浏览器控制台日志

# ✅ 实战：一次性打包成 JSON 输出
import json
info = {
    "title": driver.title,
    "url": driver.current_url,
    "source_len": len(driver.page_source),
    "handles": driver.window_handles,
    "session": driver.session_id,
}

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

el = driver.find_element(By.ID, "searchInput")

# === 三件套 ===
el.click()                              # 聚焦并点击
el.send_keys("Python")                  # 输入（追加！）
el.send_keys(Keys.CONTROL, "a")         # 全选
el.send_keys("新内容")                   # 替换（先全选再输入）
el.clear()                              # 清空

# === 状态 / 属性查询 ===
print(el.is_displayed())                # 是否在页面可见
print(el.is_enabled())                  # 是否可交互（非 disabled）
print(el.get_attribute("value"))        # 读 value 属性
print(el.get_attribute("placeholder"))  # 读 placeholder
print(el.tag_name)                      # 标签名 "input"
print(el.text)                          # 可见文本（input 元素通常为空）

# ⚠️ send_keys 是追加！输入前通常先 clear()
# ✅ 最佳实践：el.clear(); el.send_keys("新内容")

# submit() 等价于点击表单里的提交按钮
# el.submit()  # 按 Enter 提交

# Cookie 增删改查全套
# ⚠️ 注意：add_cookie 前 driver 必须先 get() 到目标域名

# ① 添加 —— 完整 dict 字段
driver.add_cookie({
    "name": "token",
    "value": "abc123",
    "path": "/",
    "domain": ".example.com",
    "expiry": 1735689600,          # Unix 时间戳，过期时间
    "secure": True,               # 仅 HTTPS 发送
    "httpOnly": False             # 禁止 JS 读取（防 XSS）
})

# ② 读取
all_cookies = driver.get_cookies()           # list[dict]
print(f"共 {len(all_cookies)} 条 Cookie")
for c in all_cookies:
    print(c["name"], "=", c["value"], "| domain:", c.get("domain"))

token = driver.get_cookie("token")           # dict 或 None
if token:
    print("token 存在:", token["value"])
else:
    print("token 不存在")

# ③ 删除
driver.delete_cookie("token")                # 删一条
driver.delete_all_cookies()                  # 全删

# ✅ 登录状态保持实战：Cookie → JSON → 重新注入
import json, os
COOKIE_FILE = "cookies.json"

# 登录后保存
cookies = driver.get_cookies()
with open(COOKIE_FILE, "w") as f:
    json.dump(cookies, f, indent=2)

# 下次启动新浏览器 → 跳过登录
driver.get("https://www.example.com")        # ⚠️ 必须先 visit 域名
with open(COOKIE_FILE, "r") as f:
    saved = json.load(f)
for c in saved:
    driver.add_cookie(c)                     # 逐条还原
driver.refresh()                             # Cookie 生效，已登录

# 截图 4 种方式
driver.save_screenshot("page.png")          # 方式 1：最常用
driver.get_screenshot_as_file("page.png")   # 方式 2：等价写法
b64 = driver.get_screenshot_as_base64()     # 方式 3：返回 base64 字符串（邮件/API 上传）
png = driver.get_screenshot_as_png()        # 方式 4：返回 PNG bytes

# 元素级截图（Selenium 4）
el = driver.find_element(By.ID, "demoInput")
el.save_screenshot("element.png")

# ✅ 最佳实践：截图 + 时间戳命名
import os, time
name = f"fail_{int(time.time())}.png"
driver.save_screenshot(os.path.join("screenshots", name))

# ===== 三种等待方式对比 =====

# ❌ 方式 1：强制等待 —— 写死时间，页面快了浪费、慢了不够
import time
time.sleep(2)

# ⚠️ 方式 2：隐式等待 —— 全局生效，元素出现就返回，最长等 10 秒
driver.implicitly_wait(10)
# 之后所有 find_element 都自动应用
# 缺点：① 全局影响难控制 ② 不擅长等 URL / 标题 / 元素消失

# ✅ 方式 3：显式等待 —— 最灵活、最推荐
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
from selenium.webdriver.common.by import By

wait = WebDriverWait(driver, 10)   # 最多等 10 秒
el = wait.until(EC.presence_of_element_located((By.ID, "demoInput")))
el.click()

# 常用 EC 条件
# EC.presence_of_element_located     元素在 DOM 中
# EC.visibility_of_element_located   元素可见（宽高>0）
# EC.element_to_be_clickable         元素可点击
# EC.url_contains("xxx")             URL 包含
# EC.title_contains("xxx")           标题包含
# EC.alert_is_present()              出现弹窗
# EC.invisibility_of_element_located 元素消失

# ⚠️ 三种超时配置
driver.set_page_load_timeout(30)    # 页面加载超时
driver.set_script_timeout(20)       # JS 执行超时
driver.implicitly_wait(10)          # 隐式等待