【译】10 种 JavaScript 最多见的错误

原文：rollbar.com/blog/top-10…
声明：对原文稍做了修改，便于阅读

前言

看了数千个项目后，发现了 10 个最多见的 JavaScript 错误。咱们会告诉你什么缘由致使了这些错误，以及如何防止这些错误发生。若是你可以避免落入这些 “陷阱”，你将会成为一个更好的开发者。

JavaScript 常见错误 Top 10：

为了便于阅读，咱们将每一个错误描述都缩短了。接下来，让咱们深刻到每个错误，来肯定什么会致使它，以及如何避免建立它。

一、Uncaught TypeError: Cannot read property

若是你是一个 JavaScript 开发人员，可能你看到这个错误的次数比你敢认可的要多。当你读取一个未定义的对象的属性或调用其方法时，这个错误会在 Chrome 中出现。 您能够很容易的在 Chrome 开发者控制台中进行测试。

发生这种状况的缘由不少，但常见的一种是在渲染 UI 组件时对于状态的初始化操做不当。

咱们来看一个在真实应用程序中发生的例子：咱们选择 React，但该状况也一样适用于 Angular、Vue 或任何其余框架。

class Quiz extends Component {
  componentWillMount() {
    axios.get('/thedata').then(res => {
      this.setState({items: res.data});
    });
  }
  render() {
    return (
      <ul>
        {this.state.items.map(item =>
          <li key={item.id}>{item.name}</li>
        )}
      </ul>
    );
  }
}
复制代码

两个重要的流程：

1. 组件的状态（例如 this.state）开始于 undefined。
2. 当异步获取数据时，无论它是在构造函数 componentWillMount 仍是 componentDidMount 中获取的，组件在数据加载以前至少会呈现一次，当 Quiz 第一次呈现时，this.state.items 是 undefined。

这很容易解决。最简单的方法：在构造函数中初始化 state。

class Quiz extends Component {
  // Added this:
  constructor(props) {
    super(props);
    // Assign state itself, and a default value for items
    this.state = {
      items: []
    };
  }
  componentWillMount() {
    axios.get('/thedata').then(res => {
      this.setState({items: res.data});
    });
  }
  render() {
    return (
      <ul>
        {this.state.items.map(item =>
          <li key={item.id}>{item.name}</li>
        )}
      </ul>
    );
  }
}
复制代码

在你的应用程序中的具体代码多是不一样的，但咱们但愿咱们已经给你足够的线索，以解决或避免在你的应用程序中出现的这个问题。若是尚未，请继续阅读，由于咱们将在下面覆盖更多相关错误的示例。

二、 TypeError: ‘undefined’ is not an object

这是在 Safari 中读取属性或调用未定义对象上的方法时发生的错误。您能够在 Safari Developer Console 中轻松测试。这与第一点中提到的 Chrome 的错误基本相同，但 Safari 使用了不一样的错误消息提示语。

三、 TypeError: null is not an object

这是在 Safari 中读取属性或调用空对象上的方法时发生的错误。 您能够在 Safari Developer Console 中轻松测试。

有趣的是，在 JavaScript 中，null 和 undefined 是并不一样，这就是为何咱们看到的是两个不一样的错误信息。

undefined 一般是一个还没有分配的变量，而 null 表示该值为空。 要验证它们不相等，请尝试使用严格的相等运算符 ===

在咱们工做中，这种错误可能发生的一种场景是：若是在加载元素以前尝试在 JavaScript 中使用元素。 由于 DOM API 对于空白的对象引用返回值为 null。

任何执行和处理 DOM 元素的 JS 代码都应该在建立 DOM 元素以后执行。

JS 代码按照 HTML 中的规定从上到下进行解释。 因此，若是 DOM 元素以前有一个标签，脚本标签内的 JS 代码将在浏览器解析 HTML 页面时执行。 若是在加载脚本以前还没有建立 DOM 元素，则会出现此错误。

在这个例子中，咱们能够经过添加一个事件监听器来解决这个问题，这个监听器会在页面准备好的时候通知咱们。 一旦 addEventListener 被触发，init() 方法就可使用 DOM 元素。

<script>
  function init() {
    var myButton = document.getElementById("myButton");
    var myTextfield = document.getElementById("myTextfield");
    myButton.onclick = function() {
      var userName = myTextfield.value;
    }
  }
  document.addEventListener('readystatechange', function() {
    if (document.readyState === "complete") {
      init();
    }
  });
</script>
<form>
  <input type="text" id="myTextfield" placeholder="Type your name" />
  <input type="button" id="myButton" value="Go" />
</form>
复制代码

四、 (unknown): Script error

当未捕获的 JavaScript 错误（经过 window.onerror 处理程序引起的错误，而不是捕获在 try-catch 中）被浏览器的跨域策略限制时，会产生这类的脚本错误。 例如，若是您将您的 JavaScript 代码托管在 CDN 上，则任何未被捕获的错误将被报告为“脚本错误” 而不是包含有用的堆栈信息。这是一种浏览器安全措施，旨在防止跨域传递数据，不然将不容许进行通讯。

要得到真正的错误消息，请执行如下操做：

1. 设置 ‘Access-Control-Allow-Origin’ 头部

将 Access-Control-Allow-Origin 标头设置为 * 表示能够从任何域正确访问资源。

在 Nginx 中设置以下：

将 add_header 指令添加到提供 JavaScript 文件的位置块中：

location ~ ^/assets/ {
    add_header Access-Control-Allow-Origin *;
}
复制代码

2. 在 <script> 中设置 crossorigin="anonymous"

