浏览器 (Geb 7.0 的 Groovy API 文档)

geb.Browser

```
class Browser
extends Object
```
浏览器是 Geb 的核心。它封装了一个 WebDriver 实现，并引用了一个提供内容访问的 Page 对象。
浏览器对象通过 propertyMissing ( ) 和 methodMissing ( ) 动态地将其未实现的所有方法调用和属性读/写委托给当前页面实例。

字段摘要

字段
修饰符	名称	描述
`static String`	`CLOSE_OPTION`
`protected static String`	`HAS_NETWORK_CONDITIONS_CLASS_NAME`
`static String`	`QUERY_STRING_SEPARATOR`
`static String`	`UTF8`

属性摘要

属性
类型	名称和描述
`WebDriver`	`augmentedDriver` 如果驱动程序是远程的，此对象允许访问其功能（Geb 用户不应访问此对象，它在内部使用）。
`String`	`baseUrl`
`WebDriver`	`driver`

构造函数摘要

构造函数
构造函数和描述
`Browser()` 使用默认配置加载器创建一个新的浏览器，加载默认配置文件。
`Browser(Configuration config)` 使用给定配置创建一个新的浏览器。
`Browser(Map props, Configuration config)` 使用给定配置创建一个新的浏览器实例，然后将 `props` 应用为浏览器上的属性覆盖。

方法摘要

方法
类型参数	返回类型	名称和描述
`<T extends Page>`	`T`	`at(Class<T> pageType)` 通过为此页面类型运行 at 检查器来检查浏览器是否在当前页面上
`<T extends Page, R>`	`R`	`at(Class<T> pageType, Closure<R> assertions)` 通过使用 `at(pageType)` 运行 at 检查器来检查浏览器是否在当前页面上。
`<T extends Page>`	`T`	`at(T page)` 通过为此页面实例运行 at 检查器来检查浏览器是否在当前页面上
`<T extends Page, R>`	`R`	`at(T page, Closure<R> assertions)` 通过使用 `at(page)` 运行 at 检查器来检查浏览器是否在当前页面上。
	`void`	`checkIfAtAnUnexpectedPage(Class<? extends Page>[] expectedPages)` 检查是否在配置为意外的页面之一。
	`void`	`checkIfAtAnUnexpectedPage(Page[] expectedPages)` 检查是否在配置为意外的页面之一。
	`void`	`cleanReportGroupDir()` 如果 getReportGroupDir() 返回的目录存在，则从文件系统中删除它。
	`void`	`clearCookies(String[] additionalUrls)` 通过将浏览器导航到作为此方法参数传入的每个 URL 并清除其 Cookie，清除当前域和多个附加域的 Cookie。
	`void`	`clearCookies()` 清除浏览器拥有的当前域的所有 Cookie。
	`void`	`clearCookiesQuietly()` 清除浏览器当前拥有的所有 Cookie，抑制任何 webdriver 异常。
	`void`	`clearWebStorage()` 清除 Web 存储，即当前域的本地存储和会话存储。
	`void`	`clearWebStorageQuietly()` 清除 Web 存储，即当前域的本地存储和会话存储，抑制任何 webdriver 异常。
	`void`	`close()` 关闭当前驱动程序窗口。
	`protected NavigatorFactory`	`createNavigatorFactory()` 首次请求时，调用此方法创建导航器工厂。
`<T extends Page>`	`T`	`createPage(Class<T> pageType)` 创建给定页面类型的新实例并初始化它。
`<T>`	`protected T`	`doWithWindow(Map options, Closure<T> block)`
	`static Browser`	`drive(Closure script)` 通过默认构造函数创建一个新的浏览器对象，并以浏览器实例作为闭包的委托执行闭包。
	`static Browser`	`drive(Configuration conf, Closure script)` 使用配置创建一个新的浏览器，并以浏览器实例作为闭包的委托执行闭包。
	`static Browser`	`drive(Map browserProperties, Closure script)` 使用属性创建一个新的浏览器，并以浏览器实例作为闭包的委托执行闭包。
	`static Browser`	`drive(Browser browser, Closure script)` 以浏览器作为其委托执行闭包。
