@govtechsg/oobee 0.10.68 → 0.10.69

package/README.md

@@ -612,26 +612,38 @@ the module (for instance, using `npm rebuild` or `npm install`).
 
 **Solution**: As recommended in the error message, run `npm rebuild` or `npm install`
 
-### dyld Error
+### Oobee Exits Without An Error
 
-**Issue**: Not able to run Oobee due to the following error shown below
+**Issue**: Oobee does not start a scan as shown below
 
 ```shell
-dyld: lazy symbol binding failed: Symbol not found: __ZN2v87Isolate37AdjustAmountOfExternalAllocatedMemoryEx
-  Referenced from: <user_path>/oobee/node_modules/libxmljs/build/Release/xmljs.node
-  Expected in: flat namespace
+> @govtechsg/oobee@0.10.68 cli
+> node --max-old-space-size=10000 dist/cli.js -c -u https://example.com
+```
+
+**Solutions**:
 
-dyld: Symbol not found: __ZN2v87Isolate37AdjustAmountOfExternalAllocatedMemoryEx
-  Referenced from: <user_path>/PURPLE_A11y/oobee/node_modules/libxmljs/build/Release/xmljs.node
-  Expected in: flat namespace
+1. Delete existing `node_modules` folder and re-install the npm packages with `npm install`.
 
-zsh: abort      node index.js
+2. Set Oobee Verbose mode so more errors are shown during a scan 
+#### On MacOS:
+```
+export OOBEE_VERBOSE=1
+```
+#### On Windows
+```
+$env:OOBEE_VERBOSE=1
 ```
 
