매우 상세한 프런트엔드 JavaScript 사양

JavaScript사양

디렉터리

1. 유형

2. 객체

3. 배열

4. 문자열

5. 함수

6. 속성

7. 변수

8. 조건부식및 등호

9. 차단

10. 댓글

11. 공백

12. 쉼표

13. 세미콜론

14. 형식 변환

15. 명명 규칙

16. 접속자

17. 생성자

18. 이벤트

19. 모듈

20. jQuery

21. ES5 호환성

22. HTML, CSS, JavaScript 분리

23. jsHint 사용

24. 프런트엔드 도구

유형

• 원래 값 : 값 전달(JavaScript 객체 모두 리터럴 제공), 리터럴을 사용하여 객체를 생성합니다.

• <p>문자열<code><a href="http://www.php.cn/wiki/57.html" target="_blank">string</a>

• number

• boolean

• <a href="http://www.php.cn/wiki/62.html" target="_blank">null<code><a href="http://www.php.cn/wiki/62.html" target="_blank">null</a>

• undefined

var foo = 1,
    bar = foo;

bar = 9;

console.log(foo, bar); // => 1, 9

복잡한 유형: 꽤 Yu Chuan 명언

• <code><a href="http://www.php.cn/wiki/60.html" target="_blank">object</a>객체

• <a href="http://www.php.cn/wiki/58.html" target="_blank">array</a>

  배열

• function

var foo = [1, 2],
    bar = foo;

bar[0] = 9;

console.log(foo[0], bar[0]); // => 9, 9

객체
리터럴 값을 사용하여 생성됨 객체

• // bad
  var item = new Object();
  
  // good
  var item = {};

예약어를 키로 사용하지 마세요

// bad
var superman = {
  class: 'superhero',
  default: { clark: 'kent' },
  private: true
};

// good
var superman = {
  klass: 'superhero',
  defaults: { clark: 'kent' },
  hidden: true
};

배열
단어 사용 만들기 array

• // bad
  var items = new Array();
  
  // good
  var items = [];

배열의 길이를 모른다면 push

• var someStack = [];
  
  // bad
  someStack[someStack.length] = 'abracadabra';
  
  // good
  someStack.push('abracadabra');

배열을 복사해야 할 때는 Slice를 이용하세요 .jsPerf

• var len = items.length,
      itemsCopy = [],
      i;
  
  // bad
  for (i = 0; i < len; i++) {
    itemsCopy[i] = items[i];
  }
  
  // good
  itemsCopy = items.slice();

slice를 사용하여 배열형 객체를 배열로 변환합니다.

function trigger() {
  var args = [].slice.apply(arguments);
  ...
}

String

• ''" 문자열에는 작은 따옴표를 사용하세요

  (대부분의 경우 문자열이 표시됩니다. 특히 html이 표시됩니다
)

• // bad
  var name = "Bob Parr";
  
  // good
  var name = 'Bob Parr';
  
  // bad
  var fullName = "Bob " + this.lastName;
  
  // good
  var fullName = 'Bob ' + this.lastName;

  가 80을 초과합니다(140의 조항도 있습니다) , 프로젝트에서 지정할 수 있음) 문자열은

  문자열 연결
줄 바꿈
을 사용하여 수행해야 합니다. 참고: jsPerf &를 과도하게 사용하면 긴 문자열 연결이 성능에 영향을 미칠 수 있습니다. 토론

• // bad
  var errorMessage = 'This is a super long error that was thrown because of Batman. When you stop to think about how Batman had anything to do with this, you would get nowhere fast.';
  
  // bad
  var errorMessage = 'This is a super long error that \
  was thrown because of Batman. \
  When you stop to think about \
  how Batman had anything to do \
  with this, you would get nowhere \
  fast.';
  
  // good
  var errorMessage = 'This is a super long error that ' +
    'was thrown because of Batman.' +
    'When you stop to think about ' +
    'how Batman had anything to do ' +
    'with this, you would get nowhere ' +
    'fast.';

