Selenium TypeError 调试指南：理解并应用现代元素定位API

剖析 TypeError：旧版API的陷阱

在使用selenium进行web自动化时，开发者可能会遇到typeerror，尤其是在尝试通过find_elements_by_css_selector等方法定位元素时。这个错误通常不是因为代码逻辑上的缺陷，而是由于selenium webdriver api的演进。在较新版本的selenium中，直接使用find_elements_by_*系列方法（例如find_element_by_id、find_elements_by_name、find_element_by_xpath、find_elements_by_css_selector等）已经被弃用。

最初的Selenium API设计允许直接通过定位策略后缀来调用方法，例如：

# 旧版写法 (已弃用)
event_times = driver.find_elements_by_css_selector(".event-widget time")
event_names = driver.find_elements_by_css_selector(".event-widget li a")

这种写法在较早的Selenium版本中是完全有效的，但在后续版本中，为了API的统一性、可读性以及对未来扩展的考虑，这些方法被标记为弃用，并最终被移除。当尝试在不支持这些方法的Selenium版本中执行时，Python解释器会抛出TypeError，指出webdriver.Chrome对象没有这样的属性或方法。

现代Selenium元素定位：By 模块的威力

为了解决上述TypeError并遵循Selenium的最新最佳实践，我们需要采用基于By模块的元素定位方式。By模块（selenium.webdriver.common.by.By）提供了一组标准化的定位器类型，使得元素定位更加清晰和灵活。

新的定位语法统一为：

• driver.find_element(By.LOCATOR_TYPE, "selector_value")：用于查找单个匹配的元素。
• driver.find_elements(By.LOCATOR_TYPE, "selector_value")：用于查找所有匹配的元素，返回一个列表。

其中，LOCATOR_TYPE是By模块中定义的常量，代表不同的定位策略。常用的定位策略包括：

• By.ID：通过元素的id属性定位。
• By.NAME：通过元素的name属性定位。
• By.CLASS_NAME：通过元素的class属性定位。
• By.TAG_NAME：通过元素的标签名定位。
• By.LINK_TEXT：通过链接的完整可见文本定位。
• By.PARTIAL_LINK_TEXT：通过链接的部分可见文本定位。
• By.XPATH：通过XPath表达式定位。
• By.CSS_SELECTOR：通过CSS选择器定位。

对于本教程中遇到的TypeError，问题在于使用了弃用的find_elements_by_css_selector。正确的做法是导入By模块，并使用By.CSS_SELECTOR作为定位类型。

AppMall应用商店

AI应用商店，提供即时交付、按需付费的人工智能应用服务

56

查看详情

代码示例：修正 TypeError

以下是原始代码和修正后的代码对比，展示了如何将旧版元素定位方法更新为现代API：

原始代码 (可能引发 TypeError)：

from selenium import webdriver
# from selenium.webdriver.common.by import By # 尽管导入了，但未使用

chrome_options = webdriver.ChromeOptions()
chrome_options.add_experimental_option("detach", True)

driver = webdriver.Chrome(options=chrome_options)
driver.get("https://www.python.org/")

# 问题所在：使用了弃用的方法
event_times = driver.find_elements_by_css_selector(".event-widget time")
event_names = driver.find_elements_by_css_selector(".event-widget li a")
events = {}

for n in range(len(event_times)):
    events[n] = {
        "time": event_times[n].text,
        "name": event_names[n].text,
    }

print(events)
driver.quit()

修正后的代码 (使用现代API)：

from selenium import webdriver
from selenium.webdriver.common.by import By # 确保导入并使用 By 模块

chrome_options = webdriver.ChromeOptions()
chrome_options.add_experimental_option("detach", True)

driver = webdriver.Chrome(options=chrome_options)
driver.get("https://www.python.org/")

# 修正：使用 driver.find_elements(By.CSS_SELECTOR, "selector")
event_times = driver.find_elements(By.CSS_SELECTOR, ".event-widget time")
event_names = driver.find_elements(By.CSS_SELECTOR, ".event-widget li a")
events = {}

for n in range(len(event_times)):
    events[n] = {
        "time": event_times[n].text,
        "name": event_names[n].text,
    }

print(events)
driver.quit()

通过将driver.find_elements_by_css_selector(".event-widget time")改为driver.find_elements(By.CSS_SELECTOR, ".event-widget time")，我们遵循了Selenium推荐的API规范，从而解决了TypeError。

最佳实践与注意事项

1. 始终导入 By 模块：在使用By.LOCATOR_TYPE进行元素定位之前，务必在脚本开头导入from selenium.webdriver.common.by import By。
2. 理解 find_element 与 find_elements 的区别：
   • find_element()：返回匹配的第一个WebElement对象。如果没有找到任何匹配项，会抛出NoSuchElementException。
   • find_elements()：返回所有匹配的WebElement对象组成的列表。如果没有找到任何匹配项，会返回一个空列表[]，而不会抛出异常。在处理可能不存在的元素集合时，检查返回列表的长度是更安全的做法。
3. 定位策略的选择：
   • ID 是最推荐的定位方式，因为它通常是唯一的且查找速度最快。
   • CSS_SELECTOR 和 XPATH 功能强大且灵活，可以定位到几乎任何元素，但复杂性也更高。
   • NAME 和 CLASS_NAME 适用于元素具有明确且稳定的这些属性的情况。
4. 异常处理：即使使用了现代API，在实际应用中仍可能遇到元素不存在的情况。为了使脚本更健壮，建议使用try-except块来捕获NoSuchElementException（当使用find_element时）或检查find_elements返回列表的长度。
5. 保持Selenium版本更新：定期更新Selenium库可以确保你使用的是最新的API和功能，并修复潜在的bug。可以使用pip install --upgrade selenium命令进行更新。
6. 查阅官方文档：Selenium的API会随着时间推移而演进。遇到不确定或报错时，查阅官方文档是获取最新和最准确信息的最佳途径。

总结

TypeError在Selenium中通常是由于使用了弃用的API方法所致。通过理解Selenium API的演进，并采纳By模块结合find_element(s)(By.LOCATOR_TYPE, "selector")的现代定位语法，开发者可以有效地解决这类问题，并编写出更稳定、更易于维护的Web自动化脚本。遵循这些最佳实践将有助于避免常见的陷阱，并提升自动化项目的效率和可靠性。

以上就是Selenium TypeError 调试指南：理解并应用现代元素定位API的详细内容，更多请关注php中文网其它相关文章！