Microsoft/TypeScript
lib.dom.d.ts should escape html elements in jsdoc comments
オープン
#44,038 opened on 2021/05/11
Experience EnhancementHelp WantedSuggestion
Repository metrics
- Stars
- (108,860 個のスター)
- PR merge metrics
- (PR metrics pending)
説明
lib Update Request
Configuration Check
My compilation target is ES2020 and my lib is the default.
Missing / Incorrect Definition
For html elements such as HTMLScriptElement, the JSDoc includes <script>. This causes VS Code to drop the entire body of the comment
Sample Code
const a: HTMLScriptElement // hover over HTMLScriptElement
Proposal
These JSDoc comments should escape any html in the comments. I suggest using markdown inline code instead:
/** HTML `<script>` elements expose the HTMLScriptElement interface ... */
interface HTMLScriptElement extends HTMLElement {