프로그래밍 시 문자열을 작성하려면 문자열 연결 대신 조인을 사용하세요. 특히 IE: jsPerf.

var items,
    messages,
    length, i;

messages = [{
    state: 'success',
    message: 'This one worked.'
},{
    state: 'success',
    message: 'This one worked as well.'
},{
    state: 'error',
    message: 'This one did not work.'
}];

length = messages.length;

// bad
function inbox(messages) {
  items = &#39;<ul>&#39;;

  for (i = 0; i < length; i++) {
    items += &#39;<li>&#39; + messages[i].message + &#39;</li>&#39;;
  }

  return items + &#39;</ul>&#39;;
}

// good
function inbox(messages) {
  items = [];

  for (i = 0; i < length; i++) {
    items[i] = messages[i].message;
  }

  return &#39;<ul><li>&#39; + items.join(&#39;</li><li>&#39;) + &#39;</li></ul>&#39;;
}

함수

• 함수 표현식
:

• // 匿名函数表达式
  var anonymous = function() {
    return true;
  };
  
  // 有名函数表达式
  var named = function named() {
    return true;
  };
  
  // 立即调用函数表达式
  (function() {
    console.log('Welcome to the Internet. Please follow me.');
  })();

절대로 함수가 아닌 블록에서 함수를 선언하지 말고 해당 함수를 변수에 할당하세요. 브라우저에서는 이를 수행할 수 있지만 다르게 해석합니다.

• 块참고:

  ECMA-262 정의는
을 명령문 집합으로 정의하며 함수 선언은 명령문이 아닙니다. 이 문제에 대한 ECMA-262의 설명을 읽어보세요.

• // bad
  if (currentUser) {
    function test() {
      console.log('Nope.');
    }
  }
  
  // good
  if (currentUser) {
    var test = function test() {
      console.log('Yup.');
    };
  }

  arguments매개변수 이름을 로 지정하지 마세요. 이렇게 하면 arguments 개체에 전달된

  함수 범위
를 초과하게 됩니다.

// bad
function nope(name, options, arguments) {
  // ...stuff...
}

// good
function yup(name, options, args) {
  // ...stuff...
}

속성

• 변수 및 특수 불법 .변수 이름

  을 사용할 때, 속성에 접근할 때 대괄호(
이 우선 적용됨)

var luke = {
  jedi: true,
  age: 28
};

function getProp(prop) {
  return luke[prop];
}

var isJedi = getProp('jedi');

변수

• var항상 를 사용하여 변수를 선언하세요. 그렇지 않으면 변수가 생성됩니다. 전역 변수를 사용하고 있으며 전역

  네임스페이스 를 오염시키지 않으려고 합니다.

  // bad
  superPower = new SuperPower();
  
  // good
  var superPower = new SuperPower();

• 使用一个 var 以及新行声明多个变量，缩进4个空格。

  // bad
  var items = getItems();
  var goSportsTeam = true;
  var dragonball = 'z';
  
  // good
  var items = getItems(),
      goSportsTeam = true,
      dragonball = 'z';

• 最后再声明未赋值的变量，当你想引用之前已赋值变量的时候很有用。

  // bad
  var i, len, dragonball,
      items = getItems(),
      goSportsTeam = true;
  
  // bad
  var i, items = getItems(),
      dragonball,
      goSportsTeam = true,
      len;
  
  // good
  var items = getItems(),
      goSportsTeam = true,
      dragonball,
      length,
      i;

• 在作用域顶部声明变量，避免变量声明和赋值引起的相关问题。

  // bad
  function() {
    test();
    console.log('doing stuff..');
  
    //..other stuff..
  
    var name = getName();
  
    if (name === 'test') {
      return false;
    }
  
    return name;
  }
  
  // good
  function() {
    var name = getName();
  
    test();
    console.log('doing stuff..');
  
    //..other stuff..
  
    if (name === 'test') {
      return false;
    }
  
    return name;
  }
  
  // bad
  function() {
    var name = getName();
  
    if (!arguments.length) {
      return false;
    }
  
    return true;
  }
  
  // good
  function() {
    if (!arguments.length) {
      return false;
    }
  
    var name = getName();
  
    return true;
  }

