selenide 中文api

我就是我 2022-05-25 03:06 308阅读 0赞

## 三件简单的事情： ##

**1.** 打开页面   
**2.** $（element）.doAction（）  
**3.** $（element）.check（condition）

open("/login");
      $("#submit").click();
      $(".message").shouldHave(text("Hello"));

## 使用IDE的强大功能 ##

Selenide API由几个类组成。我们建议您停止阅读，打开IDE并开始输入。

只需键入：`$(selector).`\- IDE将向您建议所有可用的选项。

![Selenide API：刚开始输入][Selenide API]

使用今天的开发环境的力量，而不是打扰文档！

## 硒化物API ##

这是一个完整的[Selenide javadoc][]。

仅供参考，这些是您可能需要工作的Selenide类：

### com.codeborne.selenide.Selenide [\[src\] ][src][\[javadoc\]][javadoc] ###

图书馆的核心。主要方法是`open`，`$`和`$$`（进口静态com.codeborne.selenide.Selenide \*的可读性。）：

*  [open（String URL）][open_String URL]打开浏览器（如果尚未打开）并加载URL
 *  [$（String cssSelector）][String cssSelector] - 返回表示由页面上的CSS选择器找到的第一个元素的SelenideElement类的对象。
 *  [$（By）][By] - 由By类的定位器返回“第一个SelenideElement”。
 *  [$$（String cssSelector）][String cssSelector 1] - 返回ElementsCollection类型的对象，表示CSS选择器找到的所有元素的集合。
 *  [$$（By）][By 1] - 由By类型的定位器返回“元素集合”。

通常，当您通过Dollar `$`命令获取SelenideElement对象时，您可以对其执行一些操作：

*  `$(byText("Sign in")).click();`

甚至同时进行多项行动：

*  `$(byName("password")).setValue("qwerty").pressEnter();`

或者你可以检查一些条件：

*  `$(".welcome-message").shouldHave(text("Welcome, user!")).`

`$$`当需要的元素是同一类型的元素时，“Double Dollar”命令（）可能会很有用。例如，而不是：

`$(byXpath("//*[@id='search-results']//a[contains(text(),'selenide.org')]")).click();`

你可以使用更具可读性和冗长的选择：

`$$("#search-results a").findBy(text("selenide.org")).click();`

元素的大部分操作（由`$`and和`$$`commands 获取）都根据上下文内置了隐式等待。这使得在大多数情况下，通过明确处理等待加载元素的同时自动执行动态Web应用程序的测试，不会分散注意力。

不要害羞地在Selenide课堂内寻找更适合您需求的方法。只需输入您的IDE Selenide。并在可用的IDE提案中选择所需的选项。

这里只是一些例子：

[sleep（）][sleep]， [refresh（）][refresh]和 [title（）][title]，[executeJavaScript（String jsCode，Object ... arguments）][executeJavaScript_String jsCode_Object ... arguments]。

在[Selenide gitbook中][Selenide gitbook]查找更多细节。

### com.codeborne.selenide.SelenideElement [\[src\] ][src 1][\[javadoc\]][javadoc 1] ###

本`SelenideElement`类描述的页面上找到的元素。这个类的对象可以通过`$`命令来获取。在这个类中定义了以下有用的方法。

#### 内部元素搜索方法 ####

*  `find(String cssSelector)` / `$(String cssSelector)`
 *  `find(By)` / `$(By)`
 *  `findAll(String cssSelector)` / `$$(String cssSelector)`
 *  `findAll(By)` / `$$(By)`

这里`$`和`$$`只是更简洁的“别名” `find`和`findAll`方法相应。

因此，您可以逐步指定搜索路径，构建“定位链”：

$("#header").find("#menu").findAll(".item")

#### 检查元素状态的方法 - 断言 ####

*  `should(Condition)`/ `shouldBe(Condition)`/`shouldHave(Condition)`
 *  `shouldNot(Condition)`/ `shouldNotBe(Condition)`/`shouldNotHave(Condition)`

我们建议选择方便的别名，以便可以像普通的英语短语一样轻松地读取代码行，例如：

$("input").should(exist);  
    $("input").shouldBe(visible);
    $("input").shouldHave(exactText("Some text"));

断言在Selenide中扮演明确的等待角色。他们**等待**的状态（`visible`，`enabled`，`text("some text")`），以满足，直到超时达到的值（`Configuration.timeout`即默认设置为4000毫秒）。您可以明确使用“should-methods”，以便在相应操作之前等待元素的所需状态，例如：`$("#submit").shouldBe(enabled).click();`

还有一些版本的“Selenide显式等待”能够明确设置超时：

*  waitUntil（条件，毫秒）
 *  waitWhile（条件，毫秒）

#### 方法 - 对元素的操作 ####

