@out-of-order/vitest 0.1.0 → 0.1.2

package/dist/index.js

@@ -1,6 +1,14 @@
 // src/index.ts
 import { expect } from "vitest";
 import { audit } from "@out-of-order/core";
+function assertRealBrowser() {
+  const userAgent = typeof navigator === "undefined" ? "" : navigator.userAgent;
+  if (typeof window === "undefined" || userAgent.includes("jsdom")) {
+    throw new Error(
+      "toHaveValidTabOrder() needs a real browser and found jsdom. Enable Vitest Browser Mode (test.browser.enabled) for these tests. jsdom has no layout engine, so tab order and visibility cannot be measured."
+    );
+  }
+}
 function resolveRoot(received) {
   if (received instanceof Element || received instanceof Document || received instanceof DocumentFragment) {
     return received;
@@ -13,6 +21,7 @@ function resolveRoot(received) {
 }
 expect.extend({
   toHaveValidTabOrder(received, options) {
+    assertRealBrowser();
     const root = resolveRoot(received);
     const result = audit(root, options);
     const { isNot } = this;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@out-of-order/vitest",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "toHaveValidTabOrder() matcher for Vitest Browser Mode.",
   "keywords": [
     "a11y",
@@ -10,10 +10,10 @@
     "tab-order",
     "vitest"
   ],
-  "license": "MIT",
-  "author": "Bart Spaans",
   "homepage": "https://github.com/spaansba/out-of-order#readme",
   "bugs": "https://github.com/spaansba/out-of-order/issues",
+  "license": "MIT",
+  "author": "Bart Spaans",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/spaansba/out-of-order.git",
@@ -37,10 +37,11 @@
     "access": "public"
   },
   "dependencies": {
-    "@out-of-order/core": "0.1.0"
+    "@out-of-order/core": "0.1.1"
   },
   "devDependencies": {
     "@vitest/browser": "^2.1.0",
+    "jsdom": "^25.0.0",
     "playwright": "^1.47.0",
     "tsup": "^8.2.0",
     "typescript": "^5.5.0",

package/src/index.ts

@@ -1,6 +1,17 @@
 import { expect } from "vitest";
 import { audit, type AuditOptions, type AuditResult } from "@out-of-order/core";
 
+function assertRealBrowser(): void {
+  const userAgent = typeof navigator === "undefined" ? "" : navigator.userAgent;
+  if (typeof window === "undefined" || userAgent.includes("jsdom")) {
+    throw new Error(
+      "toHaveValidTabOrder() needs a real browser and found jsdom. Enable Vitest " +
+        "Browser Mode (test.browser.enabled) for these tests. jsdom has no layout " +
+        "engine, so tab order and visibility cannot be measured.",
+    );
+  }
+}
+
 /** Accept an Element or a Document/DocumentFragment as the assertion target. */
 function resolveRoot(received: unknown): ParentNode {
   if (
@@ -19,6 +30,7 @@ function resolveRoot(received: unknown): ParentNode {
 
 expect.extend({
   toHaveValidTabOrder(received: unknown, options?: AuditOptions) {
+    assertRealBrowser();
     const root = resolveRoot(received);
     const result: AuditResult = audit(root, options);
     const { isNot } = this;