编写高质量JS代码的68个有效方法(十一)
No.51、在类数组对象上附庸通用的数组方法
Tips:
- 对于类数组对象,通过提取方法对象并使用其call方法来复用通用的Array方法
- 任意一个具有索引属性和恰当length属性的对象都可以使用通用的Array方法
Array.proteotype中的标准方法被设计成其他对象可复用的方法,即使这些对象没有继承Array。很实际的一个例子就是 arguments
,示例如下:
//define
function fun(){
console.log(arguments); // [1, 2, 3]
console.log(arguments instanceof Array) // false
arguments.forEach(function(argv){ //TypeError
console.log(argv)
});
}
//call
fun(1, 2, 3);
从结果来看,输出arguments和数组非常相似,通过instanceof来看,确实不是数组,所以arguments是类数组对象,但是在执行forEach的时候却TypeError。why?
因为 arguments
没有继承Array.prototype,所以并不能直接调用forEach方法,但是可以提取forEach方法的引用并使用其call来调用,代码如下:
//define
function fun(){
[].forEach.call(arguments, function(argv){
console.log(argv);
});
}
//call
fun(1, 2, 3);
除了arguments之外,dom的NodeList也是类数组对象:
var nodes = document.getElementsByTagName('a');
console.log(nodes);
console.log(nodes instanceof Array); // false
那么,到底怎样使得一个对象“看起来像数组”呢?有以下两个规则:
- 具有一个范围在0到2^32 - 1 的整型length属性
- length属性大于该对象的最大索引。索引是一个范围在0到2^32 -2 的整数,它的字符串表示的是该对象的一个key。
鉴于以上规则,那么我们可以自己创建类数组对象:
var arrayLike = {0: 'a', 1: 'b', 2: 'c', length: 3};
var result = [].map.call(arrayLike, function(el){
return el.toUpperCase();
});
console.log(result); // ['A', 'B', 'C']
特例,数组连接方法concat不是完全通用的。因为它会检查对象的[[Class]]属性,要想连接类数组对象,我们就需要先将类数组处理为数组:
var arrLike = {0: 'a', length: 1};
var arr = [].slice.call(arrLike);
console.log(['A'].concat(arr)); // ['A', 'a']
No.52、数组字面量优于数组构造函数
Tips:
- 如果数组构造函数的第一个参数是数字则数组的构造函数行为是不同的
- 使用数组字面量替代数组构造函数
原因如下:
[] 比 new Array简洁
var arr = [];
var arr = new Array();
使用new Array(),必须要确保没有人重新包转过Array变量
funciton f(Array){
return new Array(1, 2, 3, 4, 5);
}
f(String); //new String(1)
使用new Array(),必须要确保没有人修改过全局的Array变量
Array = String
new Array(1, 2, 3); // new String(1)
使用new Array时,由于第一个参数类型不同,会导致二义性
new Array('hello') 和 ['hello'] 等价
[1] 和 new Array(1) 不等价,前者创建包含元素的1的数组,后则创建长度为1的数组。
所以,优先使用字面量,因为数组字面量具有更规范、更一致的语义。
No.53、保持一致的约定
Tips:
- 在变量命名和函数签名中使用一致的约定
- 不要偏离用户在他们的开发平台中很可能遇到的约定
有良好的编码习惯,使用业界常规的编码规范,同时注意参数的顺序等。一句话概述:保持代码的一致性。
No.54、将undefined看做“没有值”
Tips:
- 避免使用undefined表示任何非特定值
- 使用描述性的字符串值或命名布尔属性的对象,而不要使用undefined 或 null来代表特定应用标志
- 提供参数默认值应该采用测试undefined的方式,而不是检查arguments.length。
- 在允许0、NaN或空字符串为有效参数的地方,绝不要通过真值测试来实现参数默认值。
undefined很特殊,当JavaScript无法提供具体的值时没救产生undefined。 如只定义变量,不赋值;或者是对象中不存在属性;再者,函数无return语句都会产生undefined。
var x;
console.log(x); //undefined
var o = {};
console.log(o.p1); //undefined
function fun(){
}
console.log(fun()); //undefined
未给函数参数提供实参则该函数参数值为undefined
function fun(x){
return x;
}
console.log(fun()); //undefined
将undefined看做缺少某个特定的值是公约。将它用于其他目的具有很高的风险:
//假设highlight为设置元素高亮
element.highlight('yellow'); //设置为黄色
//如果要设置为随机颜色
//方式一、如果遇到undefined则设置为随机
element.highlight(undefined);
//这样的方式通常会产生歧义
element.highlight(config.highlightColor);
//使用如上语句时,我们的期望一般是没有提供配置则使用默认色,但是由于undefined代表随机,那么破坏了这种常规思维。让代码变得难以理解。
//更好的做法
element.highlight('random');
//或者是
element.highlight({random: true});
另一个提防undefined的地方是可选参数的实现。
function fun(a, b){
if(arguments.length < 2){
b = 'xx';
}
}
如果使用 fun(a);调用,基本符合预期;但是如果使用fun(a, 'undefind');则不会执行if之内的语句,导致结果错误,如果测试是否为undefined有助于打造更为健壮的API。
针对可选参数这个问题,另外一个合理的替代方案是:
function fun(a, b){
b = b || 'xxx';
}
但是要注意,真值测试并不总是安全的。如果一个函数应该接受空字符串,0,NaN为合法值,那么真值测试就不该使用了。
//Bad Use
function Point(x, y){
this.x = x || 200;
this.y = y || 200;
}
以上代码有什么问题呢,因为使用 new Point(0, 0);会导致使用默认值,这样就偏离了预期。所以需要更严格的测试:
function Point(x, y){
this.x = x === undefined ? 200 : x;
this.y = y === undefined ? 200 : y;
}
No.55、接收关键字参数的选项对象
Tips:
- 使用选项对象似的API更具可读性、更容易记忆
- 所有通过选项对象提供的参数应当被视为可选的
- 使用extend函数抽象出从选项对象中提取值的逻辑
首先来看一个复杂的函数调用:
fun(200, 200, 'action', 'green', true);
一眼望去,完全不知所云。在体会到C#的可选参数的便利性的时候,肯定会想JavaScript要是有这样的用法就好了。
幸运的是,JavaScript提供了一个简单、轻量的惯用法:选项对象。基本达到了可选参数的效果。
fun({
width: 200,
height: 200,
action: 'action',
color: 'green',
ignoreError: true
});
相对来说,更繁琐一点,但是更易于阅读。另外一个好处就是,参数都是可选的。
如果有必选参数,那么在设计API的时候。建议将它们独立于选项之外,其他语言也可借鉴这种思路。
// options 为可选参数
function fun(width, height, options){
}
通过extend组合可选参数和默认参数,可以让函数变得简洁和健壮。
function fun(width, height, options){
var defaults = {
color: 'green',
ignoreError: false,
action: ''
}
//$.extend 可以理解为jQuery的方法
options = $.extend({}, defaults, options);
//do something...
}