*  `click()`
 *  `doubleClick()`
 *  `contextClick()`
 *  `hover()`
 *  `setValue(String) / val(String)`
 *  `pressEnter()`
 *  `pressEscape()`
 *  `pressTab()`
 *  `selectRadio(String value)`
 *  `selectOption(String)`
 *  `append(String)`
 *  `dragAndDropTo(String)`
 *  ...

大多数操作返回SelenideElement的对象（同一个代理元素），允许构建简洁的方法链：`$("#edit").setValue("text").pressEnter();`。

#### 获取元素状态和属性值的方法 ####

*  `getValue()` / `val()`
 *  `data()`
 *  `attr(String)`
 *  `text()` //返回“页面上的可见文本”
 *  `innerText()` //返回“DOM中元素的文本”
 *  `getSelectedOption()`
 *  `getSelectedText()`
 *  `getSelectedValue()`
 *  `isDisplayed()`//如果元素被隐藏（不可见）或元素不存在于DOM中，则返回false; 否则 - 是真的
 *  `exists()` 如果元素存在于DOM中，则返回true，否则返回false

#### 其他有用的方法 ####

*  uploadFromClasspath（String fileName）
 *  下载（）
 *  toWebElement（）
 *  uploadFile（文件...）

在[Selenide gitbook中][Selenide gitbook 1]查找更多细节

### com.codeborne.selenide.Condition [\[src\] ][src 2][\[javadoc\]][javadoc 2] ###

条件用在`should`/ `shouldNot`/ `waitUntil`/ `waitWhile`结构中。我们建议静态导入相应的条件以获得可读代码的所有优点：

*  可见/出现//例如$（“input”）。shouldBe（可见）
 *  present / exist // //在DOM中等待元素存在的条件（它仍然可以隐藏）
 *  隐藏/消失//不（可见）
 *  只读//例如$（“input”）。shouldBe（只读）
 *  名称//例如$（“input”）。shouldHave（name（“fname”））
 *  值//例如$（“input”）。shouldHave（value（“John”））
 *  键入//例如$（“＃input”）。shouldHave（type（“checkbox”））
 *  id //例如$（“＃input”）。shouldHave（id（“myForm”））
 *  空//例如$（“h2”）。shouldBe（空）
 *  属性（名称）//例如$（“＃input”）。shouldHave（attribute（“required”））
 *  属性（名称，值）//例如$（“＃list li”）。shouldHave（attribute（“class”，“active checked”））
 *  cssClass（String）//例如$（“＃list li”）。shouldHave（cssClass（“checked”））
 *  重点
 *  启用
 *  残
 *  选
 *  matchText（String regex）
 *  文本（字符串子字符串）
 *  exactText（String wholeText）
 *  textCaseSensitive（String substring）
 *  exactTextCaseSensitive（String wholeText）

在[Selenide gitbook中][Selenide gitbook 2]查找更多细节

### com.codeborne.selenide.Selectors [\[src\] ][src 3][\[javadoc\]][javadoc 3] ###

该类包含一些`By`选择器，通过文本或属性来定位元素（在标准的Selenium WebDriver API中可能会遗漏）：

*  [byText][] - 按确切文本搜索元素
 *  [withText][] - 通过包含文本搜索元素（子字符串）
 *  [by（attributeName，attributeValue）][by_attributeName_attributeValue] - 按属性的名称和值进行搜索
 *  [byTitle][] - 按属性搜索“标题”
 *  [byValue][] - 按属性搜索“值”
 *  [Xpath的][Xpath]
 *  等等

// Examples:
    $(byText("Login")).shouldBe(visible));
    $(By.xpath("//div[text()='Login']")).shouldBe(visible);  // any org.openqa.selenium.By.* selector can be used
    $(byXpath("//div[text()='Login']")).shouldBe(visible);  // or any its alternative from Selectors class

在[Selenide gitbook中][Selenide gitbook 3]查找更多细节

### com.codeborne.selenide.ElementsCollection [\[src\] ][src 4][\[javadoc\]][javadoc 4] ###

这是描述页面上由定位器找到的元素集合的类。通常可以通过该`$$`方法获取ElementsCollection类的对象。该类包含相当有用的方法。

#### 断言 ####

*  [应该][Link 1] - 例如`$$(".errors").shouldBe(empty)`
 *  [应该][Link 2] - 例如`$$("#mytable tbody tr").shouldHave(size(2))`

断言也扮演显式等待的角色。他们**等待**的状态下（例如`size(2)`，`empty`，`texts("a", "b", "c"))`来满足，直到超时达到的值（`Configuration.collectionsTimeout`即默认设置为6000毫秒）。

#### 获取元素集合的状态和属性的方法 ####

