aardio 文档

dotNet.seleniumBasic 库模块帮助文档

说明

只是调用 ChromeDriver 在 aardio 里用 chrome.driver 更简单一些。 aardio 实际不需要任何第三方组件即可调用 ChromeDriver，这是因为 aardio 可以 自动将任意 Web 接口转换为 aardio 对象，所以实现 WebDriver 协议只需要极少的代码。

dotNet.seleniumBasic 基于开源的 SeleniumBasic， 但不再需要注册 COM 控件，不再需要带一堆 DLL，可以生成绿色独立的 EXE 文件。 支持自动检测并配置运行环境，如果没有 .Net 4.x 则自动安装，如果没有 Chrome 则自动安装, 自动匹配 Chrome 版本下载合适的 ChromeDriver 版本，自动配置所有路径参数。

https://github.com/florentbr/SeleniumBasic https://www.cnblogs.com/ryueifu-VBA/p/13661378.html

可以用 ILSpy 查看 SeleniumBasic.dll 的源代码 ILSpy 下载： https://github.com/icsharpcode/ILSpy SeleniumBasic.dll 使用 aardio 中的程序集合并工具生成。 在 aardio 扩展库管理器中双击 dotNet.merge 可以打开此工具源代码。

dotNet.seleniumBasic 成员列表

SeleniumBasic 浏览器自动化工具,
不需要注册 COM 控件，不需要带一堆 DLL，可以生成绿色独立的 EXE 文件。
自动检测并配置运行环境，如果没有 .Net 4.x 则自动安装，如果没有 Chrome 则自动安装,
自动匹配 Chrome 版本下载合适的 ChromeDriver 版本，自动配置所有路径参数

导入此扩展库自动导入全局名字空间 SeleniumBasic

dotNet.seleniumBasic.CreateDefaultChromeService()

创建并返回默认
SeleniumBasic.ChromeDriverService,SeleniumBasic.ChromeOptions
注意函数会返回2个值

如果返回2个值表示已经成功找到或自动安装 Chrome 与 ChromeDriver,
Chrome 与 ChromeDriver 路径这些已经指定,不用再修改,
不指定参数@1为 true,默认排除 enable-logging 参数并隐藏控制台,
失败返回 null

dotNet.seleniumBasic.CreateDefaultWebDriver

建议直接用这个函数创建 WebDriver 客户端
代码量少，自动兼容系统安装的 Chrome 或 Edge Chromium
没有安装会自动安装

dotNet.seleniumBasic.CreateDefaultWebDriver()

返回对象:dotNetSeleniumBasicIWebDriverObject

dotNet.seleniumBasic.CreateDefaultWebDriver(chromeService,ChromeOption)

不需要指定参数,
调用 dotNet.seleniumBasic.CreateDefaultChromeService 的返回值也可作为此函数参数

dotNet.seleniumBasic.IWebDriver()

创建 WebDriver 客户端

返回对象:dotNetSeleniumBasicIWebDriverObject

SeleniumBasic 成员列表

SeleniumBasic.CreateDefaultChromeService()

创建并返回默认
SeleniumBasic.ChromeDriverService,SeleniumBasic.ChromeOptions
注意函数会返回2个值

如果返回2个值表示已经成功找到或自动安装 Chrome 与 ChromeDriver,
Chrome 与 ChromeDriver 路径这些已经指定,不用再修改,
不指定参数@1为 true,默认排除 enable-logging 参数并隐藏控制台,
失败返回 null

SeleniumBasic.CreateDefaultWebDriver

建议直接用这个函数创建 WebDriver 客户端
代码量少，自动兼容系统安装的 Chrome 或 Edge Chromium
没有安装会自动安装

SeleniumBasic.CreateDefaultWebDriver()

返回对象:dotNetSeleniumBasicIWebDriverObject

SeleniumBasic.CreateDefaultWebDriver(chromeService,ChromeOption)

不需要指定参数,
调用 dotNet.seleniumBasic.CreateDefaultChromeService 的返回值也可作为此函数参数

