Web自动化框架LazyUI使用手册（7）--浏览器常用操作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);