fix: add hint for missing `document` global in terminal error (#26218)

This came up on Discord as a question so I thought it's worth adding a
hint for this as it might be a common pitfall.

---------

Signed-off-by: Bartek Iwańczuk <biwanczuk@gmail.com>
Co-authored-by: David Sherret <dsherret@users.noreply.github.com>

6 files changed, 52 insertions, 0 deletions

diff --git a/tests/specs/run/document/__test__.jsonc b/tests/specs/run/document/__test__.jsonc
new file mode 100644
index 000000000..cf20f9e1b
--- /dev/null
+++ b/tests/specs/run/document/__test__.jsonc
@@ -0,0 +1,9 @@
+{
+  "tests": {
+    "document": {
+      "args": "run document.js",
+      "exitCode": 1,
+      "output": "document.out"
+    }
+  }
+}
diff --git a/tests/specs/run/document/document.js b/tests/specs/run/document/document.js
new file mode 100644
index 000000000..63e43b72f
--- /dev/null
+++ b/tests/specs/run/document/document.js
@@ -0,0 +1 @@
+document.querySelector("div");
diff --git a/tests/specs/run/document/document.out b/tests/specs/run/document/document.out
new file mode 100644
index 000000000..eefedb8f2
--- /dev/null
+++ b/tests/specs/run/document/document.out
@@ -0,0 +1,8 @@
+error: Uncaught (in promise) ReferenceError: document is not defined
+document.querySelector("div");
+^
+    at [WILDCARD]document.js:1:1
+
+    info: document global is not available in Deno.
+    hint: Use a library like happy-dom, deno_dom, linkedom or JSDom
+          and setup the document global according to the library documentation.
diff --git a/tests/specs/test/document/__test__.jsonc b/tests/specs/test/document/__test__.jsonc
new file mode 100644
index 000000000..cf73b4bab
--- /dev/null
+++ b/tests/specs/test/document/__test__.jsonc
@@ -0,0 +1,9 @@
+{
+  "tests": {
+    "document": {
+      "args": "test document_test.js",
+      "exitCode": 1,
+      "output": "document_test.out"
+    }
+  }
+}
diff --git a/tests/specs/test/document/document_test.js b/tests/specs/test/document/document_test.js
new file mode 100644
index 000000000..d60d6893c
--- /dev/null
+++ b/tests/specs/test/document/document_test.js
@@ -0,0 +1,3 @@
+Deno.test("document query selector", () => {
+  document.querySelector("div");
+});
diff --git a/tests/specs/test/document/document_test.out b/tests/specs/test/document/document_test.out
new file mode 100644
index 000000000..342cee0e4
--- /dev/null
+++ b/tests/specs/test/document/document_test.out
@@ -0,0 +1,22 @@
+running 1 test from ./document_test.js
+document query selector ... FAILED [WILDCARD]
+
+ ERRORS 
+
+document query selector => ./document_test.js:1:6
+error: ReferenceError: document is not defined
+  document.querySelector("div");
+  ^
+    at [WILDCARD]document_test.js:2:3
+
+    info: document global is not available in Deno.
+    hint: Use a library like happy-dom, deno_dom, linkedom or JSDom
+          and setup the document global according to the library documentation.
+
+ FAILURES 
+
+document query selector => ./document_test.js:1:6
+
+FAILED | 0 passed | 1 failed ([WILDCARD])
+
+error: Test failed