Typescript... or jsdocs ?
T
A Web Developer based in Belgium, specialized in PHP & JS development
Command Palette
Search for a command to run...
Comments (2)
Join the discussionN
Nenad Vićentić1y ago
While I wholeheartedly agree with you on Tailwind vs modern CSS, this is different case.
All the functionality you are using via JSDocs is enabled and implemented by TypeScript compiler (probably the one built-in into Visual Studio Code?). Using JSDocs gives you only the advantage that you don't have to transpile source files.
But, since you are already using ESBuild for minification and source-maps, you could have used TypeScript syntax, instead of JSDocs as well. Also, your jsconfig.json is derivate of tsconfig.json.
There is a nice post from Rob Eisenberg how to integrate full TypeScript compiler with ESBuild: "An ESBuild Setup for TypeScript"
Also, if you follow trends, NodeJS can now execute TypeScript files out of the box. For example: node --experimental-strip-types build/copy-files.mts. Even ESBuild can handle "simple" TypeScript files without a full TypeScript compiler.
But the point you are right about - mapping types, npm packages, etc... can become quite complicated. Specially because NMP/Node support multiple standard and non-standard JavaScript module types.
So, unlike Tailwind, TypeScript has usefull functionality that does not exist in native JavaScript. And it seems that all the industry is converging on idea that some kind of type notation should exist in JavaScript natively.
1
T
Thomas Portelange1y ago
While I might just as well use Typescript since I have all the tooling in place, it would bring very little benefits over using a couple of jsdocs tags (for me, and for my use cases, anyway.. i can very well understand in larger projects or with a team that typescript makes more sense). Using typescript also forces you to follow updates or potential breaking changes... one less thing to worry about for me :-) But maybe some day I will see a decisive benefit and decide to switch, who knows :-D
N
Nenad Vićentić1y ago
Thomas Portelange That's fine. I am not trying to persue you to change coding style that makes you more productive. And you, clearly, do the coding well.
I'm pointing out that both Typescript and JSDoc types are powered by the same TypeScript Language Service in your code editor. Which means that even when using JavaScript with JSDoc types, you are actually using TypeScript engine under the hood. Only in a "light" mode that suits your preferences.
1
T
Thomas Portelange1y ago
Nenad Vićentić ;-) I might give it a test run and see how it goes in one of my project, i'm really curious to see if that would make me "more productive" but I'm not really sure that will be the case
1
P
Philip Birk-Jensen2y ago
I have the same philosophy when it comes to bundlers and transpilers.
With the browsers developer tools being so awesome a debugging (and prototyping) environment, I feel having a 1:1 with what I write and the devtools is very strong. I know source maps can mitigate some of this, but for me it's more of a hassle than a benefit.
Anyway, great write up! I have linked to this post in my own recent post (shameless plug incoming) about documenting a callback: https://blog.birk-jensen.dk/documenting-a-callback-function-in-jsdoc.
1
More from this blog
A git diff with all changed and new unstaged files
I recently needed to collect all changes in one file for reporting purposes. Found this article: https://ratfactor.com/cards/git-diff-with-new-files In case you need something similar on Windows, here
Jul 27, 20261 min read
Writing a Zero-Dependency CSV and XLSX Reader/Writer
Some projects start with a grand plan. Others start because you just need to read a file without thinking too much about it. That was the case for spread-compat. I needed a common interface for CSV, X
Mar 6, 20265 min read
Media Queries Level 5 are awesome
With modern css, you can almost get rid of sass. But there is one last pain point : media queries. Not being able to use variables or an easy, common syntax for typical breakpoints is really annoying. That is, until you meet Media Queries Level 5. I’...
Oct 10, 20253 min read
Modern tooltips
This is a quick article to share this demo I just made. https://codepen.io/lekoalabe/pen/JoPNWpX
Dec 20, 20241 min read
Using Dialog elements today
Modals are typical UI elements for many web apps. There are countless packages dedicated to that specific features, each framework creating its own variation. Popular frameworks like Bootstrap also have custom code to deal with it. But all this feels...
Oct 29, 20243 min read