`<T>`	`Optional<T>`	`driverAs(Class<T> castType)`
	`Set<String>`	`getAvailableWindows()` 检索所有可用窗口
	`String`	`getBaseUrl()` 用于解析所有相对 URL 的 URL。
	`Configuration`	`getConfig()` 提供对与此浏览器关联的配置对象的访问。
	`String`	`getCurrentUrl()` 检索当前 URL
	`String`	`getCurrentWindow()` 检索当前窗口
	`WebDriver`	`getDriver()` 用于自动化实际浏览器的驱动程序实现。
	`JavascriptInterface`	`getJs()` 返回一个新创建的、连接到此浏览器的 JavaScript 接口。
	`WebStorage`	`getLocalStorage()` 返回一个允许访问和操作本地存储的对象。
	`NavigatorFactory`	`getNavigatorFactory()` 返回为此浏览器创建导航器实例的工厂。
	`Page`	`getPage()` 提供对当前页面对象的访问。
	`File`	`getReportGroupDir()` 将用于方法的目录。
	`WebStorage`	`getSessionStorage()` 返回一个允许访问和操作会话存储的对象。
	`void`	`go(String url)` 将浏览器发送到给定 URL。
	`void`	`go(String url, UrlFragment fragment)` 将浏览器发送到给定 URL 和片段。
	`void`	`go(Map params, UrlFragment fragment)` 将浏览器发送到带有给定查询参数和片段的基本 URL。
	`void`	`go(Map params, String url, UrlFragment fragment)` 将浏览器发送到给定 URL，带有给定查询参数和片段。
	`boolean`	`isAt(Class<? extends Page> pageType, boolean honourGlobalAtCheckWaiting)` 通过为此页面类型运行 at 检查器来检查浏览器是否在当前页面上，抑制断言错误。
	`boolean`	`isAt(Page page, boolean honourGlobalAtCheckWaiting)` 通过为此页面实例运行 at 检查器来检查浏览器是否在当前页面上，抑制断言错误。
	`Object`	`methodMissing(String name, Object args)` 将方法调用直接委托给当前页面对象。
`<T extends Page>`	`T`	`page(Class<T> pageClass)` 将浏览器的页面更改为给定类的实例。
	`Page`	`page(Class<? extends Page>[] potentialPageClasses)` 将浏览器的页面更改为第一个 at 检查器返回 true 值的给定类型的实例。
`<T extends Page>`	`T`	`page(T page)` 在初始化后将此浏览器的页面设置为给定页面。
	`Page`	`page(Page[] potentialPageInstances)` 将浏览器的页面更改为第一个 at 检查器返回 true 值的给定实例的实例。
	`void`	`pause()` 无限期地等待驱动浏览器中的 `geb.unpause` JavaScript 变量设置为 `true`。
	`Object`	`propertyMissing(String name)` 将属性访问直接委托给当前页面对象。
	`Object`	`propertyMissing(String name, Object value)` 将属性赋值直接委托给当前页面对象。
	`void`	`quit()` 退出驱动程序。
	`void`	`report(String label)` 使用 config's reporter 将浏览器状态快照写入当前 getReportGroupDir()。
	`void`	`reportGroup(String path)` 设置所有后续报告的“组”，即报告将被写入的报告目录内的相对路径。
	`void`	`reportGroup(Class clazz)` 将报告组设置为类的全名，将 "." 替换为 "/"。
	`void`	`resetNetworkLatency()` 删除任何先前配置的网络延迟。
	`void`	`setBaseUrl(String baseUrl)` 更改用于解析相对 URL 的基本 URL。
	`void`	`setDriver(WebDriver driver)` 设置（或更改）此浏览器下的 webdriver。
	`void`	`setNetworkLatency(java.time.Duration duration)` 允许向被驱动的浏览器引入网络延迟。
	`protected Object`	`switchToWindow(String window)`
`<T extends Page>`	`T`	`to(Map params, Class<T> pageType, Object[] args)` 将浏览器发送到给定页面类型的 URL，将页面设置为给定类型的新实例，并验证该页面的 at 检查器。
`<T extends Page>`	`T`	`to(Map params, Class<T> pageType, UrlFragment fragment, Object[] args)` 将浏览器发送到给定页面类型的 URL，将页面设置为给定类型的新实例，并验证该页面的 at 检查器。
`<T extends Page>`	`T`	`to(Map params, T page, Object[] args)` 将浏览器发送到给定页面实例 URL，将页面设置为给定页面实例，并验证该页面的 at 检查器。
`<T extends Page>`	`T`	`to(Map params, T page, UrlFragment fragment, Object[] args)` 将浏览器发送到给定页面实例 URL，将页面设置为给定类型的新实例，并验证该页面的 at 检查器。
	`void`	`verifyAtImplicitly(Class<? extends Page> targetPage)`
	`void`	`verifyAtImplicitly(Page targetPage)`
