编写可维护的javascript读后笔记(一)

编写可维护的javascript读后笔记(一)

本书主要是讲解了怎么样使自己写的代码更具可读性和可维护性。是初学javascript同学需要看的一本书。本人就看后做的一些笔记拿来分享。

本书主要分为三部分:
第一部分:编程风格
第二部分: 编程实践
第三部分:自动化

这一篇主要总结的是第一部分编程风格。

第一章 基本的格式化

  1. 本章介绍了编程的基本规范格式 包括缩进, 语句结尾符号,行的长度限制,以及换行 空行和变量 函数命名规则。
  2. 缩进
    可以保持代码的整洁性,缩进层级 一般主要有两种方式:
    (1)两个制表符(即两个tab键)
    (2)四个空格键
    两种缩进方式都可,只要团队内部约定好其中一种,保持一致即可。
  3. 语句结尾“;”
    由于javascript引擎会在没有结尾符号的地方自动添加“;”所以以防出错,需要自己再语句结尾处添加“;”。否则可能出现不必要的错误。
  4. 行的长度限制
    根据一般规范,每行的长度最好不要超过80个字符。否则阅读起来可能有些不方便。
  5. 换行
    当一行长度达到了最大长度限制80个字符后,需要手动将一行拆成两行,一般都会选择在运算符后换行,下一行会增加两个层级的缩进。例如:
  callAFunc(arg1, arg2, arg3, arg4, arg5, arg6, arg7,
    arg8,arg9);

6.空行
在某些代码的地方适当的运用空行可以增加代码的可读性;
(1)在方法之间
(2)在方法的局部变量和第一条语句之间
(3)在多行或单行注释之前
(4)在方法内部逻辑片段之间插入空行(或注释),提高可读性

7.命名
javascript典型的命名规则是驼峰命名法,首字母小写,其后每个单词 首字母大写。

在给变量和函数命名的时候 :
变量尽量用名词命名
函数用动词命名(can, has, is, get, set)
常量命名一般都用全大写加个“_”
构造函数 首字母大写
例如:

// 变量
var myName="nike";

// 常量
var MAX_LENGTH = 10;

// 函数
var getName= function() {
    return "nike";
}

//构造函数
function Person(name,age) {
    this.name=name;
    this.age=age;
}

第二章 注释

必要的注释可以增强自己代码的可读性。也方便以后自己查看自己代码时不会忘记当初为什么这么写。

1、 注释主要有两种
(1)单行注释
(2)多行注释

// 这是单行注释
var count = 10;

var count = 19; //这是放在行尾的单行注释

