编写可维护的javascript(一):基本的格式化

一 基本的格式化

  • 语句结尾
    依赖于分析器的自动分号插入(ASI)机制,javascript代码省略分号是可以正常工作。ASI会自动寻找出代码中应当使用分号但实际没有分号的位置,并插入分号。在大多数情况下ASI都会正确插入分号,不会产生错误。
    // 原始代码
    function getData() {
        return 
        {
            title: 'rule',
            author: 'mangoyi'
        }
    }

    // 分析器会自动解释成
    function getData() {
        return ;
        {
            title: 'rule',
            author: 'mangoyi'
        }
    }

  • javascript编码风格倾向于将行长度限定在80个字符。
    if (isLeapYear && isFebruary && day == 29 && itsYourBirthday &&
            noPlans) {
        waitAnotherFourYears();
    }

以上代码注释:if条件语句拆分成两行,断行是在&&运算符之后(总是将一个运算符置于行尾,ASI就不会自作主张地插入分号了)

  • 命名
    核心遵照驼峰式大小写命名法
    变量名总是遵循驼峰大小写命名法,并且命名前缀应当是名字。以名词为前缀可以让变量和函数区分开来,因为函数名前应当是动词。见下面例子:
    // good
    var count = 10;
    var myName = 'Mangoyi';
    var found = true;

    // bad (变量看起来像是函数)
    var getCount = 10;
    var isFound = true;

    // good 
    function getName() {
        return myName;
    }

    // bad (函数看起来像是变量)
    function theName() {
        return myName;
    }

常量
约定使用大写字母和下划线来命名,下划线用以分割单词,比如:

    var MAX_COUNT = 10;

构造函数
构造函数以大写字母开头的驼峰式命名,常常是名词,因为构造函数是用来创建某个类型的实例的。

    // good
    function Person(name) {
        this.name = name;
    }

    Person.prototype.sayName = function() {
        alert(this.name);
    }

    var me = new Person('Mangoyi');

字符串
Javascript中,字符串是独一无二的,字符串可以使用双引号括起来,也可以用单引号括起来。

    // 合法javascript代码
    var name = "Mangoyi says,\"Hi\"";

    //也是合法的javascript代码
    var name = 'mangoyi says,"Hi"'

注:明确禁止创建多行字符串,多行字符串的一种替代方法是,使用字符串连接符(+)将字符串分成多份

    // bad(不允许)
    var longString = "Here's the story, of a man \
                      named Mangoyi";

    // good
    var longString = "Here's the story, of a man " +
                     "named Mangoyi";

数字
请不要省略小数点之前或之后的数字。

null
null是一个特殊值。
理解null最好的方式是将它当做对象的占位符。

    // good
    var person = null;

    function getPerson() {
        if (condition) {
            return new Person('Mangoyi');
        } else {
            return null;
        }
    }

    // good
    var person = new getPerson();
    if (person !== null) {
        doSomething();
    }

    // bad(不好的做法: 用来和为初始化的变量比较)
    var person;
    if (person != null) {
        doSomething();
    }

    // bad(不好的做法:检测是否传入了参数)
    function doSomething(arg1, arg2) {
        if (arg2 != null) {
            doSomethingElse();
        }
    }

undefined
undefined是一个特殊值
那些没有被初始化的变量都有一个初始值,即undefined,表示这个变量等待被赋值。
typeof的行为
不管值是undefined的变量还是未声明的变量,typeof运算的结果都是‘undefined’ 比如:

    // foo 未被声明
    var person;
    console.log(typeof person);   // "undefined"
    console.log(typeof foo);      // "undefined"

当变量未声明时,如果使用了一个可能赋值未一个对象的变量时,应将其赋值为null。

    // good
    var person = null;
    console.log(person ==== null)  //true

则此时typeof运算null类型时则返回‘object’,就可以和undefined区分开了。

对象直接量
创建对象最流行的一种做法是使用对象直接量。

    // bad 
    var book = new Object();
    book.title = 'Javascript';
    book.author = 'Mangoyi';

很少见到上面这种写法。
对象直接量允许你将所有属性都括在一对花括号中。
所以,定义对象直接量时,采用如下标准写法:

    var book = {
        title : 'Javascript',
        author : 'Mangoyi'
    };

数组直接量
和对象直接量相似,数组直接量是Javascript中定义数组最简洁的一种方式。
不赞成显示地使用Array构造函数来创建数组。比如:

    // bad 
    var colors = new Array('red', 'green', 'blue');

    // good
    var colors = ['red', 'green', 'blue'];

文章内容从《编写可维护的Javascript》[美] Nicholas C. Zakas著 书中总结写出。

编写维护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、付费专栏及课程。

余额充值