-**Solutions**:
+3. Re-run a scan and see if the issue is resolved.
+
+4. Get the error log information. Error log is available at the log file that is written to `<uuid>.txt`
+```
+{"timestamp":"2025-09-26 11:13:57","level":"info","message":"Logger writing to: /Users/.../Oobee/...txt"}
+```
+
+5. Open an [https://github.com/GovTechSG/oobee/issues](issue). Describe the steps to the problem and paste a copy of the error log.
 
-1. Delete existing `node_modules` folder and re-install the NPM packages with `npm install`.
-2. Refer to this [GitHub issue](https://github.com/fsevents/fsevents/issues/313) for more alternative solutions
 
 ### Element Screenshot Limitation
 

package/examples/oobee-cypress-integration-js/cypress/e2e/spec.cy.js

@@ -0,0 +1,19 @@
+describe("template spec", () => {
+  it("should run oobee A11y", () => {
+    cy.visit(
+      "https://govtechsg.github.io/purple-banner-embeds/purple-integrated-scan-example.htm"
+    );
+    cy.injectOobeeA11yScripts();
+    cy.runOobeeA11yScan();
+    
+    cy.get("button[onclick=\"toggleSecondSection()\"]").click();
+    // Run a scan on <input> and <button> elements
+    cy.runOobeeA11yScan({
+      elementsToScan: ["input", "button"],
+      elementsToClick: ["button[onclick=\"toggleSecondSection()\"]"],
+      metadata: "Clicked button"
+    });
+
+    cy.terminateOobeeA11y();
+  });
+});

package/examples/oobee-cypress-integration-js/cypress/support/e2e.js

@@ -0,0 +1,73 @@
+Cypress.Commands.add("injectOobeeA11yScripts", () => {
+    cy.task("getAxeScript").then((s) => {
+        cy.window().then((win) => {
+            try {
+                win.eval(s);
+            }
+            catch (error) {
+                // If eval fails due to cross-origin issues, try alternative injection
+                if (error.message.includes('SecurityError') || error.message.includes('cross-origin')) {
+                    cy.log('Cross-origin error detected, attempting alternative script injection');
+                    // Create a script tag as fallback
+                    const script = win.document.createElement('script');
+                    script.textContent = s;
+                    win.document.head.appendChild(script);
+                }
+                else {
+                    throw error;
+                }
+            }
+        });
+    });
+    cy.task("getOobeeA11yScripts").then((s) => {
+        cy.window().then((win) => {
+            try {
+                win.eval(s);
+            }
+            catch (error) {
+                // If eval fails due to cross-origin issues, try alternative injection
+                if (error.message.includes('SecurityError') || error.message.includes('cross-origin')) {
+                    cy.log('Cross-origin error detected, attempting alternative script injection');
+                    // Create a script tag as fallback
+                    const script = win.document.createElement('script');
+                    script.textContent = s;
+                    win.document.head.appendChild(script);
+                }
+                else {
+                    throw error;
+                }
+            }
+        });
+    });
+});
+
+Cypress.Commands.add("runOobeeA11yScan", (items = {}) => {
+  cy.window().then(async (win) => {
+    const { elementsToScan, elementsToClick, metadata } = items;
+
+    // extract text from the page for readability grading
+    const sentences = win.extractText();
+    // run readability grading separately as it cannot be done within the browser context
+    cy.task("gradeReadability", sentences).then(
+      async (gradingReadabilityFlag) => {
+        // passing the grading flag to runA11yScan to inject violation as needed
+        const res = await win.runA11yScan(
+          elementsToScan,
+          gradingReadabilityFlag,
+        );
+        cy.task("pushOobeeA11yScanResults", {
+          res,
+          metadata,
+          elementsToClick,
+        }).then((count) => {
+          return count;
+        });
+      },
+    );
+    cy.task("finishOobeeA11yTestCase"); // test the accumulated number of issue occurrences against specified thresholds. If exceed, terminate oobeeA11y instance.
+  });
+});
+
+Cypress.Commands.add("terminateOobeeA11y", () => {
+  cy.task("terminateOobeeA11y");
+});

package/examples/oobee-cypress-integration-js/cypress.config.js

@@ -0,0 +1,62 @@
+import { defineConfig } from "cypress";
+import oobeeA11yInit from "@govtechsg/oobee";
+
+// viewport used in tests to optimise screenshots
+const viewportSettings = { width: 1920, height: 1040 };
+// specifies the number of occurrences before error is thrown for test failure
+const thresholds = { mustFix: 20, goodToFix: 25 };
+// additional information to include in the "Scan About" section of the report
+const scanAboutMetadata = { browser: 'Chrome (Desktop)' };
+// name of the generated zip of the results at the end of scan
+const resultsZipName = "oobee-scan-results.zip";
+
+const oobeeA11y = await oobeeA11yInit({
+  entryUrl: "https://govtechsg.github.io/purple-banner-embeds/purple-integrated-scan-example.htm", // initial url to start scan
+  testLabel: "Demo Cypress Scan", // label for test
+  name: "Your Name",
+  email: "email@domain.com",
+  includeScreenshots: true, // include screenshots of affected elements in the report
+  viewportSettings,
+  thresholds,
+  scanAboutMetadata,
+  zip: resultsZipName,
+  deviceChosen: "E2E Test Device",
+  strategy: undefined,
+  ruleset: ["enable-wcag-aaa"], // add "disable-oobee" to disable Oobee custom checks
+  specifiedMaxConcurrency: undefined,
+  followRobots: undefined,
+});
+
+export default defineConfig({
+  taskTimeout: 120000, // need to extend as screenshot function requires some time
+  viewportHeight: viewportSettings.height,
+  viewportWidth: viewportSettings.width,
+  e2e: {
+    setupNodeEvents(on, _config) {
+      on("task", {
+        getAxeScript() {
+          return oobeeA11y.getAxeScript();
+        },
+        getOobeeA11yScripts() {
+          return oobeeA11y.getOobeeFunctions();
+        },
+        gradeReadability(sentences) {
+          return oobeeA11y.gradeReadability(sentences);
+        },
+        async pushOobeeA11yScanResults({ res, metadata, elementsToClick }) {
+          return await oobeeA11y.pushScanResults(res, metadata, elementsToClick);
+        },
+        returnResultsDir() {
+          return `results/${oobeeA11y.randomToken}_${oobeeA11y.scanDetails.urlsCrawled.scanned.length}pages/report.html`;
+        },
+        finishOobeeA11yTestCase() {
+          oobeeA11y.testThresholds();
+          return null;
+        },
+        async terminateOobeeA11y() {
+          return await oobeeA11y.terminate();
+        },
+      });
+    },
+  },
+});

package/examples/oobee-cypress-integration-js/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "oobee-cypress-integration-js",
+  "version": "1.0.0",
+  "description": "Oobee Cypress integration example (JavaScript)",
+  "type": "module",
+  "scripts": {
+    "test": "cypress run"
+  },
+  "devDependencies": {
+    "cypress": "^13.0.0",
+    "@govtechsg/oobee": "^0.10.69"
+  }
+}

package/examples/oobee-cypress-integration-ts/cypress.config.ts

@@ -0,0 +1,94 @@
+import { defineConfig } from "cypress";
+import oobeeA11yInit from "@govtechsg/oobee";
+
+interface ViewportSettings {
+    width: number;
+    height: number;
+}
+
+interface Thresholds {
+    mustFix: number;
+    goodToFix: number;
+}
+
+interface ScanAboutMetadata {
+    browser: string;
+}
+
+// viewport used in tests to optimise screenshots
+const viewportSettings: ViewportSettings = { width: 1920, height: 1040 };
+// specifies the number of occurrences before error is thrown for test failure
+const thresholds: Thresholds = { mustFix: 20, goodToFix: 60 };
+// additional information to include in the "Scan About" section of the report
+const scanAboutMetadata: ScanAboutMetadata = { browser: 'Chrome (Desktop)' };
+// name of the generated zip of the results at the end of scan
+const resultsZipName: string = "oobee-scan-results.zip";
+
+// Initialize oobee instance variable - will be set lazily
+let oobeeA11y: any = null;
+
+const initOobeeIfNeeded = async () => {
+    if (!oobeeA11y) {
+        oobeeA11y = await oobeeA11yInit({
+            entryUrl: "https://govtechsg.github.io/purple-banner-embeds/purple-integrated-scan-example.htm", // initial url to start scan
+            testLabel: "Demo Cypress Scan", // label for test
+            name: "Your Name", 
+            email: "email@domain.com",
+            includeScreenshots: true, // include screenshots of affected elements in the report
+            viewportSettings,
+            thresholds: { mustFix: undefined, goodToFix: undefined },
+            scanAboutMetadata: scanAboutMetadata as any,
+            zip: resultsZipName,
+            deviceChosen: "E2E Test Device",
+            strategy: undefined,
+            ruleset: ["enable-wcag-aaa"], // add "disable-oobee" to disable Oobee custom checks
+            specifiedMaxConcurrency: undefined,
+            followRobots: undefined,
+        });
+    }
+    return oobeeA11y;
+};
+
+export default defineConfig({
+    taskTimeout: 120000, // need to extend as screenshot function requires some time
+    viewportHeight: viewportSettings.height,
+    viewportWidth: viewportSettings.width,
+    chromeWebSecurity: false, // Disable web security to handle cross-origin frames
+    e2e: {
+        setupNodeEvents(on, _config) {
+            on("task", {
+                async getAxeScript(): Promise<string> {
+                    const instance = await initOobeeIfNeeded();
+                    return instance.getAxeScript();
+                },
+                async getOobeeA11yScripts(): Promise<string> {
+                    const instance = await initOobeeIfNeeded();
+                    return instance.getOobeeFunctions();
+                },
+                async gradeReadability(sentences: string[]): Promise<string> {
+                    const instance = await initOobeeIfNeeded();
+                    return instance.gradeReadability(sentences);
+                },
+                async pushOobeeA11yScanResults({res, metadata, elementsToClick}: { res: any, metadata: any, elementsToClick: any[] }): Promise<{ mustFix: number, goodToFix: number }> {
+                    const instance = await initOobeeIfNeeded();
+                    return await instance.pushScanResults(res, metadata, elementsToClick);
+                },
+                async returnResultsDir(): Promise<string> {
+                    const instance = await initOobeeIfNeeded();
+                    return `results/${instance.randomToken}_${instance.scanDetails.urlsCrawled.scanned.length}pages/reports/report.html`;
+                },
+                async finishOobeeA11yTestCase(): Promise<null> {
+                    const instance = await initOobeeIfNeeded();
+                    instance.testThresholds();
+                    return null;
+                },
+                async terminateOobeeA11y(): Promise<string> {
+                    const instance = await initOobeeIfNeeded();
+                    return await instance.terminate();
+                },
+            });
+        },
+        supportFile: 'dist/cypress/support/e2e.js',
+        specPattern: 'dist/cypress/e2e/**/*.cy.{js,jsx,ts,tsx}',
+    },
+});

package/examples/oobee-cypress-integration-ts/cypress.d.ts

@@ -0,0 +1,22 @@
+/// <reference types="cypress" />
+
+export interface OobeeScanOptions {
+  elementsToScan?: string[];
+  elementsToClick?: string[];
+  metadata?: string;
+}
+
+declare global {
+  namespace Cypress {
+    interface Chainable<Subject = any> {
+      injectOobeeA11yScripts(): Chainable<void>;
+      runOobeeA11yScan(options?: OobeeScanOptions): Chainable<void>;
+      terminateOobeeA11y(): Chainable<any>;
+    }
+  }
+
+  interface Window {
+    runA11yScan: (elementsToScan?: string[], gradingReadabilityFlag?: string) => Promise<any>;
+    extractText: () => string[];
+  }
+}

package/examples/oobee-cypress-integration-ts/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "oobee-cypress-integration-ts",
+  "version": "1.0.0",
+  "description": "Oobee Cypress integration example (TypeScript)",
+  "type": "module",
+  "devDependencies": {
+    "@govtechsg/oobee": "^0.10.69",
+    "@types/jest": "^30.0.0",
+    "cypress": "^15.3.0",
+    "typescript": "^5.9.3"
+  }
+}

