JavaScript中的错误提示

调试 JavaScript 也许是一场噩梦:一些错误非常难理解,并且给出的错误行号并不是总是很有帮助。如果有一个列表,列举这些错误的意思和如何修复它们,将对我们非常有帮助。

本文列举了 JavaScript 中一些奇怪的错误。对于相同的错误不同的浏览器可能给出不同的提示,所以分别给出了不同的例子。

如何阅读错误

进入正题之前,我们先快速分析一下错误消息的结构,这对我们理解错误消息非常有用,同时也将有助于你理解那些没有在本文中列举的错误。

Chrome 中一个典型的错误看起来像这样:

Uncaught TypeError: undefined is not a function

该错误的结构如下:

1)Uncaught TypeError: 该部分并不是很有用。Uncaught 表示该错误没有被 catch 语句捕获,TypeError 是错误名。

2)undefined is not a function: 是消息体,需要从字面上理解。例如本例中,它的字面意思是,代码尝试将 undefined 当作函数使用。

其他基于 webkit 的浏览器,比如 Safari,错误消息与 Chrome 基本一样。Firefox 的错误消息与上面非常相似,但并不总是都包含第一部分,最近版本的 IE 的错误消息也比 Chrome 的简单,但在这里,更简单并不意味着更好。

下面看看我们经常会遇到的一些错误。

Uncaught TypeError: undefined is not a function

同类错误:

1)number is not a function

2)object is not a function

3)string is not a function

4)Unhandled Error: ‘foo’is not a function

5)Function Expected

尝试将一个值(value)当作函数使用,但该值并不是一个函数。例如:

0wx_fmtjpeg

这个错误很常见,当调用对象中的一个方法,但写错了方法名:

0wx_fmtjpeg

访问对象中不存在的属性时将返回 undefined,上面代码就将出现该错误。

其他类似的错误,比如“number is not a function”发生在尝试将一个 Number 当作函数使用时。

如何修复:确保函数名正确。对于该错误,行号通常准确地指向了错误发生的位置。

Uncaught ReferenceError: Invalid left-hand side inassignment

同类错误:

Uncaught exception: ReferenceError: Cannot assign to ‘functionCall()’

Uncaught exception: ReferenceError: Cannot assign to ‘this’

当尝试给一个不能被赋值的变量赋值时将发生该错误。看下面的典型例子:

0wx_fmtjpeg

在上面例子中,开发人员不小心将 == 写成了 =,错误消息“left-hand side in assignment”指等号左边包含不能被赋值的变量。

如何修复:确保不给函数函数的返回值或 this 关键字赋值。

Uncaught TypeError: Converting circular structure toJSON

同类错误:

1)Uncaught exception: TypeError: JSON.stringify: Not anacyclic Object

2)TypeError: cyclic object value

3)Circular reference in value argument not supported

该错误总是发生在使用 JSON.stringify 序列化一个存在循环引用的对象时。

0wx_fmtjpe

由于上面 a 和 b 两个对象都彼此相互引用,结果导致对象不能被转换为 JSON 字符串。

如何修复:移除将要被转换为 JSON 字符串对象内部的循环引用。

Unexpected token ;

同类错误:

1)Expected )

2)missing ) after argument list

通常发生在缺少括号或分号时。

该错误中所谓的符号(token)可以多种多样,如“Unexpected token ]”或“Expected {”等等。

如何修复:该错误提示的行号有时并不能指向正确的位置,这增加了修复难度。

错误信息中包含“[ ] { } ( )”时,通常是因为缺少配对的部分,检查所有括号,保证都是配对的。这种情况下,行号通常指向了其他位置,问不是错误的位置。

异常的 / 和正则表达式有关,行号指向了正确的位置。

异常的 ; 通常发生在对象、数组或函数调用时参数列表内部包含 ;,行号也指向了正确的位置。

Uncaught SyntaxError: Unexpected token ILLEGAL

同类错误:

1)Unterminated String Literal

2)Invalid Line Terminator

3)字符串字面量缺少闭合的引号。

如何修复:确保所有字符串都包含闭合的引号。

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

同类错误:

1)TypeError: someVal is null

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

尝试将 null 过 undefined 作为一个对象使用,例如:

0wx_fmtjpeg

如何修复:通常是由于书写失误导致,确保错误提示的行号附近的变量都是书写正确的。

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

同类错误:

1)TypeError: someVal is undefined

2)Unable to set property ‘foo’of undefined or null reference

尝试为值为 null 或 undefined 的对象的属性赋值。

0wx_fmtjpeg

如何修复:这也通常是由于书写错误导致,检查错误提示的行号附近的变量名是否正确。

Uncaught RangeError: Maximum call stack size exceeded

同类错误:

1)Uncaught exception: RangeError: Maximum recursiondepth exceeded

2)too much recursion

3)Stack overflow

通常是由程序逻辑问题,导致了无限递归的函数调用。

如何修复:检查函数的递归调用,确保函数不是无限递归的。

Uncaught URIError: URI malformed

同类错误:URIError: malformed URIsequence

无效的 decodeURIComponent 调用将导致该错误。

如何修复:确保行号所指位置的 decodeURIComponent 调用的参数正确。

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

同类错误:

Cross-Origin RequestBlocked: The Same Origin Policy disallows reading the remote resource at http://some/url/

该错误总是由使用 XMLHttpRequest 时导致。

如何修复:确保请求的 url 满足同源策略。

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

同类错误:

1)InvalidStateError

2)DOMException code 11

该错误表示调用对象的方法时,对象的状态不对。在使用 XMLHttpRequest 时,在其准备好之前尝试调用其中的方法将导致该错误。

0wx_fmtjpeg

上例中将导致错误,因为 setRequestHeader 方法只能在 xhr.open 之后调用。

如何修复:检查行号指示的位置,确保代码运行在合适的时间,或在这之前添加必要的函数调用(比如xhr.open)。

来自早读君:

这些运用错误收集排查就很方便定位拉~


关注我

我的微信公众号:前端开发博客,在后台回复以下关键字可以获取资源。

  • 回复「小抄」,领取Vue、JavaScript 和 WebComponent 小抄 PDF
  • 回复「Vue脑图」获取 Vue 相关脑图
  • 回复「思维图」获取 JavaScript 相关思维图
  • 回复「简历」获取简历制作建议
  • 回复「简历模板」获取精选的简历模板
  • 回复「加群」进入500人前端精英群
  • 回复「电子书」下载我整理的大量前端资源,含面试、Vue实战项目、CSS和JavaScript电子书等。
  • 回复「知识点」下载高清JavaScript知识点图谱

每日分享有用的前端开发知识,加我微信:caibaojian89 交流