Skip to content

Docs/jest warning frontend tests#1148

Open
JITENDRAGAHERWAR03 wants to merge 5 commits intoAOSSIE-Org:mainfrom
JITENDRAGAHERWAR03:docs/jest-warning-frontend-tests
Open

Docs/jest warning frontend tests#1148
JITENDRAGAHERWAR03 wants to merge 5 commits intoAOSSIE-Org:mainfrom
JITENDRAGAHERWAR03:docs/jest-warning-frontend-tests

Conversation

@JITENDRAGAHERWAR03
Copy link

@JITENDRAGAHERWAR03 JITENDRAGAHERWAR03 commented Feb 4, 2026

Summary

Adds documentation clarifying a common Jest warning that appears after successful frontend test runs.

Details

When running frontend tests, Jest may print the warning:

“Jest did not exit one second after the test run has completed.”

All tests still pass successfully, and the application functions as expected. This warning is typically caused by open async handles such as timers, watchers, or dev-server related processes and does not indicate a test failure.

Without clarification, this message can confuse new contributors into thinking the test suite or setup is broken.

This PR adds a short troubleshooting note explaining:

  • Why the warning appears
  • When it is safe to ignore
  • How contributors can optionally debug it using --detectOpenHandles

Scope

  • 📄 Documentation only
  • ❌ No code changes

Testing

  • Frontend tests executed successfully on Windows 11

Related Issue

Closes #1137

Summary by CodeRabbit

  • Documentation
    • Clarified that ONNX Runtime warnings on Windows 11 are harmless and do not indicate compatibility issues; guidance added to safely ignore the message.
    • Documented Jest’s non-fatal “did not exit” warning after frontend tests, described possible causes, and added debugging guidance (e.g., running tests with --detectOpenHandles).

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Feb 4, 2026

📝 Walkthrough

Walkthrough

Added two advisory notes to the Manual Setup Guide: one explaining a benign ONNX Runtime Windows 11 OS-version warning, and one documenting a non-failing Jest "did not exit one second" warning after successful frontend tests with a debugging hint.

Changes

Cohort / File(s) Summary
Documentation
docs/Manual_Setup_Guide.md
Added notes describing a harmless ONNX Runtime OS-version warning on Windows 11 and a non-failing Jest "did not exit one second after the test run" message after frontend tests, including a debugging hint (npm test -- --detectOpenHandles).

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

🐰 I nibbled through docs in a blink,
Two tiny warnings — no need to think,
ONNX hums on Windows fine,
Jest finishes — tests all shine,
Hop on, contributor, give a wink! 🥕

🚥 Pre-merge checks | ✅ 4 | ❌ 2
❌ Failed checks (1 warning, 1 inconclusive)
Check name Status Explanation Resolution
Merge Conflict Detection ⚠️ Warning ❌ Merge conflicts detected (30 files):

⚔️ .github/workflows/build-and-release.yml (content)
⚔️ .github/workflows/pr-check-build.yml (content)
⚔️ backend/app/config/settings.py (content)
⚔️ backend/main.py (content)
⚔️ backend/requirements.txt (content)
⚔️ docs/Manual_Setup_Guide.md (content)
⚔️ docs/backend/backend_python/openapi.json (content)
⚔️ frontend/src-tauri/Cargo.lock (content)
⚔️ frontend/src-tauri/Cargo.toml (content)
⚔️ frontend/src-tauri/capabilities/migrated.json (content)
⚔️ frontend/src-tauri/src/main.rs (content)
⚔️ frontend/src/components/EmptyStates/EmptyGalleryState.tsx (content)
⚔️ frontend/src/components/Media/MediaInfoPanel.tsx (content)
⚔️ frontend/src/components/Media/MediaView.tsx (content)
⚔️ frontend/src/components/Media/MediaViewControls.tsx (content)
⚔️ frontend/src/components/Media/NavigationButtons.tsx (content)
⚔️ frontend/src/components/Navigation/Sidebar/AppSidebar.tsx (content)
⚔️ frontend/src/hooks/useSlideshow.ts (content)
⚔️ frontend/src/layout/layout.tsx (content)
⚔️ frontend/src/main.tsx (content)
⚔️ landing-page/src/Pages/Demo/marqu.tsx (content)
⚔️ landing-page/src/Pages/FaqPage/FAQ.tsx (content)
⚔️ landing-page/src/Pages/Footer/Footer.tsx (content)
⚔️ landing-page/src/Pages/HowItWorks/HowItWorks.tsx (content)
⚔️ landing-page/src/Pages/Landing page/Home1.tsx (content)
⚔️ landing-page/src/Pages/pictopy-landing.tsx (content)
⚔️ mkdocs.yml (content)
⚔️ sync-microservice/app/config/settings.py (content)
⚔️ sync-microservice/main.py (content)
⚔️ sync-microservice/requirements.txt (content)

