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.ts
files typically accessed inside TypeScript are now also deployed to@types/web
starting with version0.0.1
which corresponds to the version oflibdom.d.ts
in TypeScript 4.3. This means an update to TypeScript 4.4 does not mean you have to update all of your web.d.ts
files.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/web
reflects that. If you're interested in switching to use@types/web
, there are instructions in the npm README. -
The 4.4
dom.d.ts
file 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-generator
channel 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