Implement a11y protocol commands in puppeteer (#6160)

Author: christian-bromann

packages/devtools/src/commands/getElementComputedLabel.ts

@@ -0,0 +1,27 @@
+/**
+ * Get the computed WAI-ARIA label of an element.
+ *
+ * @alias browser.getElementComputedLabel
+ * @see https://w3c.github.io/webdriver/#get-computed-label
+ * @param {string} elementId  the id of an element returned in a previous call to Find Element(s)
+ * @return {string}           The result of computing the WAI-ARIA label of element.
+ */
+
+import type DevToolsDriver from '../devtoolsdriver'
+
+export default async function getElementComputedLabel (
+    this: DevToolsDriver,
+    { elementId }: { elementId: string }
+) {
+    const page = this.getPageHandle(true)
+    const elementHandle = await this.elementStore.get(elementId)
+    const snapshot = await page.accessibility.snapshot({
+        root: elementHandle
+    })
+
+    if (!snapshot) {
+        return ''
+    }
+
+    return snapshot.name
+}

packages/devtools/src/commands/getElementComputedRole.ts

@@ -0,0 +1,27 @@
+/**
+ * Get the computed WAI-ARIA role of an element.
+ *
+ * @alias browser.getElementComputedRole
+ * @see https://w3c.github.io/webdriver/#get-computed-role
+ * @param {string} elementId  the id of an element returned in a previous call to Find Element(s)
+ * @return {string}           The result of computing the WAI-ARIA role of element.
+ */
+
+import type DevToolsDriver from '../devtoolsdriver'
+
+export default async function getElementComputedRole (
+    this: DevToolsDriver,
+    { elementId }: { elementId: string }
+) {
+    const page = this.getPageHandle(true)
+    const elementHandle = await this.elementStore.get(elementId)
+    const snapshot = await page.accessibility.snapshot({
+        root: elementHandle
+    })
+
+    if (!snapshot) {
+        return 'Ignored'
+    }
+
+    return snapshot.role
+}