`<T extends Page>`	`T`	`via(Map params, Class<T> pageType, Object[] args)` 将浏览器发送到给定页面类型的 URL，并将页面设置为给定类型的新实例。
`<T extends Page>`	`T`	`via(Map params, Class<T> pageType, UrlFragment fragment, Object[] args)` 将浏览器发送到给定页面类型的 URL，并将页面设置为给定类型的新实例。
`<T extends Page>`	`T`	`via(Map params, T page, Object[] args)` 将浏览器发送到给定页面实例 URL，并将页面设置为给定实例。
`<T extends Page>`	`T`	`via(Map params, T page, UrlFragment fragment, Object[] args)` 将浏览器发送到给定页面实例 URL，并将页面设置为给定实例。
`<T>`	`T`	`withNewWindow(Map options, Closure windowOpeningBlock, Closure<T> block)` 期望第一个闭包参数打开一个新窗口，并在新打开窗口的上下文中调用第二个闭包参数。
`<T>`	`T`	`withNewWindow(Closure windowOpeningBlock, Closure<T> block)` 期望第一个闭包参数打开一个新窗口，并在新打开窗口的上下文中调用第二个闭包参数。
`<T>`	`T`	`withWindow(String window, Closure<T> block)` 在由名称指定的窗口上下文中执行闭包
`<T>`	`List<T>`	`withWindow(Closure specification, Closure<T> block)` 在所有规范闭包返回 Groovy 真值的窗口上下文中执行闭包。
`<T>`	`List<T>`	`withWindow(Map options, Closure specification, Closure<T> block)` 在所有规范闭包返回 Groovy 真值的窗口上下文中执行闭包。
`<T>`	`T`	`withWindow(Map options, String window, Closure<T> block)` 在由名称指定的窗口上下文中执行闭包

继承方法摘要

继承方法
从类继承的方法	名称
`class Object`	`wait, wait, wait, equals, toString, hashCode, getClass, notify, notifyAll`

- 字段详情
  - public static final String CLOSE_OPTION
  - protected static final String HAS_NETWORK_CONDITIONS_CLASS_NAME
  - public static final String QUERY_STRING_SEPARATOR
  - public static final String UTF8
- 属性详情
  - @Lazy
    WebDriver augmentedDriver
    
    如果驱动程序是远程的，此对象允许访问其功能（Geb 用户不应访问此对象，它在内部使用）。
  - String baseUrl
  - WebDriver driver
- 构造函数详情
  - Browser()
    
    使用默认配置加载器创建一个新的浏览器，加载默认配置文件。
    另请参阅
    ConfigurationLoader
  - Browser(Configuration config)
    
    使用给定配置创建一个新的浏览器。
    另请参阅
    Configuration
  - Browser(Map props, Configuration config)
    
    使用给定配置创建一个新的浏览器实例，然后将 props 应用为浏览器上的属性覆盖。
    另请参阅
    Configuration
