This tool is used to generate
dom.iterable.generated.d.ts for TypeScript.
The input file is the JSON webidl file generated by the Microsoft Edge browser.
To get things setup:
To generate the
npm run build
npm run test
dom.iterable.generated.d.ts files from the TypeScript repo are used as baselines.
For each pull request, we will run the script and compare the generated files with the baseline files.
In order to make the tests pass, please update the baseline as well in any pull requests.
It's recommended to first check which spec the wrong type belongs to. Say we are to update
IntersectionObserver which belongs to
Intersection Observer spec, and then we can do:
- First check we have the spec name
inputfiles/idlSources.json. If not, add it.
npm run fetch-idl "Intersection Observer" && npm run build && npm run baseline-accept.
If the above didn't fix the type issues, we can fix them via json files as a last resort.
There are three json files that are typically used to alter the type generation:
comments.json can used to add comments to the types.
knownTypes.json determine which types are available in a certain environment in case it couldn't be automatically determined.
The format of each file can be inferred from their existing content.
The common steps to send a pull request are:
- Open or refer to an issue in the TypeScript repo.
- Add missing elements to
inputfiles/addedTypes.json, overriding elements to
inputfiles/overridingTypes.json, or elements to remove to
- Run the build script locally to obtain new
- Update the files in the
baselinesfolder using the newly generated files under
npm run baseline-accept).
When should a DOM API be included here?
A feature is considered highly experimental if a DOM API lacks multiple implementations or a formal specification from W3C or WHATWG. Such a feature belongs on DefinitelyTyped. When it gets multiple implementations and a proper specification, it can be added here and removed from DefinitelyTyped.
src/index.ts: handles the emitting of the
src/test.ts: verifies the output by comparing the
browser.webidl.preprocessed.json: a JSON file generated by Microsoft Edge. Do not edit this file.
- Due to the different update schedules between Edge and TypeScript, this may not be the most up-to-date version of the spec.
mdn/apiDescriptions.json: a JSON file generated by fetching API descriptions from MDN. Do not edit this file.
addedTypes.json: types that should exist in either browser or webworker but are missing from the Edge spec. The format of the file mimics that of
overridingTypes.json: types that are defined in the spec file but has a better or more up-to-date definitions in the json files.
removedTypes.json: types that are defined in the spec file but should be removed.
comments.json: comment strings to be embedded in the generated .js files.