in 是 JavaScript 中常被忽略的運算子,專門用來判斷某個屬性名稱是否存在於物件上。它的行為很單純,但有幾個容易誤解的地方值得留意。
in 的左側必須是字串或可轉為字串的值,右側必須是物件;若右側物件帶有該名稱的屬性,運算式就回傳 true。
var point = {x:1,y:1}; "x" in point //true "z" in point //false "toString" in point //true var ary = [1,2,3]; "0" in ary; //true,ary含有索引0("0"回轉換為0); 1 in ary; //true,ary含有索引1 3 in ary; //false
注意 "toString" in point 的結果是 true。這是因為 in 不只查自身屬性,也會沿著原型鏈一路往上找,而 toString 來自 Object.prototype。因此 in 回答的問題其實是「這個名稱能不能在物件上讀到」,而非「物件自己是否定義了它」。
如果只想確認自身屬性,該改用 Object.prototype.hasOwnProperty.call(obj, 'x'),或直接寫 obj.hasOwnProperty('x')(後者要注意物件可能被覆寫過该方法)。ES2022 之後也可以使用 Object.hasOwn(obj, 'x')。
陣列本質上仍是物件,索引就是它的屬性名稱,所以 0 in ary 成立,而 3 in ary 為 false——因為索引 3 並不存在。順帶一提,若某個索引是稀疏的(例如 ary 只有索引 0 與 2),中間的洞用 in 判斷會回傳 false,這也是 in 與 value in array 語意不同的原因。
對字串或數字使用 in 會丟出 TypeError。若需要判斷某段文字是否包含子字串,應該用 String 的 includes 或 indexOf,而不是 in。