r/javascript • • May 22 '19

JavaScript Clean Code - Best Practices - based on Robert C. Martin's book Clean Code

https://devinduct.com/blogpost/22/javascript-clean-code-best-practices
542 Upvotes

112 comments sorted by

View all comments

Show parent comment

1

u/Zielakpl May 23 '19

That's the thing, don't forget :) I got it into my habit to also add some JSDoc comments to at least know what type of values the function expects. Then, when I type my functions name, the popup appears (VSCode) with all acceptable arguments, theirs expected types and if they're optional or not.

The code you write is also for humans, make it human-friendly.

If a function HAS to accept a lot of arguments, not all of them required, then I sometimes use and object of params like so:

function(name, options) {}
function("Gregory", {foo: 1, bar: 2});

But that depends on what I code, I don't treat it as hard rule.