TypeScript 4.4 libdom changes #1029
Description
Beta
With TypeScript 4.4, we coordinated some pretty fundamental infrastructure work to prepare for the version of dom.d.ts with the future of the generator repo. This work resulted in two note-worthy items:
-
The
dom.d.tsfiles typically accessed inside TypeScript are now also deployed to@types/webstarting with version0.0.1which corresponds to the version oflibdom.d.tsin TypeScript 4.3. This means an update to TypeScript 4.4 does not mean you have to update all of your web.d.tsfiles.The name change is to more accurately reflect the scope of the APIs, for a long time the file has provided much more APIs than just the DOM and
@types/webreflects that. If you're interested in switching to use@types/web, there are instructions in the npm README. -
The 4.4
dom.d.tsfile which is included with TypeScript includes quite a lot of changes, with a lot of APIs which have been marked as deleted by the web standards committees. You can see the full list in this issueWe've been testing these changes with DefinitelyTyped, and have been individually rolling back changes which we think are a bit too breaking, this is more of an art than a science however. If you think we should rollback a particular change we're open to discussing change in this issue or the
dom-lib-generatorchannel in the TypeScript Community Discord
We plan to have thorough support for replacing lib.dom.d.ts with @types/web in 4.5 with microsoft/TypeScript#44795