JS错误的诊断与修复

梦里梦外; 2022-08-06 13:29 154阅读 0赞

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  
错误产生：你希望调用一个函数，这个值却不是一个函数。

1.  var foo = undefined;  
    
2.  foo()

复制代码

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

1.  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语句中，例如下面的案例，开发者不小心把==写成了=，而且等号左侧的东西不能被赋值，于是产生了错误。

1.  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。

1.  var a = \{ \};  
    
2.  var b = \{ a: a \};  
    
3.  a.b = b;  
    
4.  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当做对象读取属性时，产生错误，如下面代码所示。

1.  var someVal = null;  
    
2.  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时，函数没有准备好时试图调用触发错误。

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

复制代码

上面代码将报出一个错误，setRequestHeader函数只有在xhr.open之后才可以调用。  
错误修复：找到提示的错误行，确保代码在正确的时刻运行，或者在改代码前加上必要的方法（例如上面代码的xhr.open）。  
总结  
Javascript拥有最无力的错误提示，臭名昭著的phpExpected T\_PAAMAYIM\_NEKUDOTAYIM除外。如果我们能非常熟悉这些错误，将提大大高调试的效率。  
你遇到最纠结的错误是什么，欢迎通过评论吐槽。  
延伸阅读

[Javascript debugging \[slightly\] beyond console.log][Javascript debugging _slightly_ beyond console.log]

[Google Chrome 调试JS简单教程][Google Chrome _JS]

[JavaScript Debug: A simple wrapper for console.lo][JavaScript Debug_ A simple wrapper for console.lo]g

[Javascript debugging _slightly_ beyond console.log]: http://swizec.com/blog/javascript-debugging-slightly-beyond-console-log/swizec/6633?utm_source=javascriptweekly&utm_medium=email
[Google Chrome _JS]: http://www.markdream.com/technologies/programs/chrome-google-js-debug.shtml
[JavaScript Debug_ A simple wrapper for console.lo]: http://benalman.com/projects/javascript-debug-console-log/