前端代码标准最佳实践:javascript篇

简介:

最近一直重构项目的前端代码,也参考了各种前端代码的最佳实践,目的是让前端的HTML,CSS,Javacript代码更符合标准,有更好的性能,更好的可维护性,尝到了重构后的甜头,也萌生了写这个系列博客的念头。前端代码有其固有的灵活性,这就导致了目前前端代码非常混乱的局面,本系列文章希望能起到抛砖引玉的作用,让更多的人重视前端代码的质量,编写更标准的前端代码。

本系列文章共有三篇,分别讨论HTML,CSS,Javascript,本篇将讨论Javascript。

javascript是灵活性非常高的一种脚本语言,使得用其实现的同样功能有多种多样的写法,那么在项目中如果没有统一的规范,就会造成javascript代码难以维护,随着项目的深入,性能j也越来越差,文件也越来越大。所以尽早制定统一的编码规范是非常必要的,下面是整理的一些javascript规范供大家参考。

(1)编码格式

好的编码格式,不同人有不同的看法,但是在同一个项目中一定要有统一的格式。下面是常用的编码格式:

1,缩进: 不使用tab(\0x09)缩进,以4个空格作为逻辑的缩进。

2,左花括号应该在行的结束,而不应该单独一行。应该一直使用花括号括起逻辑块,即使逻辑只有一行,应该也用花括号括起来,这样提高了代码的可读性。例如:

 
 
  1. for (var i=0; i<100; i++) { 
  2.      doSomething(i);  
  3. if (statement) { 
  4.     doSomeThing; 
  5. } else { 
  6.     doSomeThing; 

3,用单引号定义字符串。javascript中可以用单引号或者双引号定义字符串,但是因为习惯于在html中elements的属性值的定义使用双引号,而javascript中又经常包含html代码,所以字符串定义使用单引号也是方便于在字符串内部包含含有双引号的html代码。

 
 
  1. var content = '<span id="spanid">…'

4,注释:如果注释不是占有多行,建议使用//,不推荐使用/**/,注释应该单独占用一行,而不是写在和代码相同一行的右边。

5,空格:空格的作用是提高代码的可读性,在函数参数的逗号后面使用一个空格,在操作符前后使用一个空格,

 
 
  1. doSomething(myChar, 0, 1); while (x === y) 

6,分号:语句结束一定要使用分号,使用分号是为了在压缩js代码时不至于出现js的编译错误,因为压缩的时候是删除了所有的空格和回车符的。

(2)命名规则

遵循规范的命名规则,提高了代码的可读性,好的命名本身就是好的注释。

1,大小写:现在较流行javascript的面向对象编程,那么就会有公有或私有的概念,原则是公有接口的命名首字母大写,私有接口的命名首字母小写。

2,命名:禁止使用各种缩写,命名应该描述其意义,而不是描述其类型,禁止使用标识类型的前缀

不推荐

 
 
  1. getWin 
  2. function doSomething(str,  integer) { 
  3.      ... ... 
  4. function doSomething(strMessage,  intLength) {  
  5.     ...  ... 

正确命名

 
 
  1. getWindow function doSomething(message, length) { ... ... } 

(3)编程规范

javascript的编程规范关乎代码的性能,代码的简洁。

1,变量定义

变量定义使用关键字var。非必需,不要使用全局变量,这样可以减少不必要的变量定义查询。变量应该有个初始化的值,或者设置为null。避免使用关键字with,with的性能差。集中定义变量,减少代码量。

 
 
  1. var counter = 0empty = null

2,函数定义

函数定义应该在其使用之前。函数内部的函数应该定义在变量之后。减少定义全局函数。函数定义为立即执行,应该用括号包含函数定义体,这样可读性好。

 
 
  1. var statement. 
  2. function outer(c, d) { 
  3.     var e = c * d; 
  4.  
  5.     function inner(a, b) { 
  6.         return (e * a) + b; 
  7.     } 
  8.  
  9.     return inner(0, 1); 
  10.  
  11. var collection = (function () { 
  12.     var keys = [], values = []; 
  13.  
  14.     return { 
  15.         get: function () { 
  16.             ...... 
  17.         } 
  18.     }; 
  19. }()); 

3,函数多次调用,应该使用函数别名。比如在循环中多次调用某个函数,应该定义一个函数别名,减少调用范围链的跳转,提高性能。

 
 
  1. function doSomething() { 
  2.     var get = getDataByIndex
  3.  
  4.      for (var counter = 0; counter < 10000; counter++) { 
  5.         var current = get(counter); 
  6.  
  7.         // ... 
  8.     } 

4,值比较尽量使用严格比较操作符,减少类型的转换操作。

 
 
  1. if (x === 5 && y !== 4) 

5,循环与递归:尽量把性能差的操作放在循环外部。预先计算在循环中要使用的值。在上下文中有多个循环时,定义一个统一的循环变量,避免变量无意义的多次定义。

错误编码

 
 
  1. // example 1 
  2. for (var counter = 0; counter < 10000; counter++) { 
  3.     try { 
  4.        doSomething(); 
  5.     } catch (e) { 
  6.     alert('Failure: ' + e); 
  7.         break; 
  8.     } 
  9.  
  10. // example 2 
  11. for (var counter = 0
  12. counter < document.getElementsByTagName('div').length; 
  13. counter++) { 
  14.     doSomething(); 
  15.  
  16. // example 3 
  17. for (var counter = 0; counter < 10; counter++) { 
  18.     doSomething1(); 
  19. }; 
  20.  
  21. for (var counter = 0; counter < 10; counter++) { 
  22.     doSomething2(); 
  23. }; 

正确编码

 
 
  1. // example 1 
  2.  try { 
  3.     for (var counter = 0; counter < 10000; counter++) { 
  4.          doSomething(); 
  5.      } 
  6. } catch (e) { 
  7.     alert('Failure: ' + e); 
  8.  
  9.  
  10. // example 2 
  11. var target = document.getElementsByTagName('div').length; 
  12. for (var counter = 0;counter < target ;counter++) { 
  13.     doSomething(); 
  14.  
  15. // example 3 
  16. var counter = 0
  17. for (counter = 0; counter < 10; counter++) { 
  18.     doSomething1(); 
  19. }; 
  20. for (counter = 0; counter < 10; counter++) { 
  21.     doSomething2(); 
  22. }; 

6,Dom操作:减少Dom树的更新次数,尽量合并Dom树的更新操作,提高性能。减少赋值给innerHTML的次数。避免给Dom objects上的expando属性赋值,减少可能的内存泄漏。

7,使用全局的变量和方法:避免使用eval,eval非常耗性能。如果要使用全局的变量或方法,应该加上window,减少上下文的定义查找。




本文转自 powertoolsteam 51CTO博客,原文链接:http://blog.51cto.com/powertoolsteam/920652,如需转载请自行联系原作者

相关文章
|
8月前
|
JavaScript 前端开发 安全
Vue 3 + TypeScript 现代前端开发最佳实践(2025版指南)
每日激励:“如果没有天赋,那就一直重复”。我是蒋星熠Jaxonic,一名执着于代码宇宙的星际旅人。用Vue 3与TypeScript构建高效、可维护的前端系统,分享Composition API、状态管理、性能优化等实战经验,助力技术进阶。
1144 1
Vue 3 + TypeScript 现代前端开发最佳实践(2025版指南)
|
人工智能 自然语言处理 前端开发
DeepSite:基于DeepSeek的开源AI前端开发神器,一键生成游戏/网页代码
DeepSite是基于DeepSeek-V3模型的在线开发工具,无需配置环境即可通过自然语言描述快速生成游戏、网页和应用代码,并支持实时预览效果,显著降低开发门槛。
2029 93
DeepSite:基于DeepSeek的开源AI前端开发神器,一键生成游戏/网页代码
|
9月前
|
JavaScript 前端开发 安全
【逆向】Python 调用 JS 代码实战:使用 pyexecjs 与 Node.js 无缝衔接
本文介绍了如何使用 Python 的轻量级库 `pyexecjs` 调用 JavaScript 代码,并结合 Node.js 实现完整的执行流程。内容涵盖环境搭建、基本使用、常见问题解决方案及爬虫逆向分析中的实战技巧,帮助开发者在 Python 中高效处理 JS 逻辑。
|
JavaScript 前端开发 API
|
11月前
|
JavaScript 前端开发 算法
流量分发代码实战|学会用JS控制用户访问路径
流量分发工具(Traffic Distributor),又称跳转器或负载均衡器,可通过JavaScript按预设规则将用户随机引导至不同网站,适用于SEO优化、广告投放、A/B测试等场景。本文分享一段不到百行的JS代码,实现智能、隐蔽的流量控制,并附完整示例与算法解析。
354 1
|
自然语言处理 前端开发 IDE
用通义灵码全新智能体+MCP实现从设计稿到前端代码,个人免费用
通义灵码全新升级,发布国内首个支持“自主决策+工具链闭环”的编程智能体,面向个人免费!新增功能包括智能体模式、混合推理模型Qwen3支持、全面集成MCP中文社区(涵盖2400+服务)及长期记忆能力。用户可通过IDE插件使用,兼容主流开发环境如JetBrains、VS Code和Visual Studio。教程展示如何将MasterGo设计稿转化为前端代码,简化开发流程。探索链接:[通义灵码官网](https://lingma.aliyun.com/)。
|
存储 JavaScript 前端开发
在NodeJS中使用npm包进行JS代码的混淆加密
总的来说,使用“javascript-obfuscator”包可以帮助我们在Node.js中轻松地混淆JavaScript代码。通过合理的配置,我们可以使混淆后的代码更难以理解,从而提高代码的保密性。
1372 9
|
前端开发 JavaScript 数据可视化
58K star!这个让网页动起来的JS库,前端工程师直呼真香!
Anime.js 是一款轻量级但功能强大的JavaScript动画引擎,它能够以最简单的方式为网页元素添加令人惊艳的动效。这个项目在GitHub上已经获得58,000+星标,被广泛应用于电商页面、数据可视化、游戏开发等场景。
643 8
|
前端开发 JavaScript
【Javascript系列】Terser除了压缩代码之外,还有优化代码的功能
Terser 是一款广泛应用于前端开发的 JavaScript 解析器和压缩工具,常被视为 Uglify-es 的替代品。它不仅能高效压缩代码体积,还能优化代码逻辑,提升可靠性。例如,在调试中发现,Terser 压缩后的代码对删除功能确认框逻辑进行了优化。常用参数包括 `compress`(启用压缩)、`mangle`(变量名混淆)和 `output`(输出配置)。更多高级用法可参考官方文档。
1040 11