此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。
TypeError
Baseline Widely available *
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.
* Some parts of this feature may have varying levels of support.
TypeError（类型错误）对象通常（但并不只是）用来表示值的类型非预期类型时发生的错误。
以下情况会抛出TypeError：
- 传递给运算符的操作数或传递给函数的参数与预期的类型不兼容；或
- 尝试修改无法更改的值；或
- 尝试以不适当的方法使用一个值。
TypeError 是一个可序列化对象，所以可以使用structuredClone() 对它进行克隆，也可以使用postMessage() 在Worker 之间拷贝它。
构造函数
TypeError()创建一个新的
TypeError对象。
实例属性
Error.prototype.message错误消息。继承自
Error。Error.prototype.name错误名称。继承自
Error。Error.prototype.cause表示导致当前错误被抛出的原因。继承自
Error。Error.prototype.fileName非标准引发此错误的文件的路径。继承自
Error。Error.prototype.lineNumber非标准引发此错误的代码所在的文件的行号。继承自
Error。Error.prototype.columnNumber非标准引发此错误的代码在文件中所在行的列号。继承自
Error。Error.prototype.stack非标准堆栈跟踪。继承自
Error。
示例
捕获类型错误
js
try { null.f();} catch (e) { console.log(e instanceof TypeError); // true console.log(e.message); // "null has no properties" console.log(e.name); // "TypeError" console.log(e.fileName); // "Scratchpad/1" console.log(e.lineNumber); // 2 console.log(e.columnNumber); // 2 console.log(e.stack); // "@Scratchpad/2:2:3\n"}创建一个类型错误
js
try { throw new TypeError("Hello", "someFile.js", 10);} catch (e) { console.log(e instanceof TypeError); // true console.log(e.message); // "Hello" console.log(e.name); // "TypeError" console.log(e.fileName); // "someFile.js" console.log(e.lineNumber); // 10 console.log(e.columnNumber); // 0 console.log(e.stack); // "@Scratchpad/2:2:9\n"}规范
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-native-error-types-used-in-this-standard-typeerror |