From 0d2e928df0ff232f3637b87e4e796113309b624b Mon Sep 17 00:00:00 2001 From: Julian Descottes Date: Thu, 22 Aug 2024 21:35:32 +0000 Subject: [PATCH] Update user prompt handler note for fallbackDefault (#1831) SHA: 7a23ea0cc2579b65a6994f2919a5b0adf990fe8b Reason: push, by pull[bot] Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> --- index.html | 633 ++++++++++++++++++++++++++++------------------------- 1 file changed, 332 insertions(+), 301 deletions(-) diff --git a/index.html b/index.html index 474aa8f9..9339a737 100644 --- a/index.html +++ b/index.html @@ -176,7 +176,7 @@ .mdn .samsunginternet_android::before{background-image:url(https://www.w3.org/assets/logos/browser-logos/samsung-internet/samsung-internet.svg)} .mdn .webview_android::before{background-image:url(https://www.w3.org/assets/logos/browser-logos/android-webview/android-webview.png)} - +

WebDriver

-

W3C Editor's Draft

+

W3C Editor's Draft

More details about this document
@@ -2587,7 +2587,7 @@

WebDriver

flags are provided that define the features of the session. This specification always creates sessions with "http" in session configuration flags, which corresponds to -the HTTP flag. External specficiations may define additional +the HTTP flag. External specifications may define additional flags, or create sessions without the HTTP flag.

8.1 Global State

@@ -2651,8 +2651,7 @@

WebDriver

  • Let serialized user prompt handler be serialize the user prompt handler. -

  • If serialized user prompt handler is not null, set - a property on capabilities with the name +

  • Set a property on capabilities with the name "unhandledPromptBehavior", and the value serialized user prompt handler. @@ -4689,34 +4688,48 @@

    WebDriver

    1. Let width be the result of getting a property named "width" - from parameters, else let it be null. + from parameters. + +

    2. If width is undefined, let width + be null.

    3. Let height be the result of getting a property named "height" - from parameters, else let it be null. + from parameters. + +

    4. If height is undefined, let height + be null.

    5. Let x be the result of getting a property - named "x" from parameters, - else let it be null. + named "x" from parameters. + +

    6. If x is undefined, let x be null.

    7. Let y be the result of getting a property - named "y" from parameters, - else let it be null. + named "y" from parameters. + +

    8. If y is undefined, let y be null. -

    9. If width or height is neither null - nor a Number from 0 to 231 − 1, - return error with error code invalid argument. +

    10. If width or height is neither null, nor + a Number from 0 to 231 − 1, return error + with error code invalid argument. -

    11. If x or y is neither null - nor a Number from −(231) to 231 − 1, +

    12. If x or y is neither null, nor + a Number from −(231) to 231 − 1, return error with error code invalid argument.

    13. If the remote end does not support the Set Window Rect command for - session's current top-level browsing context for any reason, - return error with error code unsupported operation. + session's current top-level browsing context + for any reason, return error with error + code unsupported operation. + +

      Note

      In case the Set Window Rect command is + partially supported (i.e. some combinations of arguments are + supported but not others), the implmentation is expected to continue + with the remaining steps. -

    14. If session's current top-level browsing +

  • If session's current top-level browsing context is no longer open, return error with error code no such window. @@ -4727,22 +4740,26 @@

    WebDriver

  • Restore the window. -

  • If width and height are not null: +

  • Let window be the operating system window containing + session's current top-level browsing context + +

  • If the implementation is able to set the dimensions + of window:

      -

    1. Set the width, in CSS pixels, - of the operating system window containing - session's current top-level browsing context, - including any browser chrome and externally drawn window decorations +

    2. If width is not null, set the width, + in CSS pixels, of window, including + any browser chrome and externally drawn window decorations, to a value that is as close as possible to width. -

    3. Set the height, in CSS pixels, - of the operating system window containing - session's current top-level browsing context, - including any browser chrome and externally drawn window decorations +

    4. If height is not null, set the height, + in CSS pixels, of window, including + any browser chrome and externally drawn window decorations, to a value that is as close as possible to height. -

      Note
    + +
    Note
    -
    • -

  • If x and y are not null: +

  • If the implementation is able to set the position of window:

      -

    1. Run the implementation-specific steps to set the position of - the operating system level window - containing session's current top-level browsing - context to the position given by the x - and y coordinates. - -

      Note
      -
    +

  • If x is not null, set the x-coordinate of the + left edge of window to a value that is as close as + possible to x. + +

  • If y is not null, set the y-coordinate of the top + edge of window to a value that is as close as possible + to y. +

    • + +
    Note

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

    • @@ -4810,9 +4829,9 @@

    WebDriver

    -
    Note

    The Maximize Window command invokes the window +

    Note

    The Maximize Window command invokes the window manager-specific “maximize” operation, if any, on the window - containing session's current top-level browsing + containing session's current top-level browsing context. This typically increases the window to the maximum available size without going full-screen. @@ -4821,11 +4840,11 @@

    WebDriver

    1. If the remote end does not support the Maximize - Window command for session's current top-level + Window command for session's current top-level browsing context for any reason, return error with error code unsupported operation. -

    2. If session's current top-level browsing +

    3. If session's current top-level browsing context is no longer open, return error with error code no such window. @@ -4837,10 +4856,10 @@

      WebDriver

    4. Restore the window.

    5. Maximize the window - of session's current top-level browsing context. + of session's current top-level browsing context.

    6. Return success with data set to the WindowRect - object for the session's current top-level browsing + object for the session's current top-level browsing context.

    @@ -4859,9 +4878,9 @@

    WebDriver

    -
    Note

    The Minimize Window command invokes the window +

    Note

    The Minimize Window command invokes the window manager-specific “minimize” operation, if any, on the window - containing session's current top-level browsing + containing session's current top-level browsing context. This typically hides the window in the system tray.

    The remote end steps, given session, URL @@ -4869,11 +4888,11 @@

    WebDriver

    1. If the remote end does not support the Minimize - Window command for session's current top-level + Window command for session's current top-level browsing context for any reason, return error with error code unsupported operation. -

    2. If session's current top-level browsing +

    3. If session's current top-level browsing context is no longer open, return error with error code no such window. @@ -4885,7 +4904,7 @@

      WebDriver

    4. Iconify the window.

    5. Return success with data set to the WindowRect - object for the session's current top-level browsing + object for the session's current top-level browsing context.

    @@ -4911,7 +4930,7 @@

    WebDriver

  • If the remote end does not support fullscreen return error with error code unsupported operation. -

  • If session's current top-level browsing +

  • If session's current top-level browsing context is no longer open, return error with error code no such window. @@ -4921,13 +4940,13 @@

    WebDriver

  • Restore the window.

  • Call fullscreen an element - with session's current top-level browsing context's + with session's current top-level browsing context's active document's document element. -

    Note

    The window is now in the Fullscreen window state. +

    Note

    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 + object for the session's current top-level browsing context.

    • @@ -4958,7 +4977,7 @@

    WebDriver

    presence in the map does not prevent garbage collection. This acts as an alternative to defining properties directly on the key objects. -

    Note

    Unlike the ECMAScript WeakMap, +

    Note

    Unlike the ECMAScript WeakMap, a weak map can participate in the full set of operations available for a Map. @@ -5642,11 +5661,11 @@

    WebDriver

    calling evaluate, with arguments selector, start node, - null, + null, ORDERED_NODE_SNAPSHOT_TYPE, - and null. + and null. -

    Note

    A snapshot is used to promote operation atomicity. +

    Note

    A snapshot is used to promote operation atomicity.

  • Let index be 0. @@ -5695,7 +5714,7 @@

    WebDriver

    -
    Note

  • Let selector be the result of getting a property named "value" from parameters. -

  • If selector is undefined, +

  • If selector is undefined, return error with error code invalid argument.

  • If session's current browsing context @@ -5740,7 +5759,7 @@

    WebDriver

  • Let start node be session's current browsing context's document element. -

  • If start node is null, +

  • If start node is null, return error with error code no such element.

  • Let result be the result of trying @@ -5781,7 +5800,7 @@

    WebDriver

  • Let selector be the result of getting a property named "value" from parameters. -

  • If selector is undefined, +

  • If selector is undefined, return error with error code invalid argument.

  • If session's current browsing context @@ -5795,7 +5814,7 @@

    WebDriver

    session's current browsing context's document element. -

  • If start node is null, +

  • If start node is null, return error with error code no such element.

  • Return the result of trying to Find with session, @@ -5831,7 +5850,7 @@

    WebDriver

  • Let selector be the result of getting a property named "value" from parameters. -

  • If selector is undefined, +

  • If selector is undefined, return error with error code invalid argument.

  • If session's current browsing context @@ -5883,7 +5902,7 @@

    WebDriver

  • Let selector be the result of getting a property named "value" from parameters. -

  • If selector is undefined, +

  • If selector is undefined, return error with error code invalid argument.

  • If session's current browsing context @@ -5930,7 +5949,7 @@

    WebDriver

  • Let selector be the result of getting a property called "value". -

  • If selector is undefined, +

  • If selector is undefined, return error with error code invalid argument.

  • If the ssession's current browsing @@ -5981,7 +6000,7 @@

    WebDriver

  • Let selector be the result of getting a property called "value". -

  • If selector is undefined, +

  • If selector is undefined, return error with error code invalid argument.

  • If session's current browsing context @@ -6089,7 +6108,7 @@

    WebDriver

    returned by calling getBoundingClientRect().

  • Let window be the associated window - of session's current top-level browsing context. + of session's current top-level browsing context.

  • Let x be (scrollX of window + @@ -6129,14 +6148,14 @@

    WebDriver

  • Let datalist parent be the first datalist element reached by traversing the tree in reverse order from element, - or undefined if the root of the tree is reached. + or undefined if the root of the tree is reached.

  • Let select parent be the first select element reached by traversing the tree in reverse order from element, - or undefined if the root of the tree is reached. + or undefined if the root of the tree is reached. -

  • If datalist parent is undefined, +

  • If datalist parent is undefined, the element context is select parent. Otherwise, the element context is datalist parent.

    • @@ -6162,7 +6181,7 @@

    WebDriver

    -
    Note

    +

    Note

    The Is Element Selected command determines if the referenced element is selected or not. This operation only makes sense on input elements @@ -6285,7 +6304,7 @@

    WebDriver

    If name is a boolean attribute

    "true" (string) if the element hasAttribute() with name, - otherwise null. + otherwise null.

    Otherwise

    The result of getting an attribute by name @@ -6295,7 +6314,7 @@

    WebDriver

  • Return success with data result.

    • -
    Note

    Please note that the behavior of this command +

    Note

    Please note that the behavior of this command deviates from the behavior of getAttribute() in [DOM], which in the case of a set boolean attribute would return an empty string. @@ -6382,7 +6401,7 @@

    WebDriver

    the Object.[[GetProperty]](name) on element.

  • Let result be the value of - property if not undefined, or null. + property if not undefined, or null.

  • Return success with data result.

    • @@ -6447,7 +6466,7 @@

    WebDriver

    -
    Note
    @@ -7506,7 +7525,7 @@

    WebDriver

    return an error with error code invalid argument. -

  • Return success with data null. +

  • Return success with data null.

    • @@ -7529,7 +7548,7 @@

    WebDriver

  • Let input state be the result of get the input state with session - and session's current top-level browsing + and session's current top-level browsing context.

  • Let input id be a the result of generating a @@ -7549,7 +7568,7 @@

    WebDriver

  • Remove an input source with input state and input id. -

  • Return success with data null. +

  • Return success with data null.

    • @@ -7572,7 +7591,7 @@

    WebDriver

    -
    Note

    +

    Note

    The Get Page Source command returns a string serialization of the DOM of session's current browsing context active document. @@ -7592,11 +7611,11 @@

    WebDriver

    fragment serializing algorithm on a fictional node whose only child is the document element providing true for the require well-formed flag. If this causes an exception - to be thrown, let source be null. + to be thrown, let source be null.

  • Let source be the result of serializing to string session's current browsing context's active document, - if source is null. + if source is null.

  • Return success with data source.

    • @@ -7637,8 +7656,8 @@

    WebDriver

  • Matching on value:

    -
    undefined -
    null +
    undefined +
    null
    type Boolean
    type Number
    type String @@ -7678,9 +7697,9 @@

    WebDriver

    on value:

    -
    undefined -
    null -

    Return success with data null. +

    undefined +
    null +

    Return success with data null.

    type Boolean
    type Number @@ -7820,7 +7839,7 @@

    WebDriver

    The algorithm returns an ECMAScript completion record.

    If at any point during the algorithm a user prompt appears, - immediately return Completion { [[Type]]: normal, [[Value]]: null, + immediately return Completion { [[Type]]: normal, [[Value]]: null, [[Target]]: empty }, but continue to run the other steps of this algorithm in parallel.

      @@ -7838,7 +7857,7 @@

      WebDriver

    1. If body is not parsable as a FunctionBody or if parsing detects an early error, return - Completion { [[Type]]: normal, [[Value]]: null, [[Target]]: empty }. + Completion { [[Type]]: normal, [[Value]]: null, [[Target]]: empty }.

    2. If body begins with a directive prologue that contains a use strict directive @@ -7882,7 +7901,7 @@

      WebDriver

    3. Return completion.

    -
    Note

    The above algorithm is not associated +

    Note

    The above algorithm is not associated with any particular element, and is therefore not subject to the document CSP directives. @@ -7977,7 +7996,7 @@

    WebDriver

    -
    Note

    +

    Note

    The Execute Async Script command causes JavaScript to execute as an anonymous function. An additional value is provided as the final argument to the function. @@ -8027,7 +8046,7 @@

    WebDriver

  • If scriptResult.[[Type]] is not normal, then reject promise with value scriptResult.[[Value]], and abort these steps. -

    Note

    Prior revisions of this specification did not recognize the +

    Note

    Prior revisions of this specification did not recognize the return value of the provided script. In order to preserve legacy behavior, the return value only influences the command if it is a "thenable" object or if determining this produces an exception. @@ -8227,7 +8246,7 @@

    WebDriver

    document, run the substeps of the first matching condition:

    -
    name is undefined +
    name is undefined
    name is equal to cookie name

    Set the cookie expiry time to a Unix timestamp in the past. @@ -8354,7 +8373,7 @@

    WebDriver

    return error with error code invalid cookie domain. -

  • If cookie name or cookie value is null, +

  • If cookie name or cookie value is null, cookie domain is not equal to session's current browsing context's active document's domain, cookie secure only or cookie HTTP only are not boolean types, @@ -8399,7 +8418,7 @@

    WebDriver

    return error with error code unable to set cookie. -

  • Return success with data null. +

  • Return success with data null.

    • @@ -8431,7 +8450,7 @@

    WebDriver

  • Delete cookies using the URL variables["name"] as the filter argument. -

  • Return success with data null. +

  • Return success with data null.

    • @@ -8462,7 +8481,7 @@

    WebDriver

  • Delete cookies, giving no filtering argument. -

  • Return success with data null. +

  • Return success with data null.

    • @@ -9042,7 +9061,7 @@

    WebDriver

    on context, such that trusted events corresponding to the entries in list of eventsare dispatched. -

    Note