SeleniumBasic.IWebDriver()

创建 WebDriver 客户端

返回对象:dotNetSeleniumBasicIWebDriverObject

dotNetSeleniumBasicEleObject 成员列表

dotNetSeleniumBasicEleObject.Clear()

清空

dotNetSeleniumBasicEleObject.Click()

点击

dotNetSeleniumBasicEleObject.DeselectAll()

取消选择所有节点

dotNetSeleniumBasicEleObject.DeselectByIndex(index)

根据参数@1指定的索引取消选择节点

dotNetSeleniumBasicEleObject.DeselectByText(Text)

根据参数@1指定的文本取消选择节点

dotNetSeleniumBasicEleObject.DeselectByValue(Value)

根据参数@1指定的 value 值取消选择节点

dotNetSeleniumBasicEleObject.Displayed

是否显示

dotNetSeleniumBasicEleObject.Enabled

是否可用

dotNetSeleniumBasicEleObject.FindElementByClassName()

根据参数@1指定的类名查找节点

返回对象:dotNetSeleniumBasicEleObject

dotNetSeleniumBasicEleObject.FindElementByCssSelector()

根据参数@1指定的CSS选择器查找节点

返回对象:dotNetSeleniumBasicEleObject

dotNetSeleniumBasicEleObject.FindElementById()

根据参数@1指定的ID查找节点

返回对象:dotNetSeleniumBasicEleObject

dotNetSeleniumBasicEleObject.FindElementByLinkText()

根据参数@1指定的链接文本查找节点

返回对象:dotNetSeleniumBasicEleObject

dotNetSeleniumBasicEleObject.FindElementByName()

根据参数@1指定的 name 属性查找节点

返回对象:dotNetSeleniumBasicEleObject

dotNetSeleniumBasicEleObject.FindElementByPartialLinkText()

根据参数@1指定的部分链接文本查找节点

返回对象:dotNetSeleniumBasicEleObject

dotNetSeleniumBasicEleObject.FindElementByTagName()

根据参数@1指定的标签名查找节点

返回对象:dotNetSeleniumBasicEleObject

dotNetSeleniumBasicEleObject.FindElementByXPath()

根据参数@1指定的XPath查找节点

返回对象:dotNetSeleniumBasicEleObject

dotNetSeleniumBasicEleObject.FindElementsByClassName()

根据参数@1指定的类名查找多个节点

dotNetSeleniumBasicEleObject.FindElementsByCssSelector()

根据参数@1指定的CSS选择器查找多个节点

dotNetSeleniumBasicEleObject.FindElementsById(id)

根据参数@1指定的ID查找多个节点

dotNetSeleniumBasicEleObject.FindElementsByLinkText(linkText)

根据参数@1指定的链接文本查找多个节点

dotNetSeleniumBasicEleObject.FindElementsByName(Name)

根据参数@1指定的 name 属性查找多个节点

dotNetSeleniumBasicEleObject.FindElementsByPartialLinkText(partialLinkText)

根据参数@1指定的部分链接文本查找多个节点

dotNetSeleniumBasicEleObject.FindElementsByTagName(tagName)

根据参数@1指定的标签名查找多个节点

dotNetSeleniumBasicEleObject.FindElementsByXPath(xpath)

根据参数@1指定的XPath查找多个节点

dotNetSeleniumBasicEleObject.IsMultiple

是否为支持多选的下拉框

dotNetSeleniumBasicEleObject.SelectByIndex()

根据参数@1指定的索引选择节点

dotNetSeleniumBasicEleObject.SelectByText(Text,partialMatch)

根据参数@1指定的文本选择节点,
可选用参数@2指定是否使用部分匹配

dotNetSeleniumBasicEleObject.SelectByValue()

根据参数@1指定的 value 值选择节点

dotNetSeleniumBasicEleObject.Selected

是否处于勾选状态

dotNetSeleniumBasicEleObject.SendKeys()

发送参数 @1 指定的字符串