*  尺寸（）
 *  是空的（）
 *  getTexts（）//返回可见元素集合文本的数组，例如对于元素：`<li>a</li><li hidden>b</li><li>c</li>`将返回数组`["a", "", "c"]`

#### 方法 - 特定收集元素的选择器 ####

*  [filterBy（Condition）][filterBy_Condition] - 仅返回满足条件的原始集合元素（如ElementsCollection）的集合，例如`$$("#multirowTable tr").filterBy(text("Norris"))`
 *  [excludeWith（条件）][excludeWith] - 例如`$$("#multirowTable tr").excludeWith(text("Chuck"))`
 *  [get（int）][get_int] - 返回第n个元素（as `SelenideElement`）;
 *  [findBy（Condition）][findBy_Condition] - 返回`SelenideElement`满足条件的第一个集合元素（as ）。

在[Selenide gitbook中][Selenide gitbook 4]查找更多细节

### com.codeborne.selenide.CollectionCondition [\[src\] ][src 5][\[javadoc\]][javadoc 5] ###

集合条件用于类的对象的`shouldBe`/ `shouldHave`构造中`ElementsCollection`。建议静态导入所需条件以实现可读代码的所有优点。

*  `empty // e.g. $$("#list li").shouldBe(empty)`
 *  `size(int) // e.g. $$("#list li").shouldHave(size(10))`
 *  `sizeGreaterThan(int)`
 *  `sizeGreaterThanOrEqual(int)`
 *  `sizeLessThan(int)`
 *  `sizeLessThanOrEqual(int)`
 *  `sizeNotEqual(int)`
 *  `texts(String... substrings)`
 *  `exactTexts(String... wholeTexts)`

在[Selenide gitbook中][Selenide gitbook 5]查找更多细节

### com.codeborne.selenide.WebDriverRunner [\[src\] ][src 6][\[javadoc\]][javadoc 6] ###

这个类定义了一些浏览器管理方法：

*  isChrome（）
 *  isFirefox（）
 *  isHeadless（）
 *  url（） - 返回当前URL
 *  source（） - 返回当前页面的源HTML代码
 *  getWebDriver（） - 返回WebDriver实例（由Selenide自动创建或由用户设置），从而在需要时向用户提供原始API给Selenium
 *  setWebDriver（WebDriver） - 告诉Selenide使用由用户创建的驱动程序。从此时起，用户自己负责关闭驾驶员（例如通过呼叫`getWebDriver().quit()`）。

在[Selenide gitbook中][Selenide gitbook 6]查找更多细节

### com.codeborne.selenide.Configuration [\[src\] ][src 7][\[javadoc\]][javadoc 7] ###

该类包含不同的配置选项来配置基于Selenide的测试的执行，例如：

*  `timeout`\- 以毫秒为单位的等待超时，用于显式（`should`/ `shouldNot`/ `waitUntil`/ `waitWhile`）和隐式等待`SelenideElement`; 默认设置为4000毫秒; 可以针对特定测试进行更改，例如`Configuration.timeout = 6000;`
 *  `collectionsTimeout`\- 以毫秒为单位的等待超时，用于显式（`should`/ `shouldNot`/ `waitUntil`/ `waitWhile`）和隐式等待`ElementsCollection`; 默认设置为6000毫秒; 可以针对特定测试进行更改，例如`Configuration.collectionsTimeout = 8000;`
 *  `browser`（例如`"chrome"`，`"ie"`，`"firefox"`）
 *  `baseUrl`
 *  `reportsFolder`
 *  ...

