Warn when JSDoc type cast misses parentheses

Search Terms

jsdoc. type cast

Suggestion

JSDoc type cast currently requires parentheses for technical reasons (#18212), but it does not warn when they don't exist.

Use Cases

// This doesn't work, the JSDoc comment is silently ignored
// A warning message will help.
const img = /** @type {HTMLImageElement} */ document.getElementById('#cat')
img.src = 'cat.gif'

Examples

const img = /** @type {HTMLImageElement} */ document.getElementById('#cat')
            ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
            ^ Warning: The JSDoc type cast misses parentheses and is being ignored
img.src = 'cat.gif'

Checklist

My suggestion meets these guidelines:

• This wouldn't be a breaking change in existing TypeScript/JavaScript code
• This wouldn't change the runtime behavior of existing JavaScript code
• This could be implemented without emitting different JS based on the types of the expressions
• This isn't a runtime feature (e.g. library functionality, non-ECMAScript syntax with JavaScript output, etc.)
• This feature would agree with the rest of TypeScript's Design Goals.

Bắt đầu với việc xử lý ép kiểu JSDoc được mô tả trong issue và issue được tham chiếu #18212, sau đó tìm chẩn đoán và các bài kiểm thử hồi quy liên quan. Thay đổi được hoàn tất khi một phép ép kiểu thiếu dấu ngoặc đơn tạo ra cảnh báo được hiển thị mà không thay đổi đầu ra JavaScript, trong khi các phép ép kiểu có dấu ngoặc đơn vẫn giữ nguyên hành vi hiện tại.