- 方法详情
  - <T extends Page> T at(Class<T> pageType)
    
    通过为此页面类型运行 at 检查器来检查浏览器是否在当前页面上。将为 at 检查创建页面新实例。如果 at 检查器成功，此浏览器对象的页面实例将更新为给定页面类型的新实例，并返回新实例。如果给定 pageType 未定义 at 检查器，则抛出 UndefinedAtCheckerException。
    如果启用了隐式断言（默认情况下启用），此方法将始终返回页面实例或抛出 AssertionError
    返回
    当 at 检查器成功时，返回给定页面类型的页面实例，否则返回 null（如果启用了隐式断言，则永远不会为 null）
  - <T extends Page, R> R at(@DelegatesTo.Target
    Class<T> pageType, @DelegatesTo(strategy: DELEGATE_FIRST, genericTypeIndex: 0)
    Closure<R> assertions)
    
    通过使用 at(pageType) 运行 at 检查器来检查浏览器是否在当前页面上。如果 at 检查器成功，则执行作为最后一个参数传递的 assertions 闭包，其委托设置为 pageType 类的实例。如果启用了隐式断言（默认情况下启用），则 assertions 闭包中的每个语句都会被隐式断言。
    返回
    assertions 闭包返回的值
  - <T extends Page> T at(T page)
    
    通过为此页面实例运行 at 检查器来检查浏览器是否在当前页面上。如果 at 检查器成功，此浏览器对象的页面实例将更新为该页面实例。如果给定页面对象未定义 at 检查器，则抛出 UndefinedAtCheckerException。
    如果启用了隐式断言（默认情况下启用），此方法将始终返回页面实例或抛出 AssertionError
    返回
    在 at 检查器成功后初始化的传入页面的页面实例，否则为 null（如果启用了隐式断言，则永远不会为 null）
  - <T extends Page, R> R at(@DelegatesTo.Target
    T page, @DelegatesTo(strategy: DELEGATE_FIRST)
    Closure<R> assertions)
    
    通过使用 at(page) 运行 at 检查器来检查浏览器是否在当前页面上。如果 at 检查器成功，则执行作为最后一个参数传递的 assertions 闭包，其委托设置为该页面实例。如果启用了隐式断言（默认情况下启用），则 assertions 闭包中的每个语句都会被隐式断言。
    返回
    assertions 闭包返回的值
  - void checkIfAtAnUnexpectedPage(Class<? extends Page>[] expectedPages)
    
    检查是否在配置为意外的页面之一。
    抛出
    当在意外页面时抛出 UnexpectedPageException
    
    参数
    expectedPages - 允许指定要忽略哪些意外页面进行检查
  - void checkIfAtAnUnexpectedPage(Page[] expectedPages)
    
    检查是否在配置为意外的页面之一。
    抛出
    当在意外页面时抛出 UnexpectedPageException
    
    参数
    expectedPages - 允许指定要忽略哪些意外页面进行检查
  - void cleanReportGroupDir()
    
    如果 getReportGroupDir() 返回的目录存在，则从文件系统中删除它。
  - void clearCookies(String[] additionalUrls)
    
    通过将浏览器导航到作为此方法参数传入的每个 URL 并清除其 Cookie，清除当前域和多个附加域的 Cookie。
    参数
    additionalUrls - 除了当前域之外，还需要清除 Cookie 的 URL
  - void clearCookies()
    
    清除浏览器拥有的当前域的所有 Cookie。
    如果驱动浏览器积累了要清除的其他域的 Cookie，则应使用 clearCookies(java.lang.String[]) 方法。
    另请参阅
    Options.deleteAllCookies
  - void clearCookiesQuietly()
    
    清除浏览器当前拥有的所有 Cookie，抑制任何 webdriver 异常。
  - void clearWebStorage()
    
    清除 Web 存储，即当前域的本地存储和会话存储。
  - void clearWebStorageQuietly()
    
    清除 Web 存储，即当前域的本地存储和会话存储，抑制任何 webdriver 异常。
  - void close()
    
    关闭当前驱动程序窗口。
    另请参阅
    WebDriver.close
  - protected NavigatorFactory createNavigatorFactory()
    
    首次请求时，调用此方法创建导航器工厂。
    返回
    导航器工厂
  - <T extends Page> T createPage(Class<T> pageType)
    
    创建给定页面类型的新实例并初始化它。
    返回
    新创建的页面实例
  - <T> protected T doWithWindow(Map options, Closure<T> block)
  - static Browser drive(Closure script)
    
    通过默认构造函数创建一个新的浏览器对象，并以浏览器实例作为闭包的委托执行闭包。
    返回
    创建的浏览器
  - static Browser drive(Configuration conf, Closure script)
    
    使用配置创建一个新的浏览器，并以浏览器实例作为闭包的委托执行闭包。
    返回
    创建的浏览器
  - static Browser drive(Map browserProperties, Closure script)
    
    使用属性创建一个新的浏览器，并以浏览器实例作为闭包的委托执行闭包。
    返回
    创建的浏览器
  - static Browser drive(Browser browser, Closure script)
    
    以浏览器作为其委托执行闭包。
    返回
    浏览器
  - <T> Optional<T> driverAs(Class<T> castType)
  - Set<String> getAvailableWindows()
    
    检索所有可用窗口
    另请参阅
    WebDriver.getWindowHandles
  - String getBaseUrl()
    
    用于解析所有相对 URL 的 URL。通常是应用程序或 Geb 正在交互的系统的根目录。
    基本 URL 由配置决定。
    另请参阅
    Configuration.getBaseUrl
  - Configuration getConfig()
    
    提供对与此浏览器关联的配置对象的访问。
  - String getCurrentUrl()
    
    检索当前 URL
    另请参阅
    WebDriver.getCurrentUrl
  - String getCurrentWindow()
    
    检索当前窗口
    另请参阅
    WebDriver.getWindowHandle
  - WebDriver getDriver()
    
    用于自动化实际浏览器的驱动程序实现。
    要使用的驱动程序实现由配置决定。
    另请参阅
    Configuration.getDriver
  - JavascriptInterface getJs()
    
    返回一个新创建的、连接到此浏览器的 JavaScript 接口。
  - WebStorage getLocalStorage()
    
    返回一个允许访问和操作本地存储的对象。
    另请参阅
    WebStorage
  - NavigatorFactory getNavigatorFactory()
    
    返回为此浏览器创建导航器实例的工厂。
    返回
    导航器工厂
  - Page getPage()
    
    提供对当前页面对象的访问。
    所有浏览器对象最初都以 Page 页面类型创建。
  - File getReportGroupDir()
    
    将用于方法的目录。
    使用 Configuration.getReportsDir 作为报告的基本位置（如果未设置，则抛出异常），并附加当前报告组。返回的文件对象保证存在于文件系统中。
    如果当前报告组为 null，此方法返回与 config.reportsDir 相同的值。
    另请参阅
    reportGroup(java.lang.String)
    report(java.lang.String)
  - WebStorage getSessionStorage()
    
    返回一个允许访问和操作会话存储的对象。
    另请参阅
    WebStorage
  - void go(String url)
    
    将浏览器发送到给定 URL。如果它是相对 URL，则根据基本 URL 解析。
  - void go(String url, UrlFragment fragment)
    
    将浏览器发送到给定 URL 和片段。如果 URL 是相对 URL，则根据基本 URL 解析。
  - void go(Map params, UrlFragment fragment)
    
    将浏览器发送到带有给定查询参数和片段的基本 URL。
  - void go(Map params, String url, UrlFragment fragment)
    
    将浏览器发送到给定 URL，带有给定查询参数和片段。如果 URL 是相对 URL，则根据基本 URL 解析。
  - boolean isAt(Class<? extends Page> pageType, boolean honourGlobalAtCheckWaiting)
    
    通过为此页面类型运行 at 检查器来检查浏览器是否在给定页面上，抑制断言错误。如果 at 检查器成功，此浏览器对象的页面实例将更新为调用此方法的实例。如果给定 pageType 未定义 at 检查器，则抛出 UndefinedAtCheckerException。如果 at 检查抛出 AssertionError（当启用隐式断言时会如此），此方法将抑制异常并返回 false。
    返回
    如果浏览器在给定页面上则为 true，否则为 false
  - boolean isAt(Page page, boolean honourGlobalAtCheckWaiting)
    
    通过为此页面实例运行 at 检查器来检查浏览器是否在给定页面上，抑制断言错误。如果 at 检查器成功，此浏览器对象的页面实例将更新为调用此方法的实例。如果给定页面实例未定义 at 检查器，则抛出 UndefinedAtCheckerException。如果 at 检查抛出 AssertionError（当启用隐式断言时会如此），此方法将抑制异常并返回 false。
    返回
    如果浏览器在给定页面上则为 true，否则为 false
  - Object methodMissing(String name, Object args)
    
    将方法调用直接委托给当前页面对象。
  - <T extends Page> T page(Class<T> pageClass)
    
    将浏览器的页面更改为给定类的实例。
    此方法执行以下操作
    - 创建给定类（必须是 Page 或其子类）的新实例并将其连接到此浏览器对象
    - 通知所有注册的页面更改监听器
    - 将浏览器的页面属性设置为创建的实例（如果它不是此类型）
    请注意，它不会通过运行其 at 检查器来验证页面是否与当前内容匹配
    返回
    作为当前页面设置的已初始化页面实例
  - Page page(Class<? extends Page>[] potentialPageClasses)
    
    将浏览器的页面更改为第一个 at 检查器返回 true 值的给定类型的实例。
    此方法执行以下操作
    - 对于每个给定的页面类型
      - 创建类（必须是 Page 或其子类）的新实例并将其连接到浏览器对象
      - 通过运行其 at 检查器测试页面是否表示新实例
      - 如果页面的 at 检查器成功
        
        通知所有注册的页面更改监听器
        将浏览器的页面属性设置为该实例
        丢弃其余的潜在项
      - 如果页面的 at 检查器不成功
        
        尝试下一个潜在项
    - 如果所有页面都不匹配
      - 检查是否不在意外页面上
  返回
  作为当前页面设置的已初始化页面实例
