I'm writing this so you don't make the same mistake as our team. Without knowing how much impact type assertions would have, our team started to use them everywhere.
This started out great. We had type-safety in our code, and we felt safe to future changes. At least, we thought so.
In retrospect, we now know that we had created a false sense of security. We had created a safety net with a lot of holes, which defeats the purpose of having a safety net.
To give a simple example, let's first take a quick look at the
Now, let's see how we used type assertions to create a new customer instance.
This code has two problems concerning the correctness of these objects when the respective type is changed:
- new properties that are required aren't caught;
- existing properties that are removed aren't flagged;
The simple fix is to ditch the type assertions and to replace them with type annotations and return types.
With the updated snippet, we now get correct and helpful compile errors when the type is modified.
To enforce this practice, you can enable the ESLint rule Enforces consistent usage of type assertions (consistent-type-assertions).
Fiddle with this example in the following TypeScript playground.
Feel free to update this blog post on GitHub, thanks in advance!
I appreciate it if you would support me if have you enjoyed this post and found it useful, thank you in advance.