译者按: 规范的代码可以有效避免代码bug,fundebug才会报警少一点!
原文: Tips for Writing Cleaner Code
译者: Fundebug
为了保证可读性,本文采用意译而非直译。另外,本文版权归原作者所有,翻译仅用于学习。

几点建议帮你写出简洁的JS代码

我决定为初学者写一篇博客来介绍一些常见编程技巧,这些技巧可以帮助你写出更加规范,容易维护的代码。
1. 常量
这个问题哦不仅仅是写JavaScript的开发者们会遇到,在所有的开发语言中都要避免。我们来看一个例子:
elem.on(keydown,function(e)if(e.keyCode==27)//);27ESC27使KEYESC=272.(identifiers)()varid=(this).attr(‘id’).substring(8);
正如我们已经提过,阅读这段代码的开发者需要去推测为什么用8。
我们再举一个例子(来自一个实际的项目):
var last_id = $(‘#answer_pid’ + id + ’ li:first div’).attr(‘id’).substr(7);

html的布局稍有变动,都将导致这部分代码出错。
我们再看一个:

var id = $(this).attr(‘id’).substring(“comment_”.length);

这段代码好一点,至少没有使用看不懂的数字,但JavaScript代码还是和html有太多的绑定。
我们可以使用data-*语法:

然后,用更加简洁的语法来获取属性值:
var id = $(this).attr(‘data-id’);

或则:
var id = $(this).data(‘id’);

  1. .postjQueryajax.ajax。对于具体的操作,还有.get,..load, .post,使(jsonpost).ajax实现。
    对于个人而言,我从不使用这些简化版的函数,接下来我会告诉你为什么。
    对于初学者或则经验不足的开发者,你会发现写代码也会分为不同的层次:
    a. 初级
    .post(url,data,function(data)data=$.parseJSON(data);//);b..post(url, data, function(data) {
    try {
    data = .parseJSON(data);  
    } catch (e) {  
      return;  
    }  
    //…   
    });  
    c. 如果认真阅读
    .post的文档,我们就会发现最后一个参数应该是数据的类型dataType, 但是我发现在大多数开发者写的代码中都忘记了!
    .post(url,data,function(data)//,json);5.post,通常会像下面这样写:
    $.post(url, data, function(data) {
    //…
    }, ‘json’).error(function() {
    //…
    });

这样写是很难理解的!每次都去写出错处理非常的繁琐和耗时,你可以定义一个默认的错误处理句柄(default error handler)来应对所有的ajax请求。对于全局的异常,产品上线以后可以使用fundebug的JavaScript插件来抓取。
.ajaxSetup(error:function()//Errormodal);.post函数,上面的写法很难读懂,而且dataType作为最后一个参数很容易遗漏。我个人认为,如下的写法更加容易阅读和维护:
$.ajax({
type: “POST”,
url: url,
data: data,
dataType: “json”,
success: function(data) {
//…
},
error: function() {
//…
}
});

  1. 多元素事件
    有时候,我们需要给页面元素绑定对应的事件(删除消息的按钮)。经常,我们会这样实现:
    (.commenta.delete).click(function()//);()(‘.comment a.delete’).unbind(‘click’).click(function() {
    //
    });
    在jQuery 1.7中有on事件,可以把事件绑定到某个行为,并且可以通过选择器(selector)过滤元素:
    (body).on(click,a.external,function(e)//external);(‘body’).on(‘mousemove’, selector, function() {
    //…
    });

  2. 带命名空间的事件(namespaced events)
    带命名空间的事件(namespaced events)在jQuery 1.2就被加入了,但是没有几个人用。我敢打赌你也不知道!
    举个例子:
    (a).on(click,function()//Handler1);(‘a’).on(‘click’, function() {
    // Handler 2
    });

如果我们想要移除第二个handler, 使用(a).off(click)handler使(‘a’).on(‘click.namespace1’, function() {
//Handler 1
});
$(‘a’).on(‘click.namespace2’, function() {
//Handler 2
});

使用如下代码移除:
$(‘a’).off(‘click.namespace2’);

如果想更多了解,请参考: Event names and namespaces
这还只是我在阅读别人代码的时候,经常遇到的问题中的一小部分。我希望这篇文章可以帮助大家提高写代码的质量!

几点建议帮你写出简洁的JS代码

版权声明:
转载时请注明作者Fundebug以及本文地址:
https://blog.fundebug.com/2017/07/12/tips_for_writing_cleaner_code/

相关文章:

  • 2021-12-10
  • 2021-05-26
  • 2021-07-10
  • 2022-12-23
  • 2023-01-02
  • 2021-05-27
  • 2022-01-07
  • 2021-10-08
猜你喜欢
  • 2022-01-10
  • 2021-12-03
  • 2021-12-03
相关资源
相似解决方案