JS常见错误类型有哪些？

在文章实战开发的过程中，我们经常会遇到一些这样那样的问题，然后要卡好半天，等问题解决了才发现原来一些细节知识点还是没有掌握好。今天golang学习网就整理分享《JS常见错误类型有哪些？》，聊聊，希望可以帮助到正在努力赚钱的你。

浏览器中JavaScript错误可分为语法错误（SyntaxError）、运行时错误（如ReferenceError、TypeError）、逻辑错误、异步错误及浏览器环境相关错误；2. 语法错误在解析阶段发生，运行时错误在执行中出现，逻辑错误导致结果不符，异步错误涉及Promise未捕获拒绝，环境差异引发兼容性问题；3. 调试需结合工具、console.log、断点及兼容性策略，理解错误本质是提升代码健壮性的关键。

浏览器中JavaScript的错误种类繁多，但归根结底，它们通常指向代码在不同生命周期阶段（解析、执行）或不同逻辑层面上（语法、运行时、业务逻辑）出现的问题。理解这些错误类型，是高效调试和编写健壮代码的关键一步。

解决方案

要深入理解浏览器JS错误，我们不妨从它们被“发现”的时机和性质来分类。在我看来，这不仅仅是记住几个错误名称那么简单，更是一种排查思路的建立。从最显而易见的语法问题，到运行时那些狡猾的异常，再到更深层次的逻辑缺陷，每一种错误都有其独特的面貌和诊断方法。

语法错误（SyntaxError）：代码还没跑就错了？

说实话，SyntaxError可能是我们最先遇到，也往往是最容易解决的一类错误。它们发生在你代码还没真正执行，或者说，JavaScript引擎在尝试解析你的代码时就发现了问题。这就像你写了一篇文章，但标点符号、词语搭配甚至句式结构都有明显错误，读者（这里是JS引擎）根本无法理解你想表达什么。

比如，你可能忘了闭合括号、引号，或者使用了保留字作为变量名，再或者，写了一个不符合JS语法的表达式。在我个人的开发经历中，这种错误通常是由于粗心大意，或者在快速迭代时复制粘贴代码后忘记调整导致的。比如下面这种：

const myVar = 'hello; // 忘记闭合引号
console.log(myVar);

浏览器控制台会直接告诉你Uncaught SyntaxError: Invalid or unexpected token。它甚至不会给你执行的机会。所以，当你看到这类错误时，第一反应通常是检查报错行附近的字符，看看是不是少了个逗号、多了个分号，或者括号没有配对。现代IDE和Linter工具在这方面帮了大忙，它们能在你保存文件前就指出这些问题，极大提升了开发效率。

运行时错误（ReferenceError, TypeError, RangeError等）：执行时才露马脚？

如果你的代码通过了语法检查，恭喜你，它至少是“合法的”了。但真正的挑战往往在运行时才浮现。这类错误通常被称为“异常”，它们会在代码执行到某个特定点时，因为某个操作不符合预期而突然中止。运行时错误种类繁多，但最常见的几个几乎是每个JS开发者都会反复遭遇的“老朋友”：

• ReferenceError： 当你尝试访问一个未声明的变量或函数时，就会遇到它。比如，你可能拼错了变量名，或者在一个作用域之外尝试访问局部变量。

  console.log(nonExistentVar); // nonExistentVar 未定义
  // Uncaught ReferenceError: nonExistentVar is not defined

  这种错误提示非常直接，通常指向你尝试使用的那个“不存在”的标识符。

• TypeError： 这绝对是JS运行时错误的“常客”。它表示你对一个值进行了不合法的操作。最常见的场景是：

  • 尝试调用一个非函数的值（null或undefined）。
  • 尝试访问null或undefined的属性。
  • 对一个不可变的值进行修改。

  let obj = null;
  console.log(obj.property); // obj是null，没有property
  // Uncaught TypeError: Cannot read properties of null (reading 'property')
  
  let str = "hello";
  str.toUpperCase = function() {}; // 字符串是原始值，不可修改其方法
  // Uncaught TypeError: Cannot assign to read only property 'toUpperCase' of string 'hello'

  调试TypeError时，核心是弄清楚你正在操作的值到底是什么类型，是不是你预期的那个类型。console.log()大法在这里屡试不爽。

• RangeError： 当一个数值超出其有效范围时，就会抛出此错误。例如，你尝试创建一个长度为负数的数组，或者在递归函数中达到了调用栈的上限（Stack Overflow）。

  new Array(-1);
  // Uncaught RangeError: Invalid array length
  
  function infiniteRecursion() {
      infiniteRecursion();
  }
  infiniteRecursion();
  // Uncaught RangeError: Maximum call stack size exceeded

  这种错误通常提示你检查数值参数的边界条件，或者留意递归的终止条件。

• URIError： 这类错误与全局URI处理函数（如encodeURI(), decodeURIComponent()）有关。当你给它们传递了格式不正确的URI序列时，就会抛出。

  decodeURIComponent('%');
  // Uncaught URIError: URI malformed

  虽然不常见，但如果你的应用涉及到URL编码解码，值得留意。

• EvalError： 这是一个比较古老的错误类型，与eval()函数的使用有关。现在，由于eval()的安全性和性能问题，它很少被推荐使用，因此这个错误也相对少见。