package/examples/oobee-cypress-integration-ts/src/cypress/e2e/spec.cy.ts

@@ -0,0 +1,18 @@
+/// <reference types="cypress" />
+
+describe("template spec", () => {
+    it("should run oobee A11y", () => {
+        cy.visit("https://govtechsg.github.io/purple-banner-embeds/purple-integrated-scan-example.htm");
+        cy.injectOobeeA11yScripts();
+        cy.runOobeeA11yScan();
+         cy.get("button[onclick=\"toggleSecondSection()\"]").click();
+        // Run a scan on <input> and <button> elements
+        cy.runOobeeA11yScan({
+            elementsToScan: ["input", "button"],
+            elementsToClick: ["button[onclick=\"toggleSecondSection()\"]"],
+            metadata: "Clicked button"
+        });
+
+        cy.terminateOobeeA11y();
+    });
+});

package/examples/oobee-cypress-integration-ts/src/cypress/support/e2e.ts

@@ -0,0 +1,93 @@
+/// <reference types="cypress" />
+
+import { OobeeScanOptions } from "../../../cypress.d";
+
+Cypress.Commands.add("injectOobeeA11yScripts", () => {
+    cy.task("getAxeScript").then((s: string) => {
+        cy.window().then((win) => {
+            try {
+                win.eval(s);
+            } catch (error) {
+                // If eval fails due to cross-origin issues, try alternative injection
+                if (error.message.includes('SecurityError') || error.message.includes('cross-origin')) {
+                    cy.log('Cross-origin error detected, attempting alternative script injection');
+                    // Create a script tag as fallback
+                    const script = win.document.createElement('script');
+                    script.textContent = s;
+                    win.document.head.appendChild(script);
+                } else {
+                    throw error;
+                }
+            }
+        });
+    });
+    cy.task("getOobeeA11yScripts").then((s: string) => {
+        cy.window().then((win) => {
+            try {
+                win.eval(s);
+            } catch (error) {
+                // If eval fails due to cross-origin issues, try alternative injection
+                if (error.message.includes('SecurityError') || error.message.includes('cross-origin')) {
+                    cy.log('Cross-origin error detected, attempting alternative script injection');
+                    // Create a script tag as fallback
+                    const script = win.document.createElement('script');
+                    script.textContent = s;
+                    win.document.head.appendChild(script);
+                } else {
+                    throw error;
+                }
+            }
+        });
+    });
+});
+
+Cypress.Commands.add("runOobeeA11yScan", (items: OobeeScanOptions = {}) => {
+    cy.window().then(async (win) => {
+        const { elementsToScan, elementsToClick, metadata } = items;
+
+        // extract text from the page for readability grading
+        const sentences = win.extractText();
+        // run readability grading separately as it cannot be done within the browser context
+        cy.task("gradeReadability", sentences).then(
+            async (gradingReadabilityFlag: string) => {
+                // passing the grading flag to runA11yScan to inject violation as needed
+                const res = await win.runA11yScan(
+                    elementsToScan,
+                    gradingReadabilityFlag,
+                );
+                cy.task("pushOobeeA11yScanResults", {
+                    res,
+                    metadata,
+                    elementsToClick,
+                }).then((count) => {
+                     return count;
+                });
+            },
+        );
+        cy.task("finishOobeeA11yTestCase"); // test the accumulated number of issue occurrences against specified thresholds. If exceed, terminate oobeeA11y instance.
+    });
+});
+
+Cypress.Commands.add("terminateOobeeA11y", () => {
+    cy.task("terminateOobeeA11y");
+});
+
+// Suppress ResizeObserver errors and cross-origin security errors
+Cypress.on('uncaught:exception', (err, runnable) => {
+    if (err.message.includes('ResizeObserver loop completed with undelivered notifications')) {
+        return false; // prevents Cypress from failing the test
+    }
+    if (err.message.includes('SecurityError') && err.message.includes('cross-origin frame')) {
+        return false; // prevents Cypress from failing due to cross-origin frame access
+    }
+    if (err.message.includes("Failed to read a named property 'eval' from 'Window'")) {
+        return false; // prevents Cypress from failing due to eval access on cross-origin frames
+    }
+    if (err.message.includes('Minified React error')) {
+        return false; // prevents Cypress from failing due to React errors
+    }
+    if (err.message.includes('https://reactjs.org/docs/error-decoder.html')) {
+        return false; // prevents Cypress from failing due to React errors
+    }
+    return true;
+});