条件表达式和等号

• 合理使用 === 和 !== 以及 == 和 !=.

• 合理使用表达式逻辑操作运算.

• 条件表达式的强制类型转换遵循以下规则：

• 对象 被计算为 true

• Undefined 被计算为 false

• Null 被计算为 false

• 布尔值 被计算为 布尔的值

• 数字 如果是 +0, -0, or NaN 被计算为 false , 否则为 true

• 字符串 如果是空字符串 '' 则被计算为 false, 否则为 true
  

  if ([0]) {
    // true
    // An array is an object, objects evaluate to true
  }

• 使用快捷方式.

  // bad
  if (name !== '') {
    // ...stuff...
  }
  
  // good
  if (name) {
    // ...stuff...
  }
  
  // bad
  if (collection.length > 0) {
    // ...stuff...
  }
  
  // good
  if (collection.length) {
    // ...stuff...
  }

• 阅读 Truth Equality and JavaScript 了解更多

块

• 给所有多行的块使用大括号

  // bad
  if (test)
    return false;
  
  // good
  if (test) return false;
  
  // good
  if (test) {
    return false;
  }
  
  // bad
  function() { return false; }
  
  // good
  function() {
    return false;
  }

注释

• 使用 /** ... */ 进行多行注释，包括描述，指定类型以及参数值和返回值

  // bad
  // make() returns a new element
  // based on the passed in tag name
  //
  // @param <String> tag
  // @return <Element> element
  function make(tag) {
  
    // ...stuff...
  
    return element;
  }
  
  // good
  /**
   * make() returns a new element
   * based on the passed in tag name
   *
   * @param <String> tag
   * @return <Element> element
   */
  function make(tag) {
  
    // ...stuff...
  
    return element;
  }

• 使用 // 进行单行注释，在评论对象的上面进行单行注释，注释前放一个空行.

  // bad
  var active = true;  // is current tab
  
  // good
  // is current tab
  var active = true;
  
  // bad
  function getType() {
    console.log('fetching type...');
    // set the default type to 'no type'
    var type = this._type || 'no type';
  
    return type;
  }
  
  // good
  function getType() {
    console.log('fetching type...');
  
    // set the default type to 'no type'
    var type = this._type || 'no type';
  
    return type;
  }

• 如果你有一个问题需要重新来看一下或如果你建议一个需要被实现的解决方法的话需要在你的注释前面加上 FIXME 或 TODO 帮助其他人迅速理解

  function Calculator() {
  
    // FIXME: shouldn't use a global here
    total = 0;
  
    return this;
  }

  function Calculator() {
  
    // TODO: total should be configurable by an options param
    this.total = 0;
  
    return this;
  }

• 满足规范的文档，在需要文档的时候，可以尝试jsdoc.

空白

• 缩进、格式化能帮助团队更快得定位修复代码BUG.

• 将tab设为4个空格

  // bad
  function() {
  ∙∙var name;
  }
  
  // bad
  function() {
  ∙var name;
  }
  
  // good
  function() {
  ∙∙∙∙var name;
  }

• 大括号前放一个空格

  // bad
  function test(){
    console.log('test');
  }
  
  // good
  function test() {
    console.log('test');
  }
  
  // bad
  dog.set('attr',{
    age: '1 year',
    breed: 'Bernese Mountain Dog'
  });
  
  // good
  dog.set('attr', {
    age: '1 year',
    breed: 'Bernese Mountain Dog'
  });

