這是一個很值得記下來的「貪多必失」案例:為了少寫一個方法,最後反而把功能弄壞。
作者寫了一個處理 URL 的 JavaScript 工具類,上面掛了一個 queryString 屬性,希望同時支援兩種呼叫風格:
queryString[key]:直接取值,鍵名大小寫敏感。queryString(key):以函式呼叫,大小寫無關,順手還能帶值寫回。於是 queryString 被實作成一個匿名函式:queryString = function(){...},函式物件本身同時充當索引容器使用。
某一天發現,URL 裡的 name 參數無論如何都設不上去。原因在於函式物件自帶 name 與 length 這類唯讀的內建屬性,指派不進去,也不會丟錯,就靜靜地被瀏覽器忽略掉。
把 queryString 改回純物件 queryString = {},另外獨立提供 param(key[, value]) 方法來處理大小寫無關的存取需求。這樣每個構造各自負責一件事,不再互相打架。
更普遍的原則是:拿來存放 key-value 的容器,不要選用已經帶有內建屬性的型別。函式有 name、length、prototype、caller、arguments;陣列有 length,還有 push 之類的方法會被誤認為資料。若想徹底避開,可以使用 Object.create(null) 建立沒有原型的字典,或用 Map/WeakMap,讓鍵名完全自由,也不必擔心 constructor、toString 這類原型鏈上的名字撞車。