package/examples/oobee-cypress-integration-ts/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "outDir": "./dist",
+    "allowJs": true,
+    "target": "es2021",
+    "lib": ["es2021", "dom"],
+    "module": "commonjs",
+    "rootDir": "./src",
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "strict": false,
+    "types": ["cypress"],
+    "moduleResolution": "node",
+    "resolveJsonModule": true
+  },
+  "include": ["./src/**/*", "cypress.d.ts"],
+  "exclude": ["node_modules"]
+}

package/examples/oobee-playwright-integration-js/oobee-playwright-demo.js

@@ -0,0 +1,64 @@
+import { chromium } from "playwright";
+import oobeeA11yInit from "@govtechsg/oobee";
+import { extractText } from "@govtechsg/oobee/dist/crawlers/custom/extractText.js";
+
+// viewport used in tests to optimise screenshots
+const viewportSettings = { width: 1920, height: 1040 };
+// specifies the number of occurrences before error is thrown for test failure
+const thresholds = { mustFix: 20, goodToFix: 25 };
+// additional information to include in the "Scan About" section of the report
+const scanAboutMetadata = { browser: 'Chrome (Desktop)' };
+// name of the generated zip of the results at the end of scan
+const resultsZipName = "oobee-scan-results.zip";
+
+const oobeeA11y = await oobeeA11yInit({
+  entryUrl: "https://govtechsg.github.io", // initial url to start scan
+  testLabel: "Demo Playwright Scan", // label for test
+  name: "Your Name",
+  email: "email@domain.com",
+  includeScreenshots: true, // include screenshots of affected elements in the report
+  viewportSettings,
+  thresholds,
+  scanAboutMetadata,
+  zip: resultsZipName,
+  deviceChosen: "E2E Test Device",
+  strategy: undefined,
+  ruleset: ["enable-wcag-aaa"],
+  specifiedMaxConcurrency: undefined,
+  followRobots: undefined,
+});
+
+(async () => {
+  const browser = await chromium.launch({
+    headless: false,
+  });
+  const context = await browser.newContext();
+  const page = await context.newPage();
+
+  const runOobeeA11yScan = async (elementsToScan, gradingReadabilityFlag) => {
+    const scanRes = await page.evaluate(
+      async ({ elementsToScan, gradingReadabilityFlag }) => await runA11yScan(elementsToScan, gradingReadabilityFlag),
+      { elementsToScan, gradingReadabilityFlag },
+    );
+    await oobeeA11y.pushScanResults(scanRes);
+    oobeeA11y.testThresholds(); // test the accumulated number of issue occurrences against specified thresholds. If exceed, terminate oobeeA11y instance.
+  };
+
+  await page.goto('https://govtechsg.github.io/purple-banner-embeds/purple-integrated-scan-example.htm');
+  await page.evaluate(oobeeA11y.getAxeScript());
+  await page.evaluate(oobeeA11y.getOobeeFunctions());
+
+  const sentences = await page.evaluate(() => extractText());
+  const gradingReadabilityFlag = await oobeeA11y.gradeReadability(sentences);
+
+  await runOobeeA11yScan([], gradingReadabilityFlag);
+
+  await page.getByRole('button', { name: 'Click Me' }).click();
+  // Run a scan on <input> and <button> elements
+  await runOobeeA11yScan(['input', 'button'])
+
+  // ---------------------
+  await context.close();
+  await browser.close();
+  await oobeeA11y.terminate();
+})();