[Selenide API]: /images/20220525/7dec18e8b2234479b547bb534a2de176.png
[Selenide javadoc]: http://selenide.org/javadoc/current
[src]: https://github.com/codeborne/selenide/blob/master/src/main/java/com/codeborne/selenide/Selenide.java
[javadoc]: http://selenide.org/javadoc/current/com/codeborne/selenide/Selenide.html
[open_String URL]: http://selenide.org/javadoc/current/com/codeborne/selenide/Selenide.html#open%28java.lang.String%29
[String cssSelector]: http://selenide.org/javadoc/current/com/codeborne/selenide/Selenide.html#$%28java.lang.String%29
[By]: http://selenide.org/javadoc/current/com/codeborne/selenide/Selenide.html#$%28org.openqa.selenium.By%29
[String cssSelector 1]: http://selenide.org/javadoc/current/com/codeborne/selenide/Selenide.html#$$%28java.lang.String%29
[By 1]: http://selenide.org/javadoc/current/com/codeborne/selenide/Selenide.html#$$%28org.openqa.selenium.By%29
[sleep]: http://selenide.org/javadoc/current/com/codeborne/selenide/Selenide.html#sleep%28long%29
[refresh]: http://selenide.org/javadoc/current/com/codeborne/selenide/Selenide.html#refresh%28%29
[title]: http://selenide.org/javadoc/current/com/codeborne/selenide/Selenide.html#title%28%29
[executeJavaScript_String jsCode_Object ... arguments]: http://selenide.org/javadoc/current/com/codeborne/selenide/Selenide.html#executeJavaScript%28%29
[Selenide gitbook]: https://selenide.gitbooks.io/user-guide/content/en/selenide-api/selenide.html
[src 1]: https://github.com/codeborne/selenide/blob/master/src/main/java/com/codeborne/selenide/SelenideElement.java
[javadoc 1]: http://selenide.org/javadoc/current/com/codeborne/selenide/SelenideElement.html
[Selenide gitbook 1]: https://selenide.gitbooks.io/user-guide/content/en/selenide-api/selenide-element.html
[src 2]: https://github.com/codeborne/selenide/blob/master/src/main/java/com/codeborne/selenide/Condition.java
[javadoc 2]: http://selenide.org/javadoc/current/com/codeborne/selenide/Condition.html
[Selenide gitbook 2]: https://selenide.gitbooks.io/user-guide/content/en/selenide-api/condition.html
[src 3]: https://github.com/codeborne/selenide/blob/master/src/main/java/com/codeborne/selenide/Selectors.java
[javadoc 3]: http://selenide.org/javadoc/current/com/codeborne/selenide/Selectors.html
[byText]: http://selenide.org/javadoc/current/com/codeborne/selenide/Selectors.html#byText%28java.lang.String%29
[withText]: http://selenide.org/javadoc/current/com/codeborne/selenide/Selectors.html#withText%28java.lang.String%29
[by_attributeName_attributeValue]: http://selenide.org/javadoc/current/com/codeborne/selenide/Selectors.html#by%28java.lang.String,%20java.lang.String%29
[byTitle]: http://selenide.org/javadoc/current/com/codeborne/selenide/Selectors.html#byTitle%28java.lang.String%29
[byValue]: http://selenide.org/javadoc/current/com/codeborne/selenide/Selectors.html#byValue%28java.lang.String%29
[Xpath]: http://selenide.org/javadoc/current/com/codeborne/selenide/Selectors.html#byXpath%28java.lang.String%29
[Selenide gitbook 3]: https://selenide.gitbooks.io/user-guide/content/en/selenide-api/selectors.html
[src 4]: https://github.com/codeborne/selenide/blob/master/src/main/java/com/codeborne/selenide/ElementsCollection.java
[javadoc 4]: http://selenide.org/javadoc/current/com/codeborne/selenide/ElementsCollection.html
[Link 1]: http://selenide.org/javadoc/current/com/codeborne/selenide/ElementsCollection.html#shouldBe%28com.codeborne.selenide.CollectionCondition%29
[Link 2]: http://selenide.org/javadoc/current/com/codeborne/selenide/ElementsCollection.html#shouldHave%28com.codeborne.selenide.CollectionCondition%29
[filterBy_Condition]: http://selenide.org/javadoc/current/com/codeborne/selenide/ElementsCollection.html#filterBy%28com.codeborne.selenide.Condition%29
[excludeWith]: http://selenide.org/javadoc/current/com/codeborne/selenide/ElementsCollection.html#excludeWith%28com.codeborne.selenide.Condition%29
[get_int]: http://selenide.org/javadoc/current/com/codeborne/selenide/ElementsCollection.html#get%28int%29
[findBy_Condition]: http://selenide.org/javadoc/current/com/codeborne/selenide/ElementsCollection.html#findBy%28com.codeborne.selenide.Condition%29
[Selenide gitbook 4]: https://selenide.gitbooks.io/user-guide/content/en/selenide-api/elements-collection.html
[src 5]: https://github.com/codeborne/selenide/blob/master/src/main/java/com/codeborne/selenide/CollectionCondition.java
[javadoc 5]: http://selenide.org/javadoc/current/com/codeborne/selenide/CollectionCondition.html
[Selenide gitbook 5]: https://selenide.gitbooks.io/user-guide/content/en/selenide-api/collection-condition.html
[src 6]: https://github.com/codeborne/selenide/blob/master/src/main/java/com/codeborne/selenide/WebDriverRunner.java
[javadoc 6]: http://selenide.org/javadoc/current/com/codeborne/selenide/WebDriverRunner.html
[Selenide gitbook 6]: https://selenide.gitbooks.io/user-guide/content/en/selenide-api/webdriver-runner.html
[src 7]: https://github.com/codeborne/selenide/blob/master/src/main/java/com/codeborne/selenide/Configuration.java
[javadoc 7]: http://selenide.org/javadoc/current/com/codeborne/selenide/Configuration.html