Nonchalantly Performs Magic


    4.0.2 • Public • Published

    clean NPM version Build Status Dependency Status

    Clean is small but powerful node.js module that parses and sanitize argv for node, supporting:

    • fully extendable types
    • shorthands
    • validatiors
    • setters

    Installation and Usage

    npm install clean --save
    var clean = require('clean');

    Usage: clean(options)

    Argv Shorthands

    We can define shorthands with the option options.shorthands.

    var shorthands = {
        c: 'cwd',
        n: 'no-recursive'
        shorthands: shorthands
    }).argv(['node', 'xxx', '-c', 'abc', '-n']);
    // The result is:
    // {
    // cwd: 'abc',
    // recursive: false
    // }


        schema: {
            cwd: {
                type: require('path')
            retry: {
                type: Boolean
        ['node', 'xxx', '--cwd', 'abc', '--retry', 'false'], 
        function(err, results){
            console.log(results.cwd); // the `path.resolved()`d 'abc'
            console.log(results.retry === false); // is a boolean, not a string

    Validators and Setters

    Validators and setters of clean is implemented by [checker](, check the apis of checker for details.

    You could check out the demo located at "example/clean.js". That is a very complicated situation of usage.

    node example/clean.js --username guest

    Programatical Details

    constructor: clean(options)

    • options Object=
      • schema Object schema to define the argv
      • offset Number= The offset from which the parser should start to parse. Optional. Default to 2.
      • shorthands Object= The schema used to clean the given object or the parsred argv
      • parallel Boolean=false whether should check the argv in parallel, default to false


    name: {
      // If `required == true` and `--name` is not specified in argv, there will be an error
      required: true,
      validate: function(value){
        return /[a-z]/i.test(value);
      set: function(value){
        return value.replace(/^[a-z]/, function(m){
          return m.toUpperCase();
    • required Boolean
    • default * if required is true, this property will be ignored.
    • validate function(v, is_default)|Array function for validation, or array of functions
    • set function(v, is_default)|Array setter function, or array of functions.

    There are three methods available for this object of validator and setter.

    • this.async() returns function done, and turns the current validator or setter into an asynchronous method. We can also use done to define better error messages.
    • this.get(key) could fetch the value of other properties.
    • this.set(key, value) could set values of other properties.


    • argv Array process.argv or something like that.

    Parses the argument vector, without cleaning the data.

    Returns Object The parsed object with shorthand rules applied.

    .clean(data, callback)

    • data Object The given data.
    • callback function(err, results)

    Cleans the given data according to the schema.

    .parse(argv, callback)

    Parses argument vector (argv) or something like process.argv, and cleans the parsed data according to the schema.

    This method is equivalent to c.clean(c.argv(argv), callback).

    Advanced Section

    .registerType(type, typeDef)

    Registers a custom type.


    npm i clean

    DownloadsWeekly Downloads






    Last publish


    • kael