[BUG] ServiceWorker Registration Error: "InvalidStateError: Failed to register a ServiceWorker: The document is in an invalid state"

[andrijaster]

Problem (one or two sentences)

When opening the extension’s webview, VS Code displays the following error:

Error loading webview: Error: Could not register service worker: InvalidStateError: Failed to register a ServiceWorker: The document is in an invalid state.

Context (who is affected and when)

I can see this with new VScode update

Reproduction steps

1. Start VScode and try to import Roo Code

Expected result

RooCode should work

Actual result

The webview fails to initialize, and the above error is shown instead of the extension UI.

Variations tried (optional)

No response

App Version

the newest one

API Provider (optional)

None

Model Used (optional)

No response

Roo Code Task Links (optional)

No response

Relevant logs or errors (optional)

I'm investigating this ServiceWorker registration error. Let me explore the codebase to understand how the extension uses ServiceWorkers and propose a fix.

I've analyzed this issue and here's my proposed implementation plan:

Root Cause

The error occurs because VS Code webviews have restrictions on ServiceWorker registration. The webview is attempting to register a ServiceWorker, which is not allowed in the VS Code webview security context.

Proposed Solution

After examining the codebase, I found that:

1. The extension itself doesn't explicitly use ServiceWorkers
2. The error is likely coming from a third-party dependency that's trying to register a ServiceWorker

The fix involves:

1. Identify the source: Check if any dependencies (like PostHog analytics or other libraries) are attempting to register ServiceWorkers
2. Add detection and prevention: Add code to detect the VS Code webview environment and prevent ServiceWorker registration attempts
3. Update CSP if needed: Ensure the Content Security Policy doesn't inadvertently allow ServiceWorker registration

Implementation Approach

1. Add a check in the webview initialization code to disable ServiceWorker registration
2. Mock or override navigator.serviceWorker in the webview context
3. Test with the latest VS Code version to ensure the fix works

This approach will prevent the error without affecting the extension's functionality, as ServiceWorkers aren't required for the core features.

Please mention @roomote in a comment saying that you approve this plan, and I'll proceed with the implementation.

[andrijaster]

@roomote This plan sounds good to me, please go ahead with the implementation. Thanks!

I've seen your comment and will explore a potential fix. I'll open a PR to share progress.

Opened a PR with my attempt at addressing this. Feedback welcome!

PR: #9904

The implementation includes:

• Early prevention of ServiceWorker registration in the VS Code webview environment
• Mock ServiceWorker API that safely rejects registration attempts
• Updated PostHog configuration to disable features that might use ServiceWorkers
• Comprehensive tests to ensure the fix works correctly

All tests pass and the build completes successfully. The fix only affects the VS Code webview environment and does not impact regular browser usage.

[hannesrudolph]

Apologies for the delayed response.

There have been no recent reports or a current repro in this thread, so treating this as resolved.

If it still reproduces on current VS Code and the latest Roo Code extension, open a new issue with repro steps, expected vs actual, and versions (Roo Code extension, VS Code, OS).