LazyUI框架中,BrowserEmulator类提供了大量的浏览器操作,常用的API列举如下:
1. 基本操作
/** * Open the URL * 打开一个URL * @param url * the target URL */ void open(String url); /** * 获取当前URL */ String getCurrentUrl(); /** * Refresh the browser * 刷新当前页面 * 包含重试和超时机制 * 不支持设置预先等待时间（通过设置pause变量） */ void refresh(); /** * Quit the browser * 退出浏览器 */ void quit(); /** * Pause * 等待XXX毫秒 * @param time in millisecond */ void pause(int time); /** * 点击浏览器原生的alert */ void clickAlert(); /** * 根据Xpath，找到控件并返回 * 有重试和超时机制 */ WebElement findElementByXpath(String xpath); /** * Get the JavascriptExecutor instance embedded in BrowserEmulator * 获取JavaScript执行器 * @return a JavascriptExecutor instance */ JavascriptExecutor getJavaScriptExecutor();
2. 窗口切换
/** * 返回当前聚焦的window的title */ String getCurrentWindowTitle(); /** * Switch window/tab * 根据title来切换浏览器的选项卡 * 如果有重名的，就不好使了 * 不包含重试和超时机制 * 不支持设置预先等待时间 * @param windowTitle * the window/tab's title * @throws Exception */ void selectWindow(String windowTitle); /** * Switch window/tab * 根据title中包含的字符串来切换浏览器的选项卡 * 如果有重名的，默认切换到找到的第一个 * 不包含重试和超时机制 * 不支持设置预先等待时间 * @param windowTitle * the window/tab's title * @throws Exception */ void selectWindowFuzzy(String windowTitleWord); /** * Switch window/tab * 切换到driver打开的唯一的window，通常关掉其他窗口后， *需要切换回原窗口（driver只剩原窗口）时使用 * @throws Exception */ void selectTheOnlyWindow();
3. frame操作
/** * Enter the iframe * 根据xpath，进入一个iframe * 包含重试和超时机制 * 不支持设置预先等待时间（通过设置pause变量） * @param xpath * the iframe's xpath */ void enterFrame(String xpath); /** * Enter frame * 根据nameOrId，进入一个iframe * 包含重试和超时机制 * 不支持设置预先等待时间（通过设置pause变量） * @param nameOrId frame's name or id */ void enterFrameByNameOrId(String nameOrId); /** * Leave the iframe * 离开当前iframe * 包含重试和超时机制 * 不支持设置预先等待时间（通过设置pause变量） */ void leaveFrame();
4. 鼠标键盘操作
/** * Hover on the page element * 根据xpath，找到一个控件，鼠标移动到控件上方 * 不支持Safari * 包含重试和超时机制 * 支持设置预先等待时间，以方便肉眼能跟上（通过设置pause变量） * @param xpath * the element's xpath */ void mouseOver(String xpath); /** * Hover on the page element * 根据多个xpath（同一个控件的不同Xpath写法，增大找到控件的几率），找到一个控件，鼠标移动到控件上方 * 不支持Safari * 包含重试和超时机制 * 支持设置预先等待时间，以方便肉眼能跟上（通过设置pause变量） * @param xpathArray * the element's xpath */ void mouseOver(String[] xpathArray); /** * Mimic system-level keyboard event * @param keyCode * 模拟按下一个键，等待100毫秒，释放该键 * 包含重试和超时机制 * 支持设置预先等待时间，以方便肉眼能跟上（通过设置pause变量） * such as KeyEvent.VK_TAB, KeyEvent.VK_F11 */ void pressKeyboard(int keyCode); /** * Mimic system-level keyboard event with String * 模拟键盘输入一段文字 * 包含重试和超时机制 * 支持设置预先等待时间，以方便肉眼能跟上（通过设置pause变量） * @param text * */ void inputKeyboard(String text);
