JS错误的诊断与修复

前端开发whqet,csdn,王海庆,whqet,前端开发专家

原文：JavaScript Errors and How to Fix Them

翻译：前端开发whqet， 意译为主，不当之处敬请指正。

作者简介：Jani Hartikainen，拥有十数年的网页应用开发经验，曾经为nokia和低调神秘的startups。(一个创业孵化公司)除了编程和玩游戏，他经常在自己的站点书写JS和高质量的代码。

译者的话，Javascript的调试仍然是大多人的噩梦，有什么妙招吗，看看老外大牛如何说……

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

华丽的分隔线之后，言归正传！

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

Javascript确实是调试者的噩梦，很难理解错误，给出的行号也往往无用，那么有没有一个常见错误诊断和修复列表呢？马上来，请接着看！

下面是我总结的JS奇怪错误列表，鉴于不同浏览器相同错误的错误提示不同，我们给出了一些不同的示例。

如何阅读错误

首先，我们简要看一下错误提示的结构，以便于我们更好的理解错误，以便将来更好的应对列表未列的错误。

一个典型的错误提示貌似如此，

Uncaught TypeError: undefined is not a function

1.Uncaught TypeError：这个部分用处不大，ca说出现了一个catch语句没有捕捉到的错误，错误类型为TypeError（类型错误）。

2.undefined is not a function：这个是错误提示部分，我们必须逐字理解（字面意思理解），例如本例它的字面意思是代码试图将一个undefined类型用作function。

其他的webkit内核的浏览器，例如Safari，提供了和Chrome相似格式的错误提示，Firefox也差不多，但是不包括第一部分。最新版本的IE也提供了更简洁的错误提示，但是（对IE来说，我们懂得），简洁未必代表更好。

现在来看看真正的错误。

Uncaught TypeError: undefined is not a function

相关的错误：number is not a function, object is not a function, string is not a function, Unhandled Error: ‘foo’ is not a function, Function Expected

错误产生：你希望调用一个函数，这个值却不是一个函数。

var foo = undefined;
foo()

很多时候就是因为，函数名称打错了，产生错误。因为对象的不存在属性的默认值为undefined，因此会产生该错误。

var x = document.getElementByID('foo');   //getElementById方法拼写错误

其他类似错误number is not a function，在您试图把一个数字当做函数使用时产生错误。

错误修复：确保函数名正确。这个错误中，错误行号能正确指示。

Uncaught ReferenceError: Invalid left-hand side in assignment

相关错误： Uncaught exception: ReferenceError: Cannot assign to ‘functionCall()’,

                   Uncaught exception: ReferenceError: Cannot assign to ‘this’

错误产生：你试图给某某赋值，但是赋值不成功时产生错误。

这种情况经常发生在if语句中，例如下面的案例，开发者不小心把==写成了=，而且等号左侧的东西不能被赋值，于是产生了错误。

if(doSomething() = 'somevalue')

错误修复：确保不向函数、this关键字赋值。

Uncaught TypeError: Converting circular structure to JSON

相关错误：Uncaught TypeError: Converting circular structure to JSON,

                  TypeError: cyclic object value, Circular reference in value argument not supported

错误产生：产生了环形引用，然后再进行JSON转换（JSON.stringify）时产生错误，如下面代码所示，a和b进行了相互引用，因此不能转换为JSON。

var a = { };
var b = { a: a };
a.b = b;
JSON.stringify(a);

错误修复：去除任何欲转换为JSON的对象中的环形引用。

Unexpected token ;

相关错误：Expected ),

                  missing ) after argument list，

                  Unexpected token ]

错误产生：JS编译器需要点什么，代码里却没有。通常是忘记了匹配的)、]、}、;等。

错误修复：编译器有时不能正确指出错误行号，比较难以修复。

                  An error with [ ] { } ( ) ----主要是没有正常匹配而致，错误行号往往不对。

                  Unexpected /----正则表达式相关错误，错误行号往往是正确的。

                  Unexpected ; ----往往是多了一个分号，例如在对象里、数字字面值、函数调用参数里等，错误行号是正确的。

Uncaught SyntaxError: Unexpected token ILLEGAL

相关错误：Unterminated String Literal,

                  Invalid Line Terminator

错误产生：字符串缺少关闭的引号。

错误修复：确保所有的字符串使用正确的引号。

Uncaught TypeError: Cannot read property ‘foo’ of null,Uncaught TypeError: Cannot read property ‘foo’ of undefined

相关错误：TypeError: someVal is null，

                  Unable to get property ‘foo’ of undefined or null reference

                  Cannot set property ‘foo’ of null, 

                  Cannot set property ‘foo’ of undefined

错误产生：试图将null或undefined当做对象读取属性时，产生错误，如下面代码所示。

var someVal = null;
console.log(someVal.foo);

错误修复：一般为拼写错误，好好检查错误行号周边变量的拼写，确保正确。

Uncaught RangeError: Maximum call stack size exceeded

相关错误：  Uncaught exception: RangeError: Maximum recursion depth exceeded，

                    too much recursion，

                    Stack overflow

错误产生： 由程序逻辑bug造成的无限循环调用函数，无限递归调用函数。

错误修复：检查循环部分，清除造成无限循环的bug。

Uncaught URIError: URI malformed

相关错误：  URIError: malformed URI sequence

错误产生： 错误的URL解析请求所致

错误修复：找见错误行号，修正URL请求。

XMLHttpRequest cannot load http://some/url/. No ‘Access-Control-Allow-Origin’ header is present on the requested resource

相关错误：  Cross-Origin Request Blocked: The Same Origin Policy disallows reading the remote resource at http://some/url/

错误产生： 使用XMLHttpRequest时url有误所致。

错误修复：确保URL正确，并且保证遵循 same-origin policy（同源策略），解决问题的最佳方案是找到错误提示中的URL，并修正错误。

InvalidStateError: An attempt was made to use an object that is not, or is no longer, usable

相关错误： InvalidStateError，

                DOMException code 11

错误产生： 在不能调用一个函数的时候调用一个函数。经常发生在使用XMLHttpRequest时，函数没有准备好时试图调用触发错误。

var xhr = new XMLHttpRequest();
xhr.setRequestHeader('Some-Header', 'val');

上面代码将报出一个错误，setRequestHeader函数只有在xhr.open之后才可以调用。

错误修复：找到提示的错误行，确保代码在正确的时刻运行，或者在改代码前加上必要的方法（例如上面代码的xhr.open）。

总结

Javascript拥有最无力的错误提示，臭名昭著的phpExpected T_PAAMAYIM_NEKUDOTAYIM除外。如果我们能非常熟悉这些错误，将提大大高调试的效率。

你遇到最纠结的错误是什么，欢迎通过评论吐槽。

延伸阅读

Javascript debugging [slightly] beyond console.log

Google Chrome 调试JS简单教程

JavaScript Debug: A simple wrapper for console.log

----------------------------------------------------------

前端开发whqet，关注web前端开发，分享相关资源，欢迎点赞，欢迎拍砖。

---------------------------------------------------------------------------------------------------------