microsoft / microsoft/monaco-editor

[Bug] [LSP] MonacoLspClient never disposes its language-feature registrations

Open
#5,340 0 comments 0 reactions 1 assignee View on GitHub

@hediet is already working on this.

Since Jun 1, 2026.

Dominant language
JavaScript
Stars
46.8k
Forks
4.1k
Avg merge
17h 58m
Merged PRs (30d)
1

Description

Reproducible in vscode.dev or in VS Code Desktop?
  • Not reproducible in vscode.dev or VS Code Desktop
Reproducible in the monaco editor playground?
Monaco Editor Playground Link
Summary

MonacoLspClient registers Monaco language providers (hover, code-actions, definition, completion, …) through its LspXxxFeature instances when it is constructed, but it exposes no way to release them. The DisposableStore returned by createFeatures() is discarded at the call site, and the class has no dispose() method — so the registrations remain alive in monaco.languages.* for the lifetime of the page even after the underlying transport is closed.

Reproduction
  1. Construct new MonacoLspClient(transportA) for some language. Confirm monaco.languages.registerHoverProvider, …registerCodeActionProvider, etc. are now active (empirically: hover a symbol in a matching model; or instrument monaco.languages.register* to count calls).
  2. Drop the only reference to the client and close transportA (e.g. transportA.close() on a WebSocketTransport).
  3. Construct new MonacoLspClient(transportB) with a fresh transport for the same language. Hover a symbol.

Observed: Monaco aggregates across all registered providers and awaits each one. The first client's providers are still installed; their requests reach LspConnection.server.hover(...) over the closed transport and never resolve. Monaco shows a permanent "Loading…" entry in the hover widget alongside the response from the new client. The code-action lightbulb has the same symptom — stale providers contribute uncancellable pending promises to the aggregated list.

This is a real repro from embedding MonacoLspClient in a React component whose mount/unmount cycle creates and tears down the LSP session.

Root cause

monaco-lsp-client/src/adapters/LspClient.ts:46MonacoLspClient.constructor:

this.createFeatures();    // returns IDisposable, value discarded

monaco-lsp-client/src/adapters/LspClient.ts:62-89createFeatures():

protected createFeatures(): IDisposable {
    const store = new DisposableStore();
    store.add(new LspCompletionFeature(this._connection));
    // ... 21 more features ...
    return store;
}

Each LspXxxFeature extends Disposable and calls monaco.languages.registerXxxProvider(...) in its constructor, adding the returned disposable to its own internal _store. Disposing the store returned by createFeatures() would cascade through every feature's dispose()_store.dispose() → every registerXxxProvider disposable. But the store is dropped on the floor, and the class has no dispose() to wire it up.

Fix

MonacoLspClient should implement Disposable.

Why this matters

Any embedder with a component lifecycle (React, Vue, Solid, Lit, …) hits this. Workarounds require monkey-patching the prototype to capture the discarded store, which is not pleasant.

The LSP spec doesn't have an opinion on client teardown — this is purely a Monaco-side hygiene issue.

Monaco Editor Playground Code

Reproduction Steps

No response

Actual (Problematic) Behavior

No response

Expected Behavior

No response

Additional Context

No response

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.