Microsoft/vscode

BUG: No description for JS classes/methods in `script` tag for `html` file

Open

#268776 opened on Sep 28, 2025

View on GitHub
 (3 comments) (0 reactions) (1 assignee)TypeScript (74,848 stars) (10,221 forks)batch import
bughelp wantedhtml

Description

Does this issue occur when all extensions are disabled?: Yes

  • VS Code Version: 1.104.2
  • OS Version: Windows_NT x64 10 Commit: e3a5acfb517a443235981655413d566533107e92

Steps to Reproduce

  1. Lets have a code:
<!DOCTYPE html>
<html lang="en">

<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Document</title>
</head>

<body>
    <script>
        const dt = new DataTransfer();
    </script>

</body>

</html>
  1. Hover mouse cursor over DataTransfer constructor.

ER

Will be displayed JSDoc with description text and link to online docs (mdn) from lib.dom.d.ts as it is declared:

/**
 * The **`DataTransfer`** object is used to hold any data transferred between contexts, such as a drag and drop operation, or clipboard read/write.
 *
 * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DataTransfer)
 */
interface DataTransfer {
...

AR

No JSDoc description and no link to online docs (mdn)

Contributor guide

Tech stack
typescripthtmljavascript
Domain
developer experiencedocumentation
Issue type
bug
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-3 hours
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
blocked
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
Understanding of VS Code extension architectureFamiliarity with HTML language service
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
35
Research direction
Investigate how VS Code's HTML language service provides hover information for JavaScript inside script tags. The issue likely stems from the fact that the JavaScript language service is not being consulted for JSDoc descriptions when inside a <script> tag in an HTML file. Look at the source code in src/vs/languages/html/ or the TypeScript service integration. Check the comments on the issue for any proposed solutions or related PRs.