Require Parameters for JavaScript Functions

By  on  

JavaScript is notorious for being "loose", something that some developers love but other developers loathe.  I hear most of those complaints from server side developers, who want string typing and syntax.  While I like strict coding standards, I also like that JavaScript lets me quickly prototype without having to cross the I's and dot the T's.  Until recently you couldn't define default parameter values for functions in JavaScript, but now you can!

When I posted last week about Six Tiny but Awesome ES6 Features, an awesome reader (cmwd) pointed out that you can not only set default function parameter values but you can throw errors when a given parameter isn't provided to a function:

const isRequired = () => { throw new Error('param is required'); };

const hello = (name = isRequired()) => { console.log(`hello ${name}`) };

// This will throw an error because no name is provided
hello();

// This will also throw an error
hello(undefined);

// These are good!
hello(null);
hello('David');

I love this tip -- it shows how with each addition to JavaScript we can stretch the language to do interesting things.  How practical it is to throw errors in production is up to you but this is an awesome ability during development.  Happy coding!

Recent Features

  • By
    Responsive and Infinitely Scalable JS Animations

    Back in late 2012 it was not easy to find open source projects using requestAnimationFrame() - this is the hook that allows Javascript code to synchronize with a web browser's native paint loop. Animations using this method can run at 60 fps and deliver fantastic...

  • By
    fetch API

    One of the worst kept secrets about AJAX on the web is that the underlying API for it, XMLHttpRequest, wasn't really made for what we've been using it for.  We've done well to create elegant APIs around XHR but we know we can do better.  Our effort to...

Incredible Demos

  • By
    background-size Matters

    It's something that makes all men live in fear, and are often uncertain of. It's never spoken, but the curiosity is always there. Nine out of ten women agree in the affirmative. Advertisers do their best to make us feel inadequate but...

  • By
    MooTools FontChecker Plugin

    There's a very interesting piece of code on Google Code called FontAvailable which does a jQuery-based JavaScript check on a string to check whether or not your system has a specific font based upon its output width. I've ported this functionality to MooTools. The MooTools...

Discussion

  1. decksterr

    Would it still show an exception for say hello(undefined) ? or hello(null) ?

    Just curious, not having set up any ES6 environment yet …

  2. Yes for undefined, no for null (“Hello null”)

  3. Augusto Borges de Moura

    With Method Parameter Decorators proposal, you can even do function (@Required arg) {...}

  4. One trick to do with required params is using TypeError instead of “plain” Error. If you try to call one of the builtin functions without the right amount of params, you’ll get a TypeError, so makes sense to have custom code do that too :)

  5. Adam van den Hoven

    its a little verbose, but you could pass the parameter name into isRequired to get better error messages.

  6. Interesting! And apparently arguments is already available to the default function parameter: https://jsfiddle.net/2447ksz7/

  7. Valtteri

    To get rid of the parenthesis:

    Object.defineProperty(self, 'required', {
    	get () { throw new TypeError('param is required') }
    })
    • @Valtteri: How would you use that? Can you share a more complete example?

  8. This is a great tip! Thanks for sharing. Modified it a bit to make the error more helpful.

    const isRequired = (name, position) => {throw new Error(Paramater "${name}" in position ${position} is required.);};

Wrap your code in <pre class="{language}"></pre> tags, link to a GitHub gist, JSFiddle fiddle, or CodePen pen to embed!