[js][py][rb][java][dotnet] add the accessibility snapshot atom and the binding methods

.gitattributes

@@ -9,6 +9,9 @@
 # The CDDL parser keeps the carriage return in a production name, so a CRLF
 # checkout of the overlays in common/bidi makes every type they define unresolvable.
 *.cddl   text eol=lf
+# The corpus consistency test compares these byte for byte with the renderer's output.
+common/src/web/accessibility/*.txt  text eol=lf
+common/src/web/accessibility/*.json text eol=lf
 *.sql    text
 *.xml    text
 

.gitignore

@@ -21,6 +21,7 @@ java/client/src/org/openqa/selenium/ie/IeReturnTypes.java
 java/server/test/org/openqa/selenium/example
 javascript/deps.js
 javascript/selenium-webdriver/node_modules/
+javascript/selenium-webdriver/lib/atoms/accessibility-snapshot.js
 javascript/selenium-webdriver/lib/atoms/find-elements.js
 javascript/selenium-webdriver/lib/atoms/get-attribute.js
 javascript/selenium-webdriver/lib/atoms/is-displayed.js
@@ -85,6 +86,7 @@ py/selenium/webdriver/common/linux-x86_64/
 py/selenium/webdriver/common/macos/
 py/selenium/webdriver/common/mutation-listener.js
 py/selenium/webdriver/common/windows/
+py/selenium/webdriver/remote/accessibilitySnapshot.js
 py/selenium/webdriver/remote/findElements.js
 py/selenium/webdriver/remote/getAttribute.js
 py/selenium/webdriver/remote/isDisplayed.js

common/src/web/BUILD.bazel

@@ -8,7 +8,9 @@ filegroup(
     ]),
     visibility = [
         "//dotnet/test:__subpackages__",
+        "//java/test/org/openqa/selenium:__pkg__",
         "//java/test/org/openqa/selenium/environment:__pkg__",
+        "//javascript/atoms:__pkg__",
         "//javascript/selenium-webdriver:__pkg__",
         "//py:__pkg__",
         "//rb/spec:__subpackages__",
@@ -24,3 +26,12 @@ js_library(
         "//javascript/selenium-webdriver:__subpackages__",
     ],
 )
+
+# The accessibility snapshot corpus (ADR 18205), copied into the output tree
+# so a js_test in another package can read it from its working directory:
+# rules_js copies only its own package's source files there.
+js_library(
+    name = "accessibility-corpus",
+    srcs = glob(["accessibility/**"]),
+    visibility = ["//javascript/atoms:__pkg__"],
+)

common/src/web/accessibility/001-headings-and-landmarks.expected.json

@@ -0,0 +1,202 @@
+{
+  "role": "document",
+  "name": "Headings and landmarks",
+  "description": "",
+  "states": {},
+  "element": "root",
+  "children": [
+    {
+      "role": "banner",
+      "name": "",
+      "description": "",
+      "states": {},
+      "element": "header",
+      "children": [
+        {
+          "role": "heading",
+          "name": "Site title",
+          "description": "",
+          "states": {
+            "level": 1
+          },
+          "element": "h1",
+          "children": []
+        },
+        {
+          "role": "navigation",
+          "name": "",
+          "description": "",
+          "states": {},
+          "element": "nav",
+          "children": [
+            {
+              "role": "link",
+              "name": "Home",
+              "description": "",
+              "states": {},
+              "element": "home",
+              "children": []
+            },
+            {
+              "role": "link",
+              "name": "Docs",
+              "description": "",
+              "states": {},
+              "element": "docs",
+              "children": []
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "role": "main",
+      "name": "",
+      "description": "",
+      "states": {},
+      "element": "main",
+      "children": [
+        {
+          "role": "heading",
+          "name": "Section",
+          "description": "",
+          "states": {
+            "level": 2
+          },
+          "element": "h2",
+          "children": []
+        },
+        {
+          "role": "region",
+          "name": "Updates",
+          "description": "",
+          "states": {},
+          "element": "region",
+          "children": [
+            {
+              "role": "heading",
+              "name": "Latest",
+              "description": "",
+              "states": {
+                "level": 3
+              },
+              "element": "h3",
+              "children": []
+            },
+            {
+              "role": "paragraph",
+              "name": "",
+              "description": "",
+              "states": {},
+              "element": "p1",
+              "children": [
+                {
+                  "role": "text",
+                  "name": "First paragraph.",
+                  "description": "",
+                  "states": {},
+                  "children": []
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "role": "paragraph",
+          "name": "",
+          "description": "",
+          "states": {},
+          "element": "p2",
+          "children": [
+            {
+              "role": "text",
+              "name": "Unlabelled section content.",
+              "description": "",
+              "states": {},
+              "children": []
+            }
+          ]
+        },
+        {
+          "role": "complementary",
+          "name": "",
+          "description": "",
+          "states": {},
+          "element": "aside",
+          "children": [
+            {
+              "role": "heading",
+              "name": "Related",
+              "description": "",
+              "states": {
+                "level": 4
+              },
+              "element": "h4",
+              "children": []
+            }
+          ]
+        },
+        {
+          "role": "heading",
+          "name": "ARIA heading",
+          "description": "",
+          "states": {
+            "level": 5
+          },
+          "element": "aria-heading",
+          "children": []
+        },
+        {
+          "role": "search",
+          "name": "",
+          "description": "",
+          "states": {},
+          "element": "search",
+          "children": [
+            {
+              "role": "text",
+              "name": "Search",
+              "description": "",
+              "states": {},
+              "children": []
+            },
+            {
+              "role": "searchbox",
+              "name": "Search",
+              "description": "",
+              "value": "kittens",
+              "states": {},
+              "element": "q",
+              "children": []
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "role": "contentinfo",
+      "name": "",
+      "description": "",
+      "states": {},
+      "element": "footer",
+      "children": [
+        {
+          "role": "paragraph",
+          "name": "",
+          "description": "",
+          "states": {},
+          "element": "p3",
+          "children": [
+            {
+              "role": "text",
+              "name": "Footer text",
+              "description": "",
+              "states": {},
+              "children": []
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

common/src/web/accessibility/001-headings-and-landmarks.expected.txt

@@ -0,0 +1,23 @@
+- document "Headings and landmarks"
+  - banner
+    - heading "Site title" [level=1]
+    - navigation
+      - link "Home"
+      - link "Docs"
+  - main
+    - heading "Section" [level=2]
+    - region "Updates"
+      - heading "Latest" [level=3]
+      - paragraph
+        - text: First paragraph.
+    - paragraph
+      - text: Unlabelled section content.
+    - complementary
+      - heading "Related" [level=4]
+    - heading "ARIA heading" [level=5]
+    - search
+      - text: Search
+      - searchbox "Search": kittens
+  - contentinfo
+    - paragraph
+      - text: Footer text

common/src/web/accessibility/001-headings-and-landmarks.html

@@ -0,0 +1,37 @@
+<!DOCTYPE html>
+<!--
+Licensed to the Software Freedom Conservancy (SFC) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The SFC licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+<html id="root">
+<head>
+  <meta charset="utf-8">
+  <title>Headings and landmarks</title>
+</head>
+<body>
+  <header id="header"><h1 id="h1">Site title</h1><nav id="nav"><a id="home" href="#">Home</a> <a id="docs" href="#">Docs</a></nav></header>
+  <main id="main">
+    <h2 id="h2">Section</h2>
+    <section id="region" aria-label="Updates"><h3 id="h3">Latest</h3><p id="p1">First paragraph.</p></section>
+    <section id="plain-section"><p id="p2">Unlabelled section content.</p></section>
+    <aside id="aside"><h4 id="h4">Related</h4></aside>
+    <div id="aria-heading" role="heading" aria-level="5">ARIA heading</div>
+    <search id="search"><form id="form"><label for="q">Search</label><input id="q" type="search" value="kittens"></form></search>
+  </main>
+  <footer id="footer"><p id="p3">Footer text</p></footer>
+</body>
+</html>