Controller
WebView自动化控制器接口(异步版)。
提供了一套全面的API,用于以异步、非阻塞的方式与WebView中的网页内容进行交互。 所有方法都会立即返回一个 Deferred 对象,代表一个未来的计算结果。 你可以通过 .getOrigin().await() 等待结果,或在协程作用域中直接 await()。
⚠️ 注意: 此接口中的所有方法都是非阻塞的,可以安全地在任何线程中调用。 框架内部会自动将耗时操作(如JS评估)切换到后台线程,并将结果调度回脚本线程。
Functions
异步导航到浏览历史中的上一页。
异步处理文件选择。会先执行 action(例如点击上传按钮),然后等待WebView弹出文件选择器, 并使用 fileChooser 的返回结果来响应。
异步清空 LocalStorage 中的所有数据。
异步清空 SessionStorage 中的所有数据。
异步模拟在指定元素上进行右键点击。
异步删除当前网页下的所有 Cookie。
异步删除指定名称的 Cookie。
异步模拟双击指定元素。
异步处理文件下载。会先执行 action(例如点击下载链接),然后等待WebView触发下载请求, 并将文件保存到 fileDownloader 指定的位置。
异步模拟将一个元素拖拽到另一个元素上。
异步加载并执行网络中的JavaScript文件。
异步执行本地存储的JavaScript文件。
异步在当前上下文中执行一段自定义的JavaScript脚本。
异步导航到浏览历史中的下一页。
异步获取当前网页下所有 Cookie。
异步获取由XPath指定的元素的某个HTML属性值 (Attribute)。
异步获取由XPath指定的元素的计算后CSS样式属性值。
异步获取当前WebView加载的URL。
异步获取所有匹配XPath的元素的数量。
异步从 LocalStorage 中获取指定键的值。
异步获取当前页面的完整HTML源代码。
异步获取由XPath指定的元素的某个 DOM 属性值 (Property)。
异步从 SessionStorage 中获取指定键的值。
异步获取当前页面的标题。
异步检查由XPath指定的元素是否在页面上可见。
异步检查表单元素是否被选中。
异步将给定的HTML字符串加载到此WebView中,并允许您指定一个基础URL。
异步导航到指定的网址。
异步刷新当前页面。
异步从 LocalStorage 中移除指定键。
异步从 SessionStorage 中移除指定键。
异步将指定的元素滚动到可视区域内。
异步根据value属性选择<select>下拉列表中的选项。
异步根据可见文本内容选择<select>下拉列表中的选项。
异步在 LocalStorage 中设置键值对。
异步在 SessionStorage 中设置键值对。
异步切换回主文档上下文。
异步切换到指定的iframe中。要切换到嵌套的iframe,请多次调用此方法。
异步截取由XPath指定的单个元素的图像。
异步获取WebView可视区域的截图。
异步等待由XPath指定的元素出现在DOM中,直到超时。
异步等待由XPath指定的元素变得可见,直到超时。