• 在做长方法链时使用缩进.

  // bad
  $('#items').find('.selected').highlight().end().find('.open').updateCount();
  
  // good
  $('#items')
    .find('.selected')
      .highlight()
      .end()
    .find('.open')
      .updateCount();
  
  // bad
  var leds = stage.selectAll('.led').data(data).enter().append('svg:svg').class('led', true)
      .attr('width',  (radius + margin) * 2).append('svg:g')
      .attr('transform', 'translate(' + (radius + margin) + ',' + (radius + margin) + ')')
      .call(tron.led);
  
  // good
  var leds = stage.selectAll('.led')
      .data(data)
    .enter().append('svg:svg')
      .class('led', true)
      .attr('width',  (radius + margin) * 2)
    .append('svg:g')
      .attr('transform', 'translate(' + (radius + margin) + ',' + (radius + margin) + ')')
      .call(tron.led);

逗号

• 不要将逗号放前面

  // bad
  var once
    , upon
    , aTime;
  
  // good
  var once,
      upon,
      aTime;
  
  // bad
  var hero = {
      firstName: 'Bob'
    , lastName: 'Parr'
    , heroName: 'Mr. Incredible'
    , superPower: 'strength'
  };
  
  // good
  var hero = {
    firstName: 'Bob',
    lastName: 'Parr',
    heroName: 'Mr. Incredible',
    superPower: 'strength'
  };

• 不要加多余的逗号，这可能会在IE下引起错误，同时如果多一个逗号某些ES3的实现会计算多数组的长度。

  // bad
  var hero = {
    firstName: 'Kevin',
    lastName: 'Flynn',
  };
  
  var heroes = [
    'Batman',
    'Superman',
  ];
  
  // good
  var hero = {
    firstName: 'Kevin',
    lastName: 'Flynn'
  };
  
  var heroes = [
    'Batman',
    'Superman'
  ];

分号

• 语句结束一定要加分号

  // bad
  (function() {
    var name = 'Skywalker'
    return name
  })()
  
  // good
  (function() {
    var name = 'Skywalker';
    return name;
  })();
  
  // good
  ;(function() {
    var name = 'Skywalker';
    return name;
  })();

类型转换

• 在语句的开始执行类型转换.

• 字符串:

  //  => this.reviewScore = 9;
  
  // bad
  var totalScore = this.reviewScore + '';
  
  // good
  var totalScore = '' + this.reviewScore;
  
  // bad
  var totalScore = '' + this.reviewScore + ' total score';
  
  // good
  var totalScore = this.reviewScore + ' total score';

• 对数字使用 parseInt 并且总是带上类型转换的基数.，如parseInt(value, 10)

• var inputValue = '4';
  
  // bad
  var val = new Number(inputValue);
  
  // bad
  var val = +inputValue;
  
  // bad
  var val = inputValue >> 0;
  
  // bad
  var val = parseInt(inputValue);
  
  // good
  var val = Number(inputValue);
  
  // good
  var val = parseInt(inputValue, 10);
  
  // good
  /**
   * parseInt was the reason my code was slow.
   * Bitshifting the String to coerce it to a
   * Number made it a lot faster.
   */
  var val = inputValue >> 0;

• 布尔值:

  var age = 0;
  
  // bad
  var hasAge = new Boolean(age);
  
  // good
  var hasAge = Boolean(age);
  
  // good
  var hasAge = !!age;

命名约定

• 避免单个字符名，让你的变量名有描述意义。

  // bad
  function q() {
    // ...stuff...
  }
  
  // good
  function query() {
    // ..stuff..
  }

• 当命名对象、函数和实例时使用驼峰命名规则

  // bad
  var OBJEcttsssss = {};
  var this_is_my_object = {};
  var this-is-my-object = {};
  function c() {};
  var u = new user({
    name: 'Bob Parr'
  });
  
  // good
  var thisIsMyObject = {};
  function thisIsMyFunction() {};
  var user = new User({
    name: 'Bob Parr'
  });

• 当命名构造函数或类时使用驼峰式大写

  // bad
  function user(options) {
    this.name = options.name;
  }
  
  var bad = new user({
    name: 'nope'
  });
  
  // good
  function User(options) {
    this.name = options.name;
  }
  
  var good = new User({
    name: 'yup'
  });

• 命名私有属性时前面加个下划线 _:

  // bad
  this.firstName = 'Panda';
  this.firstName_ = 'Panda';
  
  // good
  this._firstName = 'Panda';