- <T extends Page> T page(T page)
  
  在初始化后将此浏览器的页面设置为给定页面。
  此方法执行以下操作
  - 将传入的实例连接到此浏览器对象
  - 通知所有注册的页面更改监听器
  - 将浏览器的页面属性设置为传入的实例
    请注意，它不会通过运行其 at 检查器来验证页面是否与当前内容匹配
    返回
    初始化后作为第一个参数传入的页面实例
  - Page page(Page[] potentialPageInstances)
    
    将浏览器的页面更改为第一个 at 检查器返回 true 值的给定实例的实例。
    此方法执行以下操作
    - 对于每个给定页面实例
      - 将页面实例连接到浏览器对象
      - 通过运行其 at 检查器测试页面是否表示该实例
      - 如果页面的 at 检查器成功
        
        通知所有注册的页面更改监听器
        将浏览器的页面属性设置为该实例（如果它不是此类型）
        丢弃其余的潜在项
    - 如果页面的 at 检查器不成功
      - 尝试下一个潜在项
    - 如果所有页面都不匹配
      - 检查是否不在意外页面上
    返回
    作为当前页面设置的已初始化页面实例
  - void pause()
    
    无限期地等待驱动浏览器中的 geb.unpause JavaScript 变量设置为 true。
    可以用作设置断点并在调试模式下运行 JVM 的替代方法，用于调试目的。
  - Object propertyMissing(String name)
    
    将属性访问直接委托给当前页面对象。
  - Object propertyMissing(String name, Object value)
    
    将属性赋值直接委托给当前页面对象。
  - void quit()
    
    退出驱动程序。
    另请参阅
    WebDriver.quit
  - void report(String label)
    
    使用 config's reporter 将浏览器状态快照写入当前 getReportGroupDir()。
    参数
    label - 报告文件的名称（不应包含文件扩展名）
  - void reportGroup(String path)
    
    设置所有后续报告的“组”，即报告将被写入的报告目录内的相对路径。
    参数
    path - 一个相对路径，或 null 以便将报告写入基本报告目录
  - void reportGroup(Class clazz)
    
    将报告组设置为类的全名，将 "." 替换为 "/"。
    另请参阅
    reportGroup(String)
  - void resetNetworkLatency()
    
    删除任何先前配置的网络延迟。
    抛出
    geb.error.IncorrectDriverTypeException 当使用不实现或不能增强为 org.openqa.selenium.chromium.HasNetworkConditions 的驱动程序时调用
  - void setBaseUrl(String baseUrl)
    
    更改用于解析相对 URL 的基本 URL。
    此方法委托给 Configuration.setBaseUrl。
  - void setDriver(WebDriver driver)
    
    设置（或更改）此浏览器下的 webdriver。
    此方法只能在发出任何请求之前调用，作为覆盖将从配置中创建的驱动程序实例的一种方式。在可能的情况下，首选使用配置机制来指定要使用的驱动程序实现。
    此方法委托给 Configuration.setDriver。
  - void setNetworkLatency(java.time.Duration duration)
    
    允许向被驱动的浏览器引入网络延迟。
    有助于在开发中的自动化代码中暴露与网络相关的时序问题。
    仅在使用实现或可增强为 org.openqa.selenium.chromium.HasNetworkConditions 的驱动程序时支持。
    抛出
    geb.error.IncorrectDriverTypeException 当使用不实现或不能增强为 org.openqa.selenium.chromium.HasNetworkConditions 的驱动程序时调用
  - protected Object switchToWindow(String window)
  - <T extends Page> T to(Map params, Class<T> pageType, Object[] args)
    
    将浏览器发送到给定页面类型的 URL，将页面设置为给定类型的新实例，并验证该页面的 at 检查器。
    返回
    在 at 检查器成功时，返回传入页面类型的页面实例
    另请参阅
    page(geb.Page)
    Page.to
  - <T extends Page> T to(Map params, Class<T> pageType, UrlFragment fragment, Object[] args)
    
    将浏览器发送到给定页面类型的 URL，将页面设置为给定类型的新实例，并验证该页面的 at 检查器。
    返回
    在 at 检查器成功时，返回传入页面类型的页面实例
    另请参阅
    page(geb.Page)
    Page.to
  - <T extends Page> T to(Map params, T page, Object[] args)
    
    将浏览器发送到给定页面实例 URL，将页面设置为给定页面实例，并验证该页面的 at 检查器。
    返回
    在 at 检查器成功后初始化的传入页面的页面实例
    另请参阅
    page(geb.Page)
    Page.to
  - <T extends Page> T to(Map params, T page, UrlFragment fragment, Object[] args)
    
    将浏览器发送到给定页面实例 URL，将页面设置为给定类型的新实例，并验证该页面的 at 检查器。
    返回
    在 at 检查器成功时，返回传入页面类型的页面实例
    另请参阅
    page(geb.Page)
    Page.to
  - void verifyAtImplicitly(Class<? extends Page> targetPage)
  - void verifyAtImplicitly(Page targetPage)
  - <T extends Page> T via(Map params, Class<T> pageType, Object[] args)
    
    将浏览器发送到给定页面类型的 URL，并将页面设置为给定类型的新实例。
    返回
    传入页面类型的页面实例
    另请参阅
    page(geb.Page)
    Page.to
  - <T extends Page> T via(Map params, Class<T> pageType, UrlFragment fragment, Object[] args)
    
    将浏览器发送到给定页面类型的 URL，并将页面设置为给定类型的新实例。
    返回
    传入页面类型的页面实例
    另请参阅
    page(geb.Page)
    Page.to
  - <T extends Page> T via(Map params, T page, Object[] args)
    
    将浏览器发送到给定页面实例 URL，并将页面设置为给定实例。
    返回
    初始化后传入的页面实例。
    另请参阅
    page(geb.Page)
    Page.to
  - <T extends Page> T via(Map params, T page, UrlFragment fragment, Object[] args)
    
    将浏览器发送到给定页面实例 URL，并将页面设置为给定实例。
    返回
    初始化后传入的页面实例。
    另请参阅
    page(geb.Page)
    Page.to
  - <T> T withNewWindow(Map options, Closure windowOpeningBlock, @DelegatesTo(value: Browser, strategy: DELEGATE_FIRST)
    Closure<T> block)
    
    期望第一个闭包参数打开一个新窗口，并在新打开窗口的上下文中调用第二个闭包参数。还可以指定一个选项映射，允许关闭新窗口，切换到不同页面以在全新窗口上下文中执行闭包，以及在窗口打开是异步的情况下等待窗口打开。
    抛出
    geb.error.NoNewWindowException 如果窗口打开闭包没有打开一个新窗口或打开了多个新窗口
    
    参数
    options - 用于传递附加选项的映射
    windowOpeningBlock - 应该打开新窗口的闭包
    block - 在新窗口上下文中执行的闭包
    返回
    block 的返回值
  - <T> T withNewWindow(Closure windowOpeningBlock, @DelegatesTo(value: Browser, strategy: DELEGATE_FIRST)
    Closure<T> block)
    
    期望第一个闭包参数打开一个新窗口，并在新打开窗口的上下文中调用第二个闭包参数。
    抛出
    geb.error.NoNewWindowException 如果窗口打开闭包没有打开一个新窗口或打开了多个新窗口
    
    参数
    windowOpeningBlock - 应该打开新窗口的闭包
    block - 在新窗口上下文中执行的闭包
    返回
    block 的返回值
  - <T> T withWindow(String window, @DelegatesTo(value: Browser, strategy: DELEGATE_FIRST)
    Closure<T> block)
    
    在由名称指定的窗口上下文中执行闭包
    参数
    window - 用作上下文的窗口名称
    block - 在窗口上下文中执行的闭包
    返回
    block 的返回值
  - <T> List<T> withWindow(Closure specification, @DelegatesTo(value: Browser, strategy: DELEGATE_FIRST)
    Closure<T> block)
    
    在所有规范闭包返回 Groovy 真值的窗口上下文中执行闭包。
    参数
    specification - 在每个窗口的上下文中执行一次的闭包，如果它为给定窗口返回 Groovy truth，则 block 闭包也会在该窗口的上下文中执行
    block - 在窗口上下文中执行的闭包
    返回
    包含从 block 返回的每个窗口的值的列表，对于这些窗口，specification 返回 Groovy truth
  - <T> List<T> withWindow(Map options, Closure specification, @DelegatesTo(value: Browser, strategy: DELEGATE_FIRST)
    Closure<T> block)
    
    在所有规范闭包返回 Groovy 真值的窗口上下文中执行闭包。
    参数
    options - 用于传递附加选项的映射
    specification - 在每个窗口的上下文中执行一次的闭包，如果它为给定窗口返回 Groovy truth，则 block 闭包也会在该窗口的上下文中执行
    block - 在窗口上下文中执行的闭包
    返回
    包含从 block 返回的每个窗口的值的列表，对于这些窗口，specification 返回 Groovy truth
  - <T> T withWindow(Map options, String window, @DelegatesTo(value: Browser, strategy: DELEGATE_FIRST)
    Closure<T> block)
    
    在由名称指定的窗口上下文中执行闭包
    参数
    options - 用于传递附加选项的映射
    window - 用作上下文的窗口名称
    block - 在窗口上下文中执行的闭包
    返回
    block 的返回值

