JavaScript函数重载

译者按: jQuery之父John Resig巧妙地利用了闭包，实现了JavaScript函数重载。

原文: JavaScript Method Overloading

译者: Fundebug

为了保证可读性，本文采用意译而非直译。另外，本文版权归原做者全部，翻译仅用于学习。

在一个业余项目中，我写了一个简单的addMethod函数，用于实现函数重载(Method Overloading)。而所谓函数重载，就是函数名称同样，可是输入输出不同。或者说，容许某个函数有各类不一样输入，根据不一样的输入，调用不一样的函数，而后返回不一样的结果。

addMethod函数以下:

// addMethod - By John Resig (MIT Licensed)
function addMethod(object, name, fn){
    var old = object[ name ];
    object[ name ] = function(){
        if ( fn.length == arguments.length )
            return fn.apply( this, arguments );
        else if ( typeof old == 'function' )
            return old.apply( this, arguments );
    };
}

所谓addMethod函数，简单的理解，就是给某个object，添加一个指定name的函数fn。它利用了闭包，能够经过old变量将前后绑定的函数连接起来。

你能够这样使用addMethod函数，将find函数直接添加到每一个对象实例：

function Users(){
  addMethod(this, "find", function(){
    // Find all users...
  });
  addMethod(this, "find", function(name){
    // Find a user by name
  });
  addMethod(this, "find", function(first, last){
    // Find a user by first and last name
  });
}

你也能够将find函数添加到对象的prototype，这样全部对象实例将共享find函数:

function Users(){
    addMethod(Users.prototype, "find", function(){
      // Find all users...
    });
    addMethod(Users.prototype, "find", function(name){
      // Find a user by name
    });
    addMethod(Users.prototype, "find", function(first, last){
      // Find a user by first and last name
    });
}

users对象的find方法成功实现了重载，能够根据不一样的输入调用不一样的函数：

var users = new Users();
users.find(); // Finds all
users.find("John"); // Finds users by name
users.find("John", "Resig"); // Finds users by first and last name
users.find("John", "E", "Resig"); // Does nothing

这种方法有一些明显的缺陷:

• 重载只能处理输入参数个数不一样的状况，它不能区分参数的类型、名称等其余要素。(ECMAScript 4计划支持这一特性，称做Multimethods，然而该版本已被放弃)。
• 重载过的函数将会有一些额外的负载，对于性能要求比较高的应用，使用这个方法要慎重考虑。

addMethod函数的秘诀之一在于fn.length。或许不少人并不清楚，全部函数都有一个length属性，它的值等于定义函数时的参数个数。好比，当你定义的函数只有1个参数时，其length属性为1：

(function(foo){}).length == 1

我作了一下测试，发现这个实现函数重载的方法适用于全部浏览器，若是有问题的话请与我联系。

若是你担忧只绑定单个函数时的性能问题，你可使用以下addMethod函数：

// addMethod - By John Resig (MIT Licensed)
function addMethod(object, name, fn){
    var old = object[ name ];
    if ( old )
        object[ name ] = function(){
            if ( fn.length == arguments.length )
                return fn.apply( this, arguments );
            else if ( typeof old == 'function' )
                return old.apply( this, arguments );
        };
    else
        object[ name ] = fn;
}

这样绑定第一个函数时，将不会有额外的操做，既简单又快速。当绑定更多函数时，则与原addMethod函数同样，会有额外的性能损失。

这样作还有一个额外的好处：对于那些参数个数不符合要求的函数调用，将统一又第一个绑定的函数处理。这时调用find方法的输出以下：

var users = new Users();
users.find(); // Finds all
users.find("John"); // Finds users by name
users.find("John", "Resig"); // Finds users by first and last name
users.find("John", "E", "Resig"); // Finds all

本文介绍的方法不能改变世界，可是它很代码量不多、很简单，巧妙地使用了JavaScript的特性。所以，我在个人书《Secrets of the JavaScript Ninja》也介绍了这个方法。

完整示例

根据原文介绍的方法，译者实现了一个完整的示例代码：

function addMethod(object, name, fn)
{
    var old = object[name];
    object[name] = function()
    {
        if (fn.length == arguments.length)
            return fn.apply(this, arguments);
        else if (typeof old == 'function')
            return old.apply(this, arguments);
    };
}


// 不传参数时，返回全部name
function find0()
{　　
    return this.names;
}


// 传一个参数时，返回firstName匹配的name
function find1(firstName)
{　　
    var result = [];　　
    for (var i = 0; i < this.names.length; i++)
    {　　　　
        if (this.names[i].indexOf(firstName) === 0)
        {　　　　　　
            result.push(this.names[i]);　　　　
        }　　
    }　　
    return result;
}


// 传两个参数时，返回firstName和lastName都匹配的name
function find2(firstName, lastName)
{　
    var result = [];　　
    for (var i = 0; i < this.names.length; i++)
    {　　　　
        if (this.names[i] === (firstName + " " + lastName))
        {　　　　　　
            result.push(this.names[i]);　　　　
        }　　
    }　　
    return result;
}


function Users()
{
    addMethod(Users.prototype, "find", find0);
    addMethod(Users.prototype, "find", find1);
    addMethod(Users.prototype, "find", find2);
}


var users = new Users();
users.names = ["John Resig", "John Russell", "Dean Tom"];


console.log(users.find()); // 输出[ 'John Resig', 'John Russell', 'Dean Tom' ]
console.log(users.find("John")); // 输出[ 'John Resig', 'John Russell' ]
console.log(users.find("John", "Resig")); // 输出[ 'John Resig' ]
console.log(users.find("John", "E", "Resig")); // 输出undefined

凭直觉，函数重载能够经过if…else或者switch实现，这就不去管它了。jQuery之父John Resig提出了一个很是巧(bian)妙(tai)的方法，利用了闭包。

从效果上来讲，users对象的find方法容许3种不一样的输入: 0个参数时，返回全部人名；1个参数时，根据firstName查找人名并返回；2个参数时，根据完整的名称查找人名并返回。

难点在于，users.find事实上只能绑定一个函数，那它为什么能够处理3种不一样的输入呢？它不可能同时绑定3个函数find0,find1与find2啊！这里的关键在于old属性。

由addMethod函数的调用顺序可知，users.find最终绑定的是find2函数。然而，在绑定find2时，old为find1；同理，绑定find1时，old为find0。3个函数find0,find1与find2就这样经过闭包连接起来了。

根据addMethod的逻辑，当fn.length与arguments.length不匹配时，就会去调用old，直到匹配为止。

关于Fundebug

Fundebug专一于JavaScript、微信小程序、微信小游戏、支付宝小程序、React Native、Node.js和Java实时BUG监控。 自从2016年双十一正式上线，Fundebug累计处理了7亿+错误事件，获得了Google、360、金山软件、百姓网等众多知名用户的承认。欢迎免费试用！

版权声明

转载时请注明做者Fundebug以及本文地址： https://blog.fundebug.com/2017/07/24/javascript_metho_overloading/