• 当保存对 this 的引用时使用 self(python 风格),避免this issue.Angular建议使用vm(MVVM模式中view-model):

  // good
  function() {
    var self = this;
    return function() {
      console.log(self);
    };
  }

存取器

• 属性的存取器函数不是必需的

• 如果你确实有存取器函数的话使用getVal() 和 setVal(‘hello’),java getter、setter风格或者jQuery风格

• 如果属性是布尔值，使用isVal() 或 hasVal()

  // bad
  if (!dragon.age()) {
    return false;
  }
  
  // good
  if (!dragon.hasAge()) {
    return false;
  }

• 可以创建get()和set()函数，但是要保持一致

  function Jedi(options) {
    options || (options = {});
    var lightsaber = options.lightsaber || 'blue';
    this.set('lightsaber', lightsaber);
  }
  
  Jedi.prototype.set = function(key, val) {
    this[key] = val;
  };
  
  Jedi.prototype.get = function(key) {
    return this[key];
  };

构造器

• 给对象原型分配方法，而不是用一个新的对象覆盖原型，覆盖原型会使继承出现问题。

  function Jedi() {
    console.log('new jedi');
  }
  
  // bad
  Jedi.prototype = {
    fight: function fight() {
      console.log('fighting');
    },
  
    block: function block() {
      console.log('blocking');
    }
  };
  
  // good
  Jedi.prototype.fight = function fight() {
    console.log('fighting');
  };
  
  Jedi.prototype.block = function block() {
    console.log('blocking');
  };

• 方法可以返回 this 帮助方法可链。

  // bad
  Jedi.prototype.jump = function() {
    this.jumping = true;
    return true;
  };
  
  Jedi.prototype.setHeight = function(height) {
    this.height = height;
  };
  
  var luke = new Jedi();
  luke.jump(); // => true
  luke.setHeight(20) // => undefined
  
  // good
  Jedi.prototype.jump = function() {
    this.jumping = true;
    return this;
  };
  
  Jedi.prototype.setHeight = function(height) {
    this.height = height;
    return this;
  };
  
  var luke = new Jedi();
  
  luke.jump()
    .setHeight(20);

• 可以写一个自定义的toString()方法，但是确保它工作正常并且不会有副作用。

  function Jedi(options) {
    options || (options = {});
    this.name = options.name || 'no name';
  }
  
  Jedi.prototype.getName = function getName() {
    return this.name;
  };
  
  Jedi.prototype.toString = function toString() {
    return 'Jedi - ' + this.getName();
  };

事件

• 当给事件附加数据时，传入一个哈希而不是原始值，这可以让后面的贡献者加入更多数据到事件数据里而不用找出并更新那个事件的事件处理器

  // bad
  $(this).trigger('listingUpdated', listing.id);
  
  ...
  
  $(this).on('listingUpdated', function(e, listingId) {
    // do something with listingId
  });

  更好:

  // good
  $(this).trigger('listingUpdated', { listingId : listing.id });
  
  ...
  
  $(this).on('listingUpdated', function(e, data) {
    // do something with data.listingId
  });

模块

• 这个文件应该以驼峰命名，并在同名文件夹下，同时导出的时候名字一致

• 对于公开API库可以考虑加入一个名为noConflict()的方法来设置导出的模块为之前的版本并返回它

• 总是在模块顶部声明 'use strict';，引入[JSHint规范](http://www.php.cn/):

  // fancyInput/fancyInput.js
  
  （function(global) {
    'use strict';
  
    var previousFancyInput = global.FancyInput;
  
    function FancyInput(options) {
      this.options = options || {};
    }
  
    FancyInput.noConflict = function noConflict() {
      global.FancyInput = previousFancyInput;
      return FancyInput;
    };
  
    global.FancyInput = FancyInput;
  })(this);

jQuery

• 对于jQuery对象以$开头，以和原生DOM节点区分。

  // bad
  var menu = $(".menu");
  
  // good
  var $menu = $(".menu");