摘要：
字段
属性
构造函数
方法

Geb 7.0 的 Groovy API 文档 - 根据 Apache 许可证 2.0 版授权 - http://www.gebish.org

[Groovy] 类浏览器

字段摘要

属性摘要

构造函数摘要

方法摘要

继承方法摘要

字段详情

public static final String CLOSE_OPTION

protected static final String HAS_NETWORK_CONDITIONS_CLASS_NAME

public static final String QUERY_STRING_SEPARATOR

public static final String UTF8

属性详情

@LazyWebDriver augmentedDriver

String baseUrl

WebDriver driver

构造函数详情

Browser()

Browser(Configuration config)

Browser(Map props, Configuration config)

方法详情

<T extends Page> T at(Class<T> pageType)

<T extends Page, R> R at(@DelegatesTo.TargetClass<T> pageType, @DelegatesTo(strategy: DELEGATE_FIRST, genericTypeIndex: 0)Closure<R> assertions)

<T extends Page> T at(T page)

<T extends Page, R> R at(@DelegatesTo.TargetT page, @DelegatesTo(strategy: DELEGATE_FIRST)Closure<R> assertions)

void checkIfAtAnUnexpectedPage(Class<? extends Page>[] expectedPages)

void checkIfAtAnUnexpectedPage(Page[] expectedPages)