运行时错误往往需要你更深入地理解代码的执行流程和数据状态。它们不会在代码解析阶段就暴露，而是像一个隐藏的定时炸弹，在特定条件下才会引爆。

逻辑错误：代码跑了，但结果不对？

这是最让人头疼的一类“错误”，因为它根本不会抛出任何异常！你的代码完美运行，没有SyntaxError，也没有运行时异常，但最终的输出或行为却不是你想要的。这就像你给机器下达了一系列指令，机器也一丝不苟地执行了，但由于你的指令本身逻辑有误，导致了南辕北辙的结果。

举个例子，你可能想要计算一个数组的总和，但却写成了累乘；或者在if语句中使用了错误的条件，导致分支逻辑判断失误；再或者，在循环中出现了“差一错误”（off-by-one error）。

// 假设我们想求和，却写成了累乘
function calculateSum(numbers) {
    let result = 1; // 初始值应该是0
    for (let i = 0; i < numbers.length; i++) {
        result *= numbers[i]; // 应该是 result += numbers[i];
    }
    return result;
}
console.log(calculateSum([1, 2, 3])); // 期望是6，实际是6 (巧合)，但如果是[2,3,4]呢？期望是9，实际是24

调试逻辑错误需要更多的耐心和系统性。它不像语法或运行时错误那样有明确的错误信息指向问题所在。你可能需要：

• 单元测试： 编写测试用例来验证你的函数在不同输入下的输出是否符合预期。
• 逐步调试： 使用浏览器的开发者工具，设置断点，一步一步地执行代码，观察变量的值变化，找出与预期不符的地方。
• 大量的console.log： 在关键位置打印变量值、函数调用结果，追踪数据流。
• 重构与简化： 有时候，复杂的逻辑本身就容易出错。尝试将大问题拆解成小问题，简化代码结构。

在我看来，逻辑错误是对开发者思维缜密性最大的考验，也是最能体现一个开发者经验和能力的方面。

异步错误与未捕获的Promise拒绝：现代JS的陷阱？

随着JavaScript异步编程范式的普及，特别是Promise和async/await的广泛应用，错误处理也变得更加微妙。传统的try...catch块在同步代码中工作得很好，但在异步回调中，它可能无法捕获到发生在不同事件循环周期中的错误。

例如，一个没有catch处理的Promise，如果内部抛出了错误，它不会像同步代码那样立即中断程序执行，而是可能导致一个“未捕获的Promise拒绝”（unhandled rejection）。

new Promise((resolve, reject) => {
    setTimeout(() => {
        reject('Something went wrong!'); // 这个错误没有被捕获
    }, 100);
});
// 浏览器控制台会报：Uncaught (in promise) Something went wrong!
// 并且可能会触发 window.addEventListener('unhandledrejection', ...)

在async/await中，情况会好一些，因为await会“等待”Promise的解决或拒绝，因此你可以像同步代码一样使用try...catch：

async function fetchData() {
    try {
        const response = await new Promise((resolve, reject) => {
            setTimeout(() => reject('Network error'), 100);
        });
        console.log(response);
    } catch (error) {
        console.error('Caught an async error:', error); // 错误在这里被捕获
    }
}
fetchData();

处理异步错误的关键在于确保每一个可能抛出异常的异步操作都有相应的错误处理机制，无论是Promise.prototype.catch()、try...catch块，还是全局的unhandledrejection事件监听。否则，这些错误就像“幽灵”一样，虽然不直接崩溃你的应用，但可能导致数据不一致或UI状态异常。

浏览器特有错误与环境差异：跨平台开发者的痛点？

最后，我们不能忽视那些并非纯粹JavaScript语言层面的错误，而是与浏览器环境紧密相关的“错误”或不兼容问题。这通常发生在Web API的调用上，或者不同浏览器对同一标准的不同实现上。

• DOM操作错误： 比如尝试在一个尚未加载完成的DOM元素上执行操作，或者使用了浏览器不支持的DOM API。
• Web API兼容性： 某些新的Web API可能只在最新版本的浏览器中支持，旧版浏览器调用时会抛出TypeError（因为该方法不存在）或ReferenceError。
• Canvas/WebGL错误： 在图形渲染时，如果上下文丢失、资源加载失败或着色器代码有误，都可能导致特定的错误。
• 安全策略错误： 比如跨域请求（CORS）失败，虽然不是JS代码本身的错误，但会在控制台显示错误信息，并阻止JS获取响应。

这些问题往往需要开发者了解目标用户的浏览器环境，并采取相应的兼容性策略，比如使用Polyfill、特性检测（feature detection），或者引入Babel等工具进行代码转译。有时候，一个在Chrome上跑得好好的功能，在Safari或Firefox上就报错，这背后往往就是环境差异在作祟。解决这类问题，除了经验，还需要善用MDN文档和Can I use...这样的资源。

总的来说，浏览器JS错误是一个多维度的议题。从基础的语法到复杂的异步逻辑，再到环境兼容性，每一种错误类型都考验着开发者对JavaScript语言本身以及Web生态的理解深度。掌握它们，意味着你离写出更健壮、更可靠的Web应用又近了一步。

今天关于《JS常见错误类型有哪些？》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！