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/