PowerShell搭配Selenium 4如何正确定位页面元素

核心原因 #

Selenium 4 已移除FindElementById、FindElementByClassName等直接定位的快捷方法，统一使用FindElement配合OpenQA.Selenium.By类的静态定位器实现元素查找。PowerShell 环境下无法直接使用Java风格的By.id()写法，需要指定完整的类命名空间调用静态方法。

正确写法示例 #

基础定位写法 #

你原来的ID定位代码修改如下即可正常运行：

$driver.FindElement([OpenQA.Selenium.By]::Id("username"))

常见定位规则对应写法 #

• ID定位：[OpenQA.Selenium.By]::Id("元素ID属性值")
• 类名定位：[OpenQA.Selenium.By]::ClassName("元素class属性值")
• XPath定位：[OpenQA.Selenium.By]::XPath("XPath查询表达式")
• CSS选择器定位：[OpenQA.Selenium.By]::CssSelector("CSS选择器表达式")
• Name属性定位：[OpenQA.Selenium.By]::Name("元素name属性值")
• 完整链接文本定位：[OpenQA.Selenium.By]::LinkText("a标签的完整文本内容")
• 部分链接文本定位：[OpenQA.Selenium.By]::PartialLinkText("a标签的部分文本内容")

简化写法优化 #

如果觉得每次写全命名空间过于繁琐，可以预先给By类定义别名，后续直接用别名调用即可：

# 预先定义别名
$By = [OpenQA.Selenium.By]
# 后续定位可简化为
$driver.FindElement($By::Id("username"))
$driver.FindElement($By::XPath('//input[@type="password"]'))

多元素查找 #

如果需要匹配符合规则的所有元素，改用FindElements方法即可，返回对应元素的数组：

# 获取所有class为list-item的元素
$itemList = $driver.FindElements([OpenQA.Selenium.By]::ClassName("list-item"))

完整运行示例 #

$url = "https://<webpage.com>"
$options = New-Object OpenQA.Selenium.Chrome.ChromeOptions
$options.AddArgument("--disable-gpu")
$driver = New-Object OpenQA.Selenium.Chrome.ChromeDriver($options)
$driver.Navigate().GoToURL($url)

# 定位用户名输入框并输入内容
$usernameInput = $driver.FindElement([OpenQA.Selenium.By]::Id("username"))
$usernameInput.SendKeys("test_account")

内容的提问来源于stack exchange，提问作者StackExchangeGuy