Microsoft/TypeScript

Provide lib for modern DOM

Open

#21,150 opened on Jan 11, 2018

View on GitHub
 (6 comments) (5 reactions) (0 assignees)TypeScript (48,455 stars) (6,726 forks)batch import
Domain: lib.d.tsExperience EnhancementHelp WantedSuggestion

Description

This is basically a re-opening of #2910, which @mhegazy asked me to do.

Nowadays TS has the lib compiler option that allow users to selectively choose which core definitions to include or not based on their target.

It would be nice to add a new option similar to dom and dom.iterable for users targetting a modern DOM runtime. Not sure how to name this since W3C has moved from releases to a "living standard" model.

For example, the living standard includes interfaces ChildNode with methods after, before, remove and replaceWith; ParentNode with methods prepend and append.

Those methods have been in Firefox and Chrome for a long while, they're in preview in Edge (17035+).

They are very convenient and there's no reason a dev that targets modern browsers shouldn't be able to do "lib": "dom.living" and use them.

Unfortunately I am not sure if there's a list somewhere of all those new features... except going through the whole standard :(

Contributor guide

Tech stack
typescript
Domain
developer experiencetooling
Issue type
feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-2 days
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
stale
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
mostly clear
Prerequisites
TypeScript compiler knowledgeDOM specification understanding
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
20
Research direction
Investigate the existing lib files in TypeScript source (e.g., lib.dom.d.ts) and identify which modern DOM APIs are missing. Propose a list of interfaces and methods that should be included in a new 'dom.living' lib. Consult the linked issue #2910 for prior discussion. Determine the naming convention and whether to base it on a specific browser version or the living standard.
Provide lib for modern DOM · Microsoft/TypeScript#21150 | Good First Issue