前言

看了数千个项目后，发现了 10 个最常见的 JavaScript 错误。我们会告诉你什么原因导致了这些错误，以及如何防止这些错误发生。如果你能够避免落入这些 “陷阱”，你将会成为一个更好的开发者。

一、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>
 );
 }
}

在你的应用程序中的具体代码可能是不同的，但我们希望我们已经给你足够的线索，以解决或避免在你的应用程序中出现的这个问题。如果还没有，请继续阅读，因为我们将在下面覆盖更多相关错误的示例。

2、 TypeError: ‘undefined’ is not an object

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

3、 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>

4、 (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头不存在，则脚本将不会执行。

5、 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();

6、 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”。

原因应该是清楚的，即执行上下文不理解导致的指向错误。

7、 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!

8、 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);

9、 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 基础，理解底层原理和实现。