package/examples/oobee-playwright-integration-js/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "oobee-playwright-integration-js",
+  "version": "1.0.0",
+  "description": "Oobee Playwright integration example (JavaScript)",
+  "type": "module",
+  "scripts": {
+    "test": "node oobee-playwright-demo.js"
+  },
+  "devDependencies": {
+    "playwright": "^1.55.0",
+    "@govtechsg/oobee": "^0.10.69"
+  }
+}

package/examples/oobee-playwright-integration-ts/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "oobee-playwright-integration-ts",
+  "version": "1.0.0",
+  "description": "Oobee Playwright integration example (TypeScript)",
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "test": "tsc && node dist/oobee-playwright-demo.js"
+  },
+  "devDependencies": {
+    "playwright": "^1.55.0",
+    "@govtechsg/oobee": "^0.10.69",
+    "typescript": "^5.9.3"
+  }
+}

package/examples/oobee-playwright-integration-ts/src/oobee-playwright-demo.ts

@@ -0,0 +1,83 @@
+import { Browser, BrowserContext, Page, chromium } from "playwright";
+import oobeeA11yInit from "@govtechsg/oobee";
+import { extractText } from "@govtechsg/oobee/dist/crawlers/custom/extractText.js";
+
+declare const runA11yScan: (
+  elementsToScan?: string[],
+  gradingReadabilityFlag?: string,
+) => Promise<any>;
+
+interface ViewportSettings {
+  width: number;
+  height: number;
+}
+
+interface Thresholds {
+  mustFix: number;
+  goodToFix: number;
+}
+
+interface ScanAboutMetadata {
+  browser: string;
+}
+
+// viewport used in tests to optimise screenshots
+const viewportSettings: ViewportSettings = { width: 1920, height: 1040 };
+// specifies the number of occurrences before error is thrown for test failure
+const thresholds: Thresholds = { mustFix: 20, goodToFix: 25 };
+// additional information to include in the "Scan About" section of the report
+const scanAboutMetadata: ScanAboutMetadata = { browser: 'Chrome (Desktop)' };
+// name of the generated zip of the results at the end of scan
+const resultsZipName: string = "oobee-scan-results.zip";
+
+const oobeeA11y = await oobeeA11yInit({
+  entryUrl: "https://govtechsg.github.io", // initial url to start scan
+  testLabel: "Demo Playwright Scan", // label for test
+  name: "Your Name",
+  email: "email@domain.com",
+  includeScreenshots: true, // include screenshots of affected elements in the report
+  viewportSettings,
+  thresholds,
+  scanAboutMetadata,
+  zip: resultsZipName,
+  deviceChosen: "E2E Test Device",
+  strategy: undefined,
+  ruleset: ["enable-wcag-aaa"],
+  specifiedMaxConcurrency: undefined,
+  followRobots: undefined,
+});
+
+(async () => {
+  const browser: Browser = await chromium.launch({
+    headless: false,
+  });
+  const context: BrowserContext = await browser.newContext();
+  const page: Page = await context.newPage();
+
+  const runOobeeA11yScan = async (elementsToScan?: string[], gradingReadabilityFlag?: string) => {
+    const scanRes = await page.evaluate(
+      async ({ elementsToScan, gradingReadabilityFlag }) => await runA11yScan(elementsToScan, gradingReadabilityFlag),
+      { elementsToScan, gradingReadabilityFlag },
+    );
+    await oobeeA11y.pushScanResults(scanRes);
+    oobeeA11y.testThresholds(); // test the accumulated number of issue occurrences against specified thresholds. If exceed, terminate oobeeA11y instance.
+  };
+
+  await page.goto('https://govtechsg.github.io/purple-banner-embeds/purple-integrated-scan-example.htm');
+  await page.evaluate(oobeeA11y.getAxeScript());
+  await page.evaluate(oobeeA11y.getOobeeFunctions());
+
+  const sentences = await page.evaluate(() => extractText());
+  const gradingReadabilityFlag = await oobeeA11y.gradeReadability(sentences);
+
+  await runOobeeA11yScan([], gradingReadabilityFlag);
+
+  await page.getByRole('button', { name: 'Click Me' }).click();
+  // Run a scan on <input> and <button> elements
+  await runOobeeA11yScan(['input', 'button'])
+
+  // ---------------------
+  await context.close();
+  await browser.close();
+  await oobeeA11y.terminate();
+})();