These conflicts must be resolved before merging into main.
Resolve conflicts locally and push changes to this branch.
Title check ❓ Inconclusive The title 'Docs/jest warning frontend tests' is partially related to the changeset; it refers to Jest warnings and frontend tests, but is somewhat vague and doesn't clearly convey that the main change is adding documentation about a specific Jest warning that appears after successful test runs. Consider a more specific title like 'Add Jest warning troubleshooting guide to frontend tests documentation' to better clarify the primary change.
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Linked Issues check ✅ Passed The pull request successfully addresses all coding-related objectives from issue #1137: documents the Jest warning behavior, explains the harmless nature when tests pass, provides troubleshooting guidance with --detectOpenHandles, and reduces contributor confusion through clear documentation.
Out of Scope Changes check ✅ Passed All changes are directly within scope—the pull request adds only documentation to explain the Jest warning issue, with no unrelated modifications or extraneous content beyond the stated objectives.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
⚔️ Resolve merge conflicts (beta)
  • Auto-commit resolved conflicts to branch docs/jest-warning-frontend-tests
  • Post resolved changes as copyable diffs in a comment

No actionable comments were generated in the recent review. 🎉

🧹 Recent nitpick comments
docs/Manual_Setup_Guide.md (3)

187-188: Consider formatting the warning message as a code block.

The warning text could be formatted as a code block or blockquote to visually distinguish it from the explanation text, improving readability.

💡 Suggested formatting improvement
 While running backend tests or starting the PictoPy backend on Windows 11, you may see a warning similar to:
 
-UserWarning: Unsupported Windows version (11).
-ONNX Runtime supports Windows 10 and above.
+```
+UserWarning: Unsupported Windows version (11).
+ONNX Runtime supports Windows 10 and above.
+```
 
 This warning is **harmless**. If backend tests pass successfully and the application runs as expected, the setup is working correctly.

198-198: Consider formatting the warning message as a code block.

The Jest warning text could be formatted as a code block or blockquote to visually distinguish it from the explanation, maintaining consistency with typical documentation patterns for error/warning messages.

💡 Suggested formatting improvement
 While running frontend tests, you may see the following warning:
 
-Jest did not exit one second after the test run has completed.
+```
+Jest did not exit one second after the test run has completed.
+```
 
 
 This warning does **not** indicate a test failure. All tests may still pass successfully.

201-201: Clarify test success statement.

The phrase "may still pass successfully" introduces unnecessary uncertainty. Since the section heading states "after successful frontend tests," the tests have already passed. Consider rephrasing for clarity.

✨ Suggested wording improvement
-This warning does **not** indicate a test failure. All tests may still pass successfully.
+This warning does **not** indicate a test failure. Tests pass successfully despite this warning.

Tip

Issue Planner is now in beta. Read the docs and try it out! Share your feedback on Discord.


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Fix all issues with AI agents
In `@docs/Manual_Setup_Guide.md`:
- Line 183: The markdown heading "### ONNX Runtime warning on Windows 11 (safe
to ignore)" has leading spaces; remove the leading spaces so the heading starts
at column 0 (i.e., change the line to begin with "### ONNX Runtime warning on
Windows 11 (safe to ignore)") to comply with Markdown conventions and fix the
indentation.
- Line 203: Update the compound modifier "dev-server related" to the hyphenated
form "dev-server-related" in the sentence containing "open async handles such as
timers, watchers, or dev-server related processes" so the phrase reads
"...timers, watchers, or dev-server-related processes."; edit the Markdown line
where that phrase appears and ensure spacing and punctuation remain correct.
🧹 Nitpick comments (1)
docs/Manual_Setup_Guide.md (1)

207-207: Format the npm command as a code block.

For consistency with other commands in the documentation, the npm command should be formatted as a code block.

📝 Proposed fix
 For debugging purposes, contributors can optionally run:
-npm test -- --detectOpenHandles
+```bash
+npm test -- --detectOpenHandles
+```


For other systems, consult your distribution's documentation.

### ONNX Runtime warning on Windows 11 (safe to ignore)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Fix heading indentation.

The heading has leading spaces, which violates markdown conventions. Headings should start at the beginning of the line (column 0).

📝 Proposed fix
-  ### ONNX Runtime warning on Windows 11 (safe to ignore)
+### ONNX Runtime warning on Windows 11 (safe to ignore)
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
### ONNX Runtime warning on Windows 11 (safe to ignore)
### ONNX Runtime warning on Windows 11 (safe to ignore)
🧰 Tools
🪛 markdownlint-cli2 (0.20.0)

[warning] 183-183: Headings must start at the beginning of the line

(MD023, heading-start-left)

🤖 Prompt for AI Agents
In `@docs/Manual_Setup_Guide.md` at line 183, The markdown heading "### ONNX
Runtime warning on Windows 11 (safe to ignore)" has leading spaces; remove the
leading spaces so the heading starts at column 0 (i.e., change the line to begin
with "### ONNX Runtime warning on Windows 11 (safe to ignore)") to comply with
Markdown conventions and fix the indentation.

@JITENDRAGAHERWAR03
Copy link
Author

JITENDRAGAHERWAR03 commented Feb 15, 2026

Hi @rahulharpal1603 — changes are docs-only and ready to merge (CodeRabbit nitpick fixed).
The PR is blocked by “1 workflow awaiting approval”. Could someone please approve the workflow so remaining checks can run? Thank you!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

DOC: Jest warning shown after successful frontend tests (“Jest did not exit one second after the test run”)

1 participant