Title: [Feature]: Promote `testing` to Stable — settle the Testing-Library-parity surface · Issue #147 · bQuery/bQuery · GitHub
Open Graph Title: [Feature]: Promote `testing` to Stable — settle the Testing-Library-parity surface · Issue #147 · bQuery/bQuery
X Title: [Feature]: Promote `testing` to Stable — settle the Testing-Library-parity surface · Issue #147 · bQuery/bQuery
Description: Pre-flight checklist I searched existing issues and did not find a duplicate request. I explained the problem or use case, not just the desired API. Problem or use case testing is Beta and its surface is one minor old: screen/within, use...
Open Graph Description: Pre-flight checklist I searched existing issues and did not find a duplicate request. I explained the problem or use case, not just the desired API. Problem or use case testing is Beta and its surf...
X Description: Pre-flight checklist I searched existing issues and did not find a duplicate request. I explained the problem or use case, not just the desired API. Problem or use case testing is Beta and its surf...
Opengraph URL: https://github.com/bQuery/bQuery/issues/147
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"[Feature]: Promote `testing` to Stable — settle the Testing-Library-parity surface","articleBody":"**Pre-flight checklist**\n- [x] I searched existing issues and did not find a duplicate request.\n- [x] I explained the problem or use case, not just the desired API.\n\n**Problem or use case**\n`testing` is **Beta** and its surface is one minor old: `screen`/`within`, `userEvent`, the `fireEvent.*` family, module mocks, and a11y helpers all landed in 1.14.0. It mirrors Testing Library APIs well (including Shadow-DOM-aware queries, which suit bQuery's Web Component model), but a test-utility API that just appeared cannot yet be relied on for teams' test suites, and the official runner integration story (beyond `bun:test`) is undocumented.\n\n**Proposed solution**\nFreeze the `testing` API for one cycle, document runner integration beyond `bun:test` (at minimum guidance for Vitest/Jest-style runners, since not every team uses Bun), and add coverage proving the query/`userEvent`/`fireEvent`/mock APIs behave consistently — especially the Shadow-DOM-aware queries against real components. Exit criteria: frozen surface, documented runner integrations, tested query/interaction APIs across light and shadow DOM.\n\n**Possible API or UX shape**\n```ts\nimport { render, screen, userEvent } from \"@bquery/bquery/testing\";\n\nrender(MyComponent, { props });\nawait userEvent.click(screen.getByRole(\"button\", { name: \"Save\" }));\n// Shadow-DOM-aware queries documented + tested; runner-agnostic guidance published\n```\n\n**Alternatives considered**\nPromoting now — premature for a 1.14-introduced surface. Supporting only `bun:test` officially — limits adoption to Bun users; documenting runner-agnostic usage costs little and broadens reach.\n\n**Relevant area**\n`testing`\n\n**Additional context**\nReuse the `a11y` audit API (#142) in the testing a11y helpers so assertions and runtime audits share one definition of \"accessible.\" Parity target: React Testing Library, Vue Test Utils, Svelte Testing Library.\n","author":{"url":"https://github.com/JosunLP","@type":"Person","name":"JosunLP"},"datePublished":"2026-06-26T21:25:53.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":0},"url":"https://github.com/147/bQuery/issues/147"}
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:ac1604e8-d649-7e05-5133-62adbab562d7 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | B110:B5AA6:33CBD78:489E513:6A4F7CE4 |
| html-safe-nonce | f92a78961e41c62978d03189f3448262b8d6deaeed09a7c7549b8fc191c861d4 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJCMTEwOkI1QUE2OjMzQ0JENzg6NDg5RTUxMzo2QTRGN0NFNCIsInZpc2l0b3JfaWQiOiI1MDA5MzM4MzI4OTc1MTEzNDQ0IiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0= |
| visitor-hmac | ae0340aa3ffefc0223615e7c3987e0602cc0ca5e68498401dc82a2064b1c1ed5 |
| hovercard-subject-tag | issue:4755240275 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/bQuery/bQuery/147/issue_layout |
| twitter:image | https://opengraph.githubassets.com/ffbea7a9145757b50109b78678f6e3915968b1f3755f29a1a7520a9364531b37/bQuery/bQuery/issues/147 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/ffbea7a9145757b50109b78678f6e3915968b1f3755f29a1a7520a9364531b37/bQuery/bQuery/issues/147 |
| og:image:alt | Pre-flight checklist I searched existing issues and did not find a duplicate request. I explained the problem or use case, not just the desired API. Problem or use case testing is Beta and its surf... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | JosunLP |
| hostname | github.com |
| expected-hostname | github.com |
| None | b92d11c0aa4a77d54ef4af1078b6a15fb5a70a215b30c4ecf28889d5a8e656d9 |
| turbo-cache-control | no-preview |
| go-import | github.com/bQuery/bQuery git https://github.com/bQuery/bQuery.git |
| octolytics-dimension-user_id | 256381806 |
| octolytics-dimension-user_login | bQuery |
| octolytics-dimension-repository_id | 1139284244 |
| octolytics-dimension-repository_nwo | bQuery/bQuery |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 1139284244 |
| octolytics-dimension-repository_network_root_nwo | bQuery/bQuery |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 4b249b445842943ed31549e027f57a8ade9881ed |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
Links:
Viewport: width=device-width