diff --git a/index.html b/index.html index 6f54b0cb..cb6426bd 100644 --- a/index.html +++ b/index.html @@ -288,12 +288,9 @@

Nodes

Intermediary nodes are those that act as proxies, implementing both the local end and remote end of the protocol. However they are not expected - to implement remote end steps directly. All nodes between a - specific intermediary node and a local end are said to - be downstream of that - node. Conversely, any nodes between a specific intermediary - node and an endpoint node are said to - be upstream. + to implement remote end steps directly. Nodes between + a specific intermediary node and an endpoint node are + said to be upstream of the endpoint node.
Endpoint node
An endpoint node is the final remote end @@ -1395,30 +1392,31 @@

Extensions

Other specifications may define additional WebDriver capabilities. Each defined -capability must have a capability name which is a string -not containing a ":" (colon) character, -an additional capability deserialization algorithm which is -a set of steps taking a single argument value which has a -JSON type, returning either success wrapping the deserialized -capability value or error. +capability must have a capability name which +is a string not containing a ":" (colon) character, +an additional capability deserialization +algorithm which is a set of steps taking a single +argument value which has a JSON type, returning +either success wrapping the deserialized capability value +or error.

An additional WebDriver capability may also define -a matched capability serialization algorithm, which is a -set of steps used to determine if a capability is matched by the -current implementation and provide any computed value to return to the -user. This set of steps takes a single argument value, -which is the output of the corresponding additional capability -deserialization algorithm, and returns -either null to indicate the capability is not -matched, or a non-null JSON-serializable value if the capability is -matched. - -

Other specifications may also define WebDriver -new session algorithms, which are -called just after a new session is created, and before the new -session response is sent to the remote end. These -algorithms are called with session representing the -WebDriver session that will be established, and +a matched capability serialization algorithm, +which is a set of steps used to determine if a capability is matched +by the current implementation and provide any computed value to return +to the user. This set of steps takes a single +argument value, which is the output of the +corresponding additional capability deserialization algorithm, +and returns either null to indicate the capability +is not matched, or a non-null JSON-serializable value if the +capability is matched. + +

Other specifications may also define WebDriver +new session algorithms, which are called just after a new +session is created, and before the new session response is sent +to the remote end. These algorithms are called +with session representing the WebDriver session that will +be established, and capabilities, the capabilities object that will be returned to the remote end. It is permitted for such an algorithm to modify any entry in the capabilities object with a name that's an @@ -1502,21 +1500,21 @@

Capabilities

- Browser name + Browser name "browserName" string Identifies the user agent. - Browser version + Browser version "browserVersion" string Identifies the version of the user agent. - Platform name + Platform name "platformName" string Identifies the operating system of the endpoint node. @@ -1575,7 +1573,7 @@

Capabilities

- User Agent + User Agent "userAgent" string Identifies the default User-Agent value of the endpoint node. @@ -1613,16 +1611,15 @@

Proxy

- proxyAutoconfigUrl + proxyAutoconfigUrl string - Defines the URL for a proxy auto-config file - if proxyType - is equal to "pac". + Defines the URL for a proxy autoconfiguration file + if proxyType is equal to "pac". Any URL. - ftpProxy + ftpProxy string Defines the proxy host for FTP traffic when the proxyType is "manual". @@ -1631,7 +1628,7 @@

Proxy

- httpProxy + httpProxy string Defines the proxy host for HTTP traffic when the proxyType is "manual". @@ -1640,7 +1637,7 @@

Proxy

- noProxy + noProxy array Lists the address for which the proxy should be bypassed when the proxyType is "manual". @@ -1648,7 +1645,7 @@

Proxy

- sslProxy + sslProxy string Defines the proxy host for encrypted TLS traffic when the proxyType is "manual". @@ -1657,7 +1654,7 @@

Proxy

- socksProxy + socksProxy string Defines the proxy host for a SOCKS proxy when the proxyType is "manual". @@ -1665,7 +1662,7 @@

Proxy

- socksVersion + socksVersion number Defines the SOCKS proxy version when the proxyType is "manual". @@ -3875,16 +3872,10 @@

Resizing and positioning windows

-

If for whatever reason - the top-level browsing context's OS window - cannot enter either of the window states, - or if this concept is not applicable on the current system, - the default state must be normal. - -

A top-level browsing context's window rect - is defined as a dictionary of the screenX, screenY, - outerWidth and outerHeight attributes - of the WindowProxy. +

If for whatever reason the top-level browsing context's +OS window cannot enter either of the window states, or if this +concept is not applicable on the current system, the default state +must be normal.

The WindowRect object for a WindowProxy, window is an Object initialized @@ -3923,8 +3914,8 @@

Resizing and positioning windows

given an operating system level window with an associated top-level browsing context, run implementation-specific steps - to iconify, minimize, or hide the window - from the visible screen. + to transition the operating system level window + into the minimized window state. Do not return from this operation until the visibility state of the top-level browsing context's active document @@ -4239,6 +4230,8 @@

Fullscreen Window

with session's current top-level browsing context's active document's document element. +

The window is now in the Fullscreen window state. +

  • Return success with data set to the WindowRect object for the session's current top-level browsing context. @@ -5743,27 +5736,27 @@

    Get Element Rect

    The Get Element Rect command returns the dimensions and coordinates of the given web element. -The returned value is a dictionary with the following members: +The returned value is an object with the following properties:

    -
    x +
    "x"
    X axis position of the top-left corner of the web element relative to session's current browsing context's document element in CSS pixels. -
    y +
    "y"
    Y axis position of the top-left corner of the web element relative to session's current browsing context's document element in CSS pixels. -
    height +
    "height"
    Height of the web element's bounding rectangle in CSS pixels. -
    width +
    "width"
    Width of the web element's bounding rectangle in CSS pixels. @@ -7872,7 +7865,7 @@

    Pointer input source

    move to, either in its active (pressed) or inactive state. - pointerCancel + pointerCancel Used to cancel a pointer action. @@ -11105,19 +11098,25 @@

    Element displayedness

    considered visible if any part of it is drawn on the canvas within the boundaries of the viewport. -

    The element displayed algorithm - is a boolean state where true signifies that the element is displayed - and false signifies that the element is not displayed. - To compute the state on element, - invoke the Function.[[\Call]](null, element, - false), - with bot.dom.isShown as the this value. - If doing so does not produce an error, - return the return value from this function call. - Otherwise return an error with error code unknown error. - -

    This function is typically exposed to GET requests - with a URI Template of +

    The element displayed state is a boolean representing +whether an element is currently visible. + +

    To get the element displayed state using +the bot.dom.isShown Selenium atoms, +given element: +

      +

    1. Let function be + the bot.dom.isShown function. +

    2. Let result be the result of calling function's + [[\Call]] internal method with arguments + null and element. If this raises an exception, return + an error with error code unknown error. + +

    3. Return success with data result. +

      + +

      The element displayed state is typically exposed as an + endpoint for GET requests with a URI Template of /session/{session id}/element/{element id}/displayed. @@ -11247,7 +11246,6 @@

      Index

      @@ -11256,25 +11254,12 @@

      Index

      -

      The following attributes are defined - in the UI Events Code specification: [[UIEVENTS-CODE]] -

      -

      The following attributes are defined in the UI Events Code specification: [[UIEVENTS-KEY]]

      This specification also presumes that you are able to call - some of the internal methods + some of the internal methods from the ECMAScript Language Specification [[ECMAScript]]: