experience-lwc-accessibility-jest-run

Use ALWAYS when running Sa11y accessibility Jest tests for a Lightning Web Component — locally before pushing, producing the exact command(s), running one file vs a whole suite, selecting tests by naming convention, saving Sa11y-rendered HTML, or reproducing a Sa11y / A11yBug failure. Covers Salesfo

By forcedotcom · 643 installs

npx skills add forcedotcom/sf-skills --skill experience-lwc-accessibility-jest-run

Source repository · Upstream listing

<! adk managed skill Running LWC Accessibility Jest Tests Run Sa11y accessibility unit tests on Lightning Web Components in either: Core (Bazel) — when a WORKSPACE file is present. Standalone (Jest) — when there's no WORKSPACE . Selenium level reproductions, GUS A11yBug ingestion, and other internal Salesforce only flows are out of scope for this skill. For source code level WCAG review without running tests, see experience lwc accessibility validate . When to Use This Skill User wants to run accessibility unit tests (Sa11y Jest) locally before pushing a fix. User has a known failing test file path (e.g. from an A11yBug's Test Names c ) and wants to target it directly. User is iterating on an accessibility fix and needs the fastest pass/fail signal. Prerequisites For Bazel Jest tests: a Salesforce core build environment (a WORKSPACE file is present). For standalone Jest tests: @sa11y/jest installed and configured. Workflow Follow [running sa11y jest tests.md](references/running sa11y jest tests.md). Pick the correct mode: Core (Bazel) — use when WORKSPACE is present. Prefer single file targets ( //{moduleName}:{relativePath} ) over module targets when the failing test file path is already known ( .test.js extension dropped). Bazel commands must pass test env=SA11Y AUTO=1 test env=SA11Y ENABLE DOM MUTATION OBSERVER=1 ; when debugging, add SA11Y ENABLE RENDERED DOM SAVE=1 with the documented save path to avoid EPERM issues. Standalone (Jest) — use when there's no WORKSPACE . Run npm test testMatch=" / .accessibility.test.js" for the whole suite, or npm test <file targeting the file by the name/path given in the prompt (a bare filename when it is "in this directory"). Do not prepend SA11Y env vars in standalone mode — Sa11y runs automatically because @sa11y/jest is wired into the project's Jest setup; no extra environment variables are needed. Answer only what is asked. Emit just the command(s) the prompt requests plus the exit code meaning. Do not pad the plan with unrequested variants (watch, coverage, verbose), snapshot update steps, or HTML save sections unless the user explicitly asks for them. Verification Checklist [ ] Sa11y Jest run completed with a clear pass/fail signal (exit 0 or 3 for Bazel; exit 0 or 1 for Jest). [ ] If snapshots were intentionally updated, the new snapshots are committed alongside the fix. Troubleshooting Bazel test "not found" — the target path is off. Remember to drop the .test.js extension in {relativePath} . HTML saving fails with EPERM — use the prescribed save path sfdc test/unit/javascript/htdocs/sa11y/jest .