void cleanReportGroupDir()

void clearCookies(String[] additionalUrls)

void clearCookies()

void clearCookiesQuietly()

void clearWebStorage()

void clearWebStorageQuietly()

void close()

protected NavigatorFactory createNavigatorFactory()

<T extends Page> T createPage(Class<T> pageType)

<T> protected T doWithWindow(Map options, Closure<T> block)

static Browser drive(Closure script)

static Browser drive(Configuration conf, Closure script)

static Browser drive(Map browserProperties, Closure script)

static Browser drive(Browser browser, Closure script)

<T> Optional<T> driverAs(Class<T> castType)

Set<String> getAvailableWindows()

String getBaseUrl()

Configuration getConfig()

String getCurrentUrl()

String getCurrentWindow()

WebDriver getDriver()

JavascriptInterface getJs()

WebStorage getLocalStorage()

NavigatorFactory getNavigatorFactory()

Page getPage()

File getReportGroupDir()

WebStorage getSessionStorage()

void go(String url)

void go(String url, UrlFragment fragment)

void go(Map params, UrlFragment fragment)

void go(Map params, String url, UrlFragment fragment)

boolean isAt(Class<? extends Page> pageType, boolean honourGlobalAtCheckWaiting)

boolean isAt(Page page, boolean honourGlobalAtCheckWaiting)

