# Testing & Harnesses What each test covers, how to run them, and how to add your own. ## Test suites Void has three verification layers that run in CI and locally: | Layer | Command | What it checks | |-------|---------|---------------| | JS smoke tests | `npm test` | 55 checks: boot sequence, localStorage, search, lightbox, feedback, announcement, consent, giscus, repo popover, i18n, prefetch, link rebase, asset modes | | Doc lint | `python tools/check_docs.py` | 8 checks: PLAN links, intra-doc links, screenshots, config keys, H1/ markers, nav sync, component template, design tokens | | Strict build | `mkdocs build --strict` | Zero warnings — catches template errors, missing pages, broken refs | All three must pass before opening a PR. ## JS smoke tests (`npm test`) **File:** `tests/void.test.js` (1412 lines) The test stubs a minimal DOM/browser environment and loads the theme's `void.js` IIFE to verify the boot sequence runs without throwing. It then exercises specific features. ### What each check covers | # | Check | What it verifies | |---|-------|-----------------| | 1 | IIFE boot completes without throwing | `void.js` loads and all `init*` functions run with a null config | | 2 | Expired note purged after TTL | A 1-year-old note in `void-notes` is removed on boot | | 3 | Fresh note retained after TTL purge | A fresh note survives the purge | | 4 | `?q=` deep link auto-opens search | Query param opens the search overlay with the query pre-filled | | 5 | Copy link writes correct deep-link URL | Share button writes `?q=` URL without `#fragment` | | 6 | `result.show_share: false` hides share button | Config disables the per-result share button | | 7 | Image lightbox opens on click | Clicking an image creates a `.void-zoom` overlay | | 7b | Lightbox disabled via config | `content.typography.image_lightbox: false` prevents overlay creation | | 8 | Lightbox nav, zoom, copy, close | Arrow keys navigate, zoom scales, copy falls back to URL, close works after navigation | | 9 | Feedback widget renders | `.void-feedback` appears under the article when `repo_url` is set | | 10 | Feedback Yes opens prefilled issue URL | Click creates `/issues/new?labels=...&title=...&body=...` | | 11 | Feedback hidden when disabled | `enabled: false` suppresses the widget | | 12 | Announcement bar renders | `.void-announcement` appears when `text` is set | | 13 | Announcement dismiss persists + removes bar | Click writes `void-announcement-dismissed-: "1"` and removes the bar | | 14 | Already-dismissed announcement not re-rendered | Stored key prevents re-render on next boot | | 15 | Floating position variants (top/center) | `position: "top"` renders without backdrop; `"center"` renders with backdrop | | 16 | Closing centered announcement removes backdrop | Backdrop count decreases by 1 | | 17 | Consent absent when no integration | `consent_needed: false` → no `.void-consent` | | 18 | Consent renders when integration configured | `.void-consent` with accept button appears | | 19 | Accept persists consent flag | `void-consent: "accepted"` written to localStorage | | 20 | Decline persists consent flag | `void-consent: "declined"` written to localStorage | | 21 | Giscus loader injected on configured repo | `