在您的 HTML 代码中，对于您设置了 Access-Control-Allow-Origin 的每一个脚本，在 script 标签上设置 crossorigin =“anonymous”。在脚本标记中添加 crossorigin 属性以前，请确保验证上述 header 正确发送。

在 Firefox 中，若是存在crossorigin属性，但Access-Control-Allow-Origin头不存在，则脚本将不会执行。

五、 TypeError: Object doesn’t support property

这是您在调用未定义的方法时发生在 IE 中的错误。 您能够在 IE 开发者控制台中进行测试。

这至关于 Chrome 中的 “TypeError：”undefined“ is not a function” 错误。

是的，对于相同的逻辑错误，不一样的浏览器可能具备不一样的错误消息。

对于使用 JavaScript 命名空间的 Web 应用程序，这是一个 IE 浏览器的常见的问题。 在这种状况下，99.9％ 的缘由是 IE 没法将当前名称空间内的方法绑定到 this 关键字。

例如：若是你 JS 中有一个命名空间 Rollbar 以及方法 isAwesome。 一般，若是您在 Rollbar 命名空间内，则可使用如下语法调用 isAwesome 方法：

this.isAwesome();
复制代码

Chrome，Firefox 和 Opera 会欣然接受这个语法。 可是 IE 却不会。 所以，使用 JS 命名空间时最安全的选择是始终以实际名称空间做为前缀。

Rollbar.isAwesome();
复制代码

六、 TypeError: ‘undefined’ is not a function

当您调用未定义的函数时，这是 Chrome 中产生的错误。 您能够在 Chrome 开发人员控制台和 Mozilla Firefox 开发人员控制台中进行测试。

function clearBoard(){
  alert("Cleared");
}

document.addEventListener("click", function(){
  this.clearBoard(); // what is “this” ?
});
复制代码

执行上面的代码会致使如下错误：

“Uncaught TypeError：this.clearBoard is not a function”。

缘由应该是清楚的，即执行上下文不理解致使的指向错误。

七、 Uncaught RangeError

当你调用一个不终止的递归函数就会发生这种错误。您能够在 Chrome 开发者控制台中进行测试。

此外，若是您将值传递给超出范围的函数，也可能会发生这种状况。

许多函数只接受其输入值的特定范围的数字。 例如：

1. toExponential(digits) 和 toFixed(digits) 接受 0 到 100
2. toPrecision(digits) 接受 1 到 100

var num = 2.555555;
console.log(num.toExponential(4));  //OK
console.log(num.toExponential(-2)); //range error!

console.log(num.toFixed(2));   //OK
console.log(num.toFixed(105));  //range error!

console.log(num.toPrecision(1));   //OK
console.log(num.toPrecision(0));  //range error!
复制代码

八、 TypeError: Cannot read property ‘length’

这是 Chrome 中发生的错误，由于读取未定义变量的长度属性。 您能够在 Chrome 开发者控制台中进行测试。

您一般会在数组中找到定义的长度，可是若是数组未初始化或者变量在另外一个上下文中，则可能会遇到此错误。让咱们用下面的例子来理解这个错误。

var testArray = ["Test"];
function testFunction(testArray) {
    for (var i = 0; i < testArray.length; i++) {
        console.log(testArray[i]);
    }
}
testFunction();
复制代码

执行以上代码会报错：

Cannot read property 'length' of undefined

有两种方法能够解决这个问题：

var testArray = ["Test"];
/* Precondition: defined testArray outside of a function */
function testFunction(/* No params */) {
    for (var i = 0; i < testArray.length; i++) {
      console.log(testArray[i]);
    }
}
testFunction();
复制代码

或

var testArray = ["Test"];
function testFunction(testArray) {
   for (var i = 0; i < testArray.length; i++) {
      console.log(testArray[i]);
    }
}
testFunction(testArray);
复制代码

九、 Uncaught TypeError: Cannot set property

当咱们尝试访问一个未定义的变量时，它老是返回 undefined，咱们不能获取或设置任何未定义的属性。 在这种状况下会将抛出 “Uncaught TypeError: Cannot set property”。

10. ReferenceError: event is not defined

当您尝试访问未定义的变量或超出当前做用域的变量时，会引起此错误。 您能够在 Chrome 浏览器中测试。

若是在使用 event 时遇到此错误，请确保使用传入的事件对象做为参数。像 IE 这样的旧浏览器提供了一个全局变量事件，但并非全部浏览器都支持。

document.addEventListener("mousemove", function (event) {
  console.log(event);
})
复制代码

总结

咱们看到上面的 10 个最多见的错误，其实所涉及的知识点并不难。当你认真读过《你不知道的 JavaScript》上卷后，这些错误基本就不会再出现了。

归根结底是对 JavaScript 基础知识掌握的不扎实。

Vue 相关文章输出计划

最近总有朋友问我 Vue 相关的问题，所以接下来我会输出 10 篇 Vue 相关的文章，但愿对你们有必定的帮助。我会保持在 7 到 10 天更新一篇。

1. Vuex 注入 Vue 生命周期的过程（完成）
2. 学习 Vue 源码的必要知识储备（完成）
3. 浅析 Vue 响应式原理（完成）
4. 新老 VNode 进行 patch 的过程
5. 如何开发功能组件并上传 npm
6. 从这几个方面优化你的 Vue 项目
7. 从 Vue-Router 设计讲前端路由发展
8. 在项目中如何正确的使用 Webpack
9. Vue 服务端渲染
10. Axios 与 Fetch 该如何选择

建议你关注个人公众号，第一时间就能够接收最新的文章。

若是你想加群交流，能够扫码自动拉你入群：