[Web API type definition issue] HTMLDocument shouldn't be deprecated

[Bashamega]

Summary

For some reson Typescript says HTMLDocument is deprecated, but it is not

Expected vs. Actual Behavior

Even though MDN says it is widely available, TypeScript says it is deprecated.

Playground Link

https://www.typescriptlang.org/play/?#code/CYewxgrgtgpgdgFwAQEs4GcEEM5hiAMyQAkAVAWQBkARcaeBIA

Browser Support

• This API is supported in at least two major browser engines (not two Chromium-based browsers).

Have Tried The Latest Releases

• This issue applies to the latest release of TypeScript.
• This issue applies to the latest release of @types/web.

Additional Context

No response

[jakebailey]

It exists widely doesn't necessarily mean it's good to use; I would double check the history to understand why this was deprecated.

[Bashamega]

It exists widely doesn't necessarily mean it's good to use; I would double check the history to understand why this was deprecated.

It is true that it is not the best option to use in modern days, but browsers support it according to MDN.

Also, sometimes we need to use it. These are some use cases
1 - Accessing HTML-Specific Properties or Methods
2 - Type Narrowing for Specific Document Types
3 - Custom HTML Document Handling

[saschanaz]

HTMLDocument is just an alias of Document and it's correct that it shouldn't be used.

[saschanaz]

That said, browsers haven't follow the deprecation and still have HTMLDocument, and per whatwg/dom#221 the consensus seems to be that the deprecation isn't worth doing. Maybe we should follow the consensus.