Object methodMissing(String name, Object args)

<T extends Page> T page(Class<T> pageClass)

Page page(Class<? extends Page>[] potentialPageClasses)

<T extends Page> T page(T page)

Page page(Page[] potentialPageInstances)

void pause()

Object propertyMissing(String name)

Object propertyMissing(String name, Object value)

void quit()

void report(String label)

void reportGroup(String path)

void reportGroup(Class clazz)

void resetNetworkLatency()

void setBaseUrl(String baseUrl)

void setDriver(WebDriver driver)

void setNetworkLatency(java.time.Duration duration)

protected Object switchToWindow(String window)

<T extends Page> T to(Map params, Class<T> pageType, Object[] args)

<T extends Page> T to(Map params, Class<T> pageType, UrlFragment fragment, Object[] args)

<T extends Page> T to(Map params, T page, Object[] args)

<T extends Page> T to(Map params, T page, UrlFragment fragment, Object[] args)

@Lazy
WebDriver augmentedDriver

<T extends Page, R> R at(@DelegatesTo.Target
Class<T> pageType, @DelegatesTo(strategy: DELEGATE_FIRST, genericTypeIndex: 0)
Closure<R> assertions)

<T extends Page, R> R at(@DelegatesTo.Target
T page, @DelegatesTo(strategy: DELEGATE_FIRST)
Closure<R> assertions)

<T> T withNewWindow(Map options, Closure windowOpeningBlock, @DelegatesTo(value: Browser, strategy: DELEGATE_FIRST)
Closure<T> block)

<T> T withNewWindow(Closure windowOpeningBlock, @DelegatesTo(value: Browser, strategy: DELEGATE_FIRST)
Closure<T> block)

<T> T withWindow(String window, @DelegatesTo(value: Browser, strategy: DELEGATE_FIRST)
Closure<T> block)

<T> List<T> withWindow(Closure specification, @DelegatesTo(value: Browser, strategy: DELEGATE_FIRST)
Closure<T> block)

<T> List<T> withWindow(Map options, Closure specification, @DelegatesTo(value: Browser, strategy: DELEGATE_FIRST)
Closure<T> block)

<T> T withWindow(Map options, String window, @DelegatesTo(value: Browser, strategy: DELEGATE_FIRST)
Closure<T> block)