• 缓存jQuery查询

  // bad
  function setSidebar() {
    $('.sidebar').hide();
  
    // ...stuff...
  
    $('.sidebar').css({
      'background-color': 'pink'
    });
  }
  
  // good
  function setSidebar() {
    var $sidebar = $('.sidebar');
    $sidebar.hide();
  
    // ...stuff...
  
    $sidebar.css({
      'background-color': 'pink'
    });
  }

• 对DOM查询使用级联的 $('.sidebar ul') 或 $('.sidebar ul')，jsPerf

• 对有作用域的jQuery对象查询使用 find:

  // bad
  $('.sidebar', 'ul').hide();
  
  // bad
  $('.sidebar').find('ul').hide();
  
  // good
  $('.sidebar ul').hide();
  
  // good
  $('.sidebar > ul').hide();
  
  // good (slower)
  $sidebar.find('ul');
  
  // good (faster)
  $($sidebar[0]).find('ul');

• 每个页面只使用一次document的ready事件，这样便于调试与行为流跟踪。

  $(function(){
     //do your page init.  
  });

• 事件利用jQuery.on从页面分离到JavaScript文件。

  // bad
  <a id="myLink" href="#" onclick="myEventHandler();"></a>
  
  // good
  <a id="myLink" href="#"></a>
  
  $("#myLink").on("click", myEventHandler);

• 对于Ajax使用promise方式。

   // bad
      $.ajax({
          ...
          success : function(){
          },
          error : function(){
          } 
      })
  
      // good
      $.ajax({.
          ..
      }).then( function( ){
          // success
      }, function( ){
          // error
      })

• 利用promise的deferred对象解决延迟注册问题。

  var dtd = $.Deferred(); // 新建一个deferred对象
  　　var wait = function(dtd){
  　　　　var tasks = function(){
  　　　　　　alert("执行完毕！");
  　　　　　　dtd.resolve(); // 改变deferred对象的执行状态
  　　　　};
  　　　　setTimeout(tasks,5000);
  　　　　return dtd;
  　　};

• HTML中Style、以及JavaScript中style移到CSS中class，在HTML、JavaScript中引入class，而不是直接style。

ECMAScript 5兼容性

尽量采用ES5方法，特别数组map、filter、forEach方法简化日常开发。在老式IE浏览器中引入ES5-shim。或者也可以考虑引入underscore、lodash 常用辅助库.
- 参考Kangax的 ES5 compatibility table

HTML、CSS、JavaScript分离

• 页面DOM结构使用HTML，样式则采用CSS，动态DOM操作JavaScript。不要混用在HTML中

• 分离在不同类型文件，文件link。

• HTML、CSS、JavaScript变量名都需要有业务价值。CSS以中划线分割的全小写命名，JavaScript则首字母小写的驼峰命名。

• CSS可引入Bootstrap、Foundation等出名响应式设计框架。以及SASS、LESS工具书写CSS。

• 对于CSS、JavaScript建议合并为单文件，减少Ajax的连接数。也可以引入AMD(Require.js)加载方式。

• 对于内部大部分企业管理系统，可以尝试采用前端 MVC框架组织代码。如Angular、React + Flux架构、Knockout等。

• 对于兼容性可用Modernizr规范库辅助。

使用jsHint

• 前端项目中推荐引入jshint插件来规范项目编码规范。以及一套完善的IDE配置。

• 注意：jshint需要引入nodejs 工具grunt或gulp插件，建议企业级nodejs npm私服。

前端工具

• 前端第三方JavaScript包管理工具bower(bower install jQuery)，bower可以实现第三方库的依赖解析、下载、升级管理等。建议建立企业级bower私服。

• 前端构建工具，可以采用grunt或者gulp工具，可以实现html、css、js压缩、验证、测试，文件合并、watch和liveload等所有前端任务。建议企业级nodejs npm私服。

• 前端开发IDE： WebStorm( Idea )、Sublime为最佳 。项目组统一IDE。IDE统一配置很重要。

위 내용은 매우 상세한 프런트엔드 JavaScript 사양의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!