dotNetSeleniumBasicEleObject.Size

返回元素的尺寸

dotNetSeleniumBasicEleObject.Submit()

提交

dotNetSeleniumBasicEleObject.Text

返回元素的内部文本（InnerText）

dotNetSeleniumBasicEleObject.tagName

返回元素的标签名称

dotNetSeleniumBasicIWebDriverObject 成员列表

dotNetSeleniumBasicIWebDriverObject.CreateWaiter()

创建等待工具,
参数 @1 指定超时，以秒为单位，参数不省略

返回对象:dotNetSeleniumBasicWaiterObject

dotNetSeleniumBasicIWebDriverObject.FindElementByClassName()

根据参数 @1 指定的类名查找节点

返回对象:dotNetSeleniumBasicEleObject

dotNetSeleniumBasicIWebDriverObject.FindElementByCssSelector()

根据参数@1指定的CSS选择器查找节点

返回对象:dotNetSeleniumBasicEleObject

dotNetSeleniumBasicIWebDriverObject.FindElementById()

根据参数@1指定的ID查找节点

返回对象:dotNetSeleniumBasicEleObject

dotNetSeleniumBasicIWebDriverObject.FindElementByLinkText()

根据参数@1指定的链接文本查找节点

返回对象:dotNetSeleniumBasicEleObject

dotNetSeleniumBasicIWebDriverObject.FindElementByName()

根据参数@1指定的 name 属性查找节点

返回对象:dotNetSeleniumBasicEleObject

dotNetSeleniumBasicIWebDriverObject.FindElementByPartialLinkText()

根据参数@1指定的部分链接文本查找节点

返回对象:dotNetSeleniumBasicEleObject

dotNetSeleniumBasicIWebDriverObject.FindElementByTagName()

根据参数@1指定的标签名查找节点

返回对象:dotNetSeleniumBasicEleObject

dotNetSeleniumBasicIWebDriverObject.FindElementByXPath()

根据参数@1指定的XPath查找节点

返回对象:dotNetSeleniumBasicEleObject

dotNetSeleniumBasicIWebDriverObject.FindElementsByClassName()

根据参数@1指定的类名查找多个节点

dotNetSeleniumBasicIWebDriverObject.FindElementsByCssSelector()

根据参数@1指定的CSS选择器查找多个节点

dotNetSeleniumBasicIWebDriverObject.FindElementsById(id)

根据参数@1指定的ID查找多个节点

dotNetSeleniumBasicIWebDriverObject.FindElementsByLinkText(linkText)

根据参数@1指定的链接文本查找多个节点

dotNetSeleniumBasicIWebDriverObject.FindElementsByName(Name)

根据参数@1指定的 name 属性查找多个节点

dotNetSeleniumBasicIWebDriverObject.FindElementsByPartialLinkText(partialLinkText)

根据参数@1指定的部分链接文本查找多个节点

dotNetSeleniumBasicIWebDriverObject.FindElementsByTagName(tagName)

根据参数@1指定的标签名查找多个节点

dotNetSeleniumBasicIWebDriverObject.FindElementsByXPath(xpath)

根据参数@1指定的XPath查找多个节点

dotNetSeleniumBasicIWebDriverObject.New_ChromeDriver()

启动 ChromeDriver 客户端

dotNetSeleniumBasicIWebDriverObject.New_ChromeDriver(chromeService,ChromeOption)

请使用 dotNet.seleniumBasic.CreateDefaultChromeService 函数
的返回值作为参数即可

dotNetSeleniumBasicWaiterObject 成员列表

dotNetSeleniumBasicWaiterObject.Until

等待并返回符合条件的节点

dotNetSeleniumBasicWaiterObject.Until()

返回对象:dotNetSeleniumBasicEleObject

dotNetSeleniumBasicWaiterObject.Until(attributeName,attributeValue)

等待指定节点
@attributeName 参数指定要等待的属性名,
@attributeValue 参数指定要等待的属性值,
参数都是字符串，不可省略

Markdown 格式