DEV Community

Discussion on: Towards a JavaScript API Specification

kurtgokhan profile image
Gökhan Kurt

Are you ultimately planning a specification like WSDL? My favourite feature of WSDL is that you can generate C# classes from the web service definition. A similar thing would be nice in Js/Ts.

miralemd profile image
Miralem Drek Author

I wouldn't really compare it to WSDL - It's more like type definitions in TypeScript, but for JavaScript.

One of biggest issues with typings today is that the majority of them are tediously written by hand, which means that whenever a new version of a library written in JavaScript is published, someone needs to update its typings manually (on e.g. DefinitelyTyped).

By having a specification of the API we could automate the process of generating typings, reference documentation as well as get a quick overview of the API changes between releases.