自动化测试 / 系统课时

执行 JavaScript

执行 JavaScript

execute_script() 让 Selenium 在当前选中的页面上下文里执行 JavaScript,并把结果带回 Python。它适合读取浏览器侧状态、调用页面原生 API,或处理 WebDriver 没有直接封装的细节;关键是明确脚本运行在哪个窗口或 frame、参数怎样传入,以及返回值会被转换成什么类型。

学习目标

  • 使用 driver.execute_script() 向脚本安全传入普通值和 WebElement
  • 读取字符串、数字、数组、对象和元素等返回结果
  • 判断什么时候应改用 WebDriver 原生 API,而不是把自动化逻辑都写进 JavaScript

理解脚本执行的上下文

Python 调用 driver.execute_script(script, *args) 时,脚本会在 当前选中的窗口或 frame 中执行,脚本里的 document 就是该上下文的文档。传入的额外参数按顺序出现在 JavaScript 的 arguments[0]、arguments[1] 中,因此不必把元素定位器或用户数据拼进脚本文本。

execute_script 从 Python 到页面再返回结果的数据流

例如元素位于 iframe 内时,应先 driver.switch_to.frame(...),再执行依赖该 iframe 的 document 查询;切回顶层页面则使用 driver.switch_to.default_content()。execute_script() 不会自动替你寻找正确的 frame,也不会绕过浏览器的同源安全边界。

传入元素并读取返回值

下面的完整示例创建一个自包含页面,把按钮对应的 WebElement 和增量值传给 JavaScript。脚本修改元素文本后返回页面标题与新数值,Python 再读取返回对象验证结果。

python
from urllib.parse import quote

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

html = '''
<!doctype html>
<title>Script Demo</title>
<button id="counter">2</button>
'''

driver = webdriver.Chrome()
try:
    driver.get("data:text/html;charset=utf-8," + quote(html))
    counter = driver.find_element(By.ID, "counter")

    # WebElement 和普通整数会依次映射到 arguments[0]、arguments[1]。
    result = driver.execute_script(
        '''
        const element = arguments[0];
        const nextValue = Number(element.textContent) + arguments[1];
        element.textContent = String(nextValue);
        return {title: document.title, value: nextValue};
        ''',
        counter,
        5,
    )

    # 同时检查返回值与页面实际状态,避免只验证脚本自身计算结果。
    print(result["title"])
    print(result["value"])
    print(counter.text)
finally:
    driver.quit()

预期输出

text
Script Demo
7
7

这里直接传 WebElement 比在脚本中重新写 document.querySelector(...) 更稳妥:定位职责仍由 Selenium 负责,JavaScript 只处理确实需要浏览器上下文完成的逻辑。

处理返回类型和边界

返回值应尽量保持为可序列化的简单结构。常用映射可以按下表检查;如果脚本没有 return,Python 侧通常得到 None。

JavaScript 返回值 Python 常见结果 推荐用途
null 或 undefined None 只产生页面副作用
true、数字、字符串 bool、数值、str 读取状态或计算结果
数组 list 一次返回多项顺序数据
普通对象 dict 返回带名称的多字段结果
DOM 元素 WebElement 从页面脚本定位到单个元素

不要返回 window、函数、循环引用对象等复杂值;这类对象无法稳定跨 WebDriver 协议边界传输。需要等待定时器、回调或其他异步完成条件时,应单独评估 execute_async_script(),而不是在同步脚本里用固定休眠伪装等待。

把 JavaScript 留给原生 API 缺口

可先用一个简单顺序判断:能用 find_element()、click()、get_attribute()、窗口切换或 Actions API 完成的操作,优先使用 WebDriver 原生能力;只有读取浏览器侧特殊状态、调用页面原生方法或做针对性诊断时,再引入 execute_script()。

例如读取 document.title 并不需要脚本,因为已有 driver.title;把正常元素点击全部改成 arguments[0].click() 也会绕过 WebDriver 的可交互性检查。保留这条边界后,脚本既能补足 API 缺口,又不会把端到端测试悄悄变成只验证 DOM 的测试。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

执行 JavaScript

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通