/*
 * 这是多行注释的第一行
 * 这是多行注释的第二行
 * ...
 * /

// 文档注释 一般用于介绍函数参数和返回值
/** 
  * method 方法名 用来做什么的
  * @param arg1是干嘛的
  * @return {object} object是什么什么的返回值
  * /

第三章 语句和表达式

本章主要介绍了各语句的规范写法 如 if for循环 switch语句等。
1. 即使if语句只有一个执行语句 也不建议不加花括号。

// 规范的if语句写法
if (condition) {
    doSomething();
}

2.for循环
有两种方法可以更改for循环的执行过程:
(1)break 跳出循环体 立即结束循环
(2)continue 跳出此次循环 执行下一次循环
不建议使用continue语句,某些代码审查工具JSLint会给出警告,尽量使用其他方式代替掉continue语句 如 if(i !=2){执行体};

3.for-in循环
for-in循环是用来遍历对象属性的。它不仅遍历对象的实例属性 还会遍历对象的原型继承属性。如果不想要遍历原型继承的属性可以使用对象的hasOwnProperty()方法;例如:

var k;

for(k in object) {
    if(object.hasOwnProperty(k)) {
        console.log("Property name is" + k);
        console.log("Property value is" + object[k]);
    }
}

第四章 变量、函数和运算符

1.变量声明提升
javascript 会有一个变量名提升的现象,所以在写函数的时候可以把需要声明的变量提前声明好。例如好的写法:

function doSometing(items) {
    var value = 10,
        result = value + 10,
        i,
        len;
    for(i=0,len=items.length; i<len; i++) {
        doSomething(items[i]);
    }
}

2.函数声明提升
函数也存在声明提升问题,虽然可以先调用 后声明,但是以防万一而且某些代码审查工具如JsLint 和JsHint都会给出警告。所以建议还是先声明再调用。

3.立即调用函数
当把一个立即调用函数的返回值赋值给变量时,最好是用()将立即函数包裹起来,否则除非你读完最后的调用语句()才知道是将函数的结果返回值赋给该变量的 例如:

// 不好的写法
var value = function() {
    //函数体;
    return {
        name : "nike"
    }
}();

// 好的写法
var value =(function() {
    //函数体;
    return {
        name : "nike"
    }
}());
编写维护JavaScript》向开发人员阐述了如何在团队开发中编写具备高可维护性的JavaScript代码,书中详细说明了作为团队一分子,应该怎么写JavaScript。本书内容涵盖了编码风格、编程技巧、自动化、测试等几方面,既包括具体风格和原则的介绍,也包括示例和技巧说明,最后还介绍了如何通过自动化的工具和方法来实现一致的编程风格。   《编写维护JavaScript》作者Nicholas C. Zakas是顶级的Web技术专家,也是《JavaScript高级程序设计》一书的作者。他曾是Yahoo!的首席前端开发工程师,在完成了从一名“独行侠”到“团队精英”的蜕变后,他站在前端工程师的角度提炼出众多的最佳编程实践,其中包括很多业内权威所推崇的最佳法则,而这些宝贵经验正是本书的核心内容。   《编写维护JavaScript》适合前端开发工程师、JavaScript程序员和学习JavaScript编程的读者阅读,也适合开发团队负责人、项目负责人阅读。运用本书中讲述的技巧和技术,可以使JavaScript团队编程从侠义的个人偏好的阴霾走出来,走向真正的高可维护性、高效能和高水准。 第一部分 编程风格 第1章 基本的格式化 1.1 缩进层级 1.2 语句结尾 1.3 行的长度 1.4 换行 1.5 空行 1.6 命名 1.6.1 变量和函数 1.6.2 常量 1.6.3 构造函数 1.7 直接量 1.7.1 字符串 1.7.2 数字 1.7.3 null 1.7.4 undefined 1.7.5 对象直接量 1.7.6 数组直接量 第2章 注释 2.1 单行注释 2.2 多行注释 2.3 使用注释 2.3.1 难于理解的代码 2.3.2 可能被误认为错误的代码 2.3.3 浏览器特性hack 2.4 文档注释 第3章 语句和表达式 3.1 花括号的对齐方式 3.2 块语句间隔 3.3 switch语句 3.3.1 缩进 3.3.2 case语句的“连续执行” 3.3.3 default 3.4 with语句 3.5 for循环 3.6 for-in循环 第4章 变量、函数和运算符 4.1 变量声明 4.2 函数声明 4.3 函数调用间隔 4.4 立即调用的函数 4.5 严格模式 4.6 相等 4.6.1 eval() 4.6.2 原始包装类型 第二部分 编程实践 第5章 UI层的松耦合 5.1 什么是松耦合 5.2 将JavaScript从CSS中抽离 5.3 将CSS从JavaScript中抽离 5.4 将JavaScript从HTML中抽离 5.5 将HTML从JavaScript中抽离 5.5.1 方法1:从服务器加载 5.5.2 方法2:简单客户端模板 5.5.3 方法3:复杂客户端模板 第6章 避免使用全局变量 6.1 全局变量带来的问题 6.1.1 命名冲突 6.1.2 代码的脆弱性 6.1.3 难以测试 6.2 意外的全局变量 避免意外的全局变量 6.3 单全局变量方式 6.3.1 命名空间 6.3.2 模块 6.4 零全局变量 第7章 事件处理 7.1 典型用法 7.2 规则1:隔离应用逻辑 7.3 规则2:不要分发事件对象 第8章 避免“空比较” 8.1 检测原始值 8.2 检测引用值 8.2.1 检测函数 8.2.2 检测数组 8.3 检测属性 第9章 将配置数据从代码中分离出来 9.1 什么是配置数据 9.2 抽离配置数据 9.3 保存配置数据 第10章 抛出自定义错误 10.1 错误的本质 10.2 在JavaScript中抛出错误 10.3 抛出错误的好处 10.4 何时抛出错误 10.5 try-catch语句 10.6 错误类型 第11章 不是你的对象不要动 11.1 什么是你的 11.2 原则 11.2.1 不覆盖方法 11.2.2 不新增方法 11.2.3 不删除方法 11.3 更好的途径 11.3.1 基于对象的继承 11.3.2 基于类型的继承 11.3.3 门面模式 11.4 关于Polyfill的注解 11.5 阻止修改 第12章 浏览器嗅探 12.1 User-Agent检测 12.2 特性检测 12.3 避免特性推断 12.4 避免浏览器推断 12.5 应当如何取舍 第三部分 自动化 第13章 文件和目录结构 13.1 最佳实践 13.2 基本结构 第14章 Ant 14.1 安装 14.2 配置文件 14.3 执行构建 14.4 目标操作的依赖 14.5 属性 14.6 Buildr项目 第15章 校验 15.1 查找文件 15.2 任务 15.3 增强的目标操作 15.4 其他方面的改进 15.5 Buildr任务 第16章 文件合并和加工 16.1 任务 16.2 行尾结束符 16.3 文件头和文件尾 16.4 加工文件 第17章 文件精简和压缩 17.1 文件精简 17.1.1 使用YUI Compressor精简代码 17.1.2 用Closure Compiler精简 17.1.3 使用UglifyJS精简 17.2 压缩 17.2.1 运行时压缩 17.2.2 构建时压缩 第18章 文档化 18.1 JSDoc Toolkit 18.2 YUI Doc 第19章 自动化测试 19.1 YUI Test Selenium引擎 19.1.1 配置一台Selenium服务器 19.1.2 配置YUI Test Selenium引擎 19.1.3 使用YUI Test Selenium引擎 19.1.4 Ant的配置写法 19.2 Yeti 19.3 PhantomJS 19.3.1 安装及使用 19.3.2 Ant的配置写法 19.4 JsTestDriver 19.4.1 安装及使用 19.4.2 Ant的配置写法 第20章 组装到一起 20.1 被忽略的细节 20.2 编制打包计划 20.2.1 开发版本的构建 20.2.2 集成版本的构建 20.2.3 发布版本的构建 20.3 使用CI系统 20.3.1 Jenkins 20.3.2 其他CI系统 附录A JavaScript编码风格指南 附录B JavaScript工具集
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值