在支援 ES5 之前的年代,Array 沒有 indexOf,要在陣列中找某個元素的索引得自己寫迴圈。為了呼叫方便,很多人會直接擴充原型:
Array.prototype.indexOf = function(item) {
for (var i = 0; i < this.length; i++) {
if (this[i] == item)
return i;
}
return -1;
}
用起來確實很順手:
var arr = [1, 2, 3, 4, 5];
var index = arr.indexOf(1); // index == 0
擴充完之後,用起來很爽很方便,一片和諧景象……直到某次用 for...in 遍歷陣列,問題來了。
var a = ["張飛", "關羽", "劉備", "呂布"];
for (var p in a) {
document.write(p + "=" + a[p] + "<br/>");
}
原本只想輸出這四個名字,結果卻是:
// 0=張飛
// 1=關羽
// 2=劉備
// 3=呂布
// indexOf=function(item) { for (var i = 0; i < this.length; i++) { if (this[i] == item) return i; } return -1; }
除了四個人名,自己擴充的 indexOf 也被印了出來。更奇怪的是,Firefox 顯示「正常」,只有四個人名。為什麼會這樣?
輸出自己擴充的方法可以理解——for...in 本來就是遍歷一個物件所有「使用者定義的可列舉屬性」,擴充上去的方法自然也在其中。
關鍵在 Firefox 為什麼不會?答案是:Array 從 JavaScript 1.6 起就已原生支援 indexOf()。當時使用的 Firefox 3.5 已支援到 JavaScript 1.8,indexOf 是它本身就有的固有方法,程式裡的擴充實際上並沒有覆蓋到會被列舉的位置;而當時的 IE8 才支援到 JavaScript 1.3,所以 IE 仍把 indexOf 當成「使用者定義的屬性」輸出。
驗證方式很簡單:把 indexOf 改名為 myIndexOf 再試一次,結果 IE 與 Firefox 都輸出了 myIndexOf,正好印證了這個推論。
問題變成:我已經擴充 indexOf 很久了,不少專案都在用,但我現在只想用 for...in 輸出陣列本身的元素,不要那些擴充上去的方法,該怎麼辦?
JavaScript 提供了 hasOwnProperty(),其官方描述是:
Every object descended from Object inherits the hasOwnProperty method.
This method can be used to determine whether an object has the specified
property as a direct property of that object; unlike the in operator,
this method does not check down the object's prototype chain.
也就是說,它只檢查「該物件自身」的屬性,不會沿原型鏈往上找——正是我們要的東西。在 for...in 裡加一個判斷即可:
for (var p in a) {
if (a.hasOwnProperty(p)) {
document.write(p + "=" + a[p] + "<br/>");
}
}
以下範例示範如何判斷某屬性是「本地」還是「繼承而來」:
function Book(title, author) {
this.title = title;
this.author = author;
}
Book.prototype.price = 9.99;
Object.prototype.copyright = "herongyang.com";
var myBook = new Book("JavaScript Tutorials", "Herong Yang");
// 檢查 Object.prototype 上的屬性
dumpProperty(Object.prototype, "constructor");
dumpProperty(Object.prototype, "hasOwnProperty");
dumpProperty(Object.prototype, "isPrototypeOf");
dumpProperty(Object.prototype, "toString");
dumpProperty(Object.prototype, "valueOf");
dumpProperty(Object.prototype, "copyright");
// 檢查 Book.prototype 上的屬性
dumpProperty(Book.prototype, "constructor");
dumpProperty(Book.prototype, "price");
// 檢查 myBook 實例上的屬性
dumpProperty(myBook, "title");
dumpProperty(myBook, "price");
dumpProperty(myBook, "copyright");
function dumpProperty(object, property) {
var inheritance;
if (object.hasOwnProperty(property))
inheritance = "Local";
else
inheritance = "Inherited";
document.writeln(property + ": " + inheritance + ": " + object[property]);
}
這個案例真正的教訓是:不要任意擴充原生物件原型。一旦這麼做,所有使用 for...in 的程式碼都可能受影響,包括第三方函式庫——這正是後來 ES5 標準化 Array.prototype.indexOf、並提供 Object.keys()、Object.defineProperty() 等工具的原因。
現代做法有兩個:
for、forEach、map 等專用語法,它們不會碰到原型上的屬性。Object.defineProperty() 定義為不可列舉(enumerable: false),就不會出現在 for...in 中。過去的做法是針對每個版本寫一段 <script language="JavaScript1.x">,瀏覽器只會執行自己認得的版本區塊:
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="https://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>瀏覽器的 JavaScript 版本支持測試</title>
</head>
<body>
<script language="JavaScript">
// 支援 JavaScript 1.0 的瀏覽器才能執行
document.write('該瀏覽器支持 JavaScript 1.0<br/>');
</script>
<script language="JavaScript1.1">
document.write('該瀏覽器支持 JavaScript 1.1<br/>');
</script>
<script language="JavaScript1.2">
document.write('該瀏覽器支持 JavaScript 1.2<br/>');
</script>
<script language="JavaScript1.3">
document.write('該瀏覽器支持 JavaScript 1.3<br/>');
</script>
<script language="JavaScript1.4">
document.write('該瀏覽器支持 JavaScript 1.4<br/>');
</script>
<script language="JavaScript1.5">
document.write('該瀏覽器支持 JavaScript 1.5<br/>');
</script>
<script language="JavaScript1.6">
document.write('該瀏覽器支持 JavaScript 1.6<br/>');
</script>
<script language="JavaScript1.7">
document.write('該瀏覽器支持 JavaScript 1.7<br/>');
</script>
<script language="JavaScript1.8">
document.write('該瀏覽器支持 JavaScript 1.8<br/>');
</script>
<script language="JavaScript1.9">
document.write('該瀏覽器支持 JavaScript 1.9<br/>');
</script>
</body>
</html>
如今這種寫法已無實用價值(language 屬性早已棄用),今天的標準做法是用特性偵測:直接檢查 if (typeof arr.indexOf === 'function') 或 if ('includes' in String.prototype),判斷能力是否存在,而不是猜測版本號。