--- title: Function.prototype.toString() slug: Web/JavaScript/Reference/Global_Objects/Function/toString tags: - Function - JavaScript - Method translation_of: Web/JavaScript/Reference/Global_Objects/Function/toString ---
toString() 方法返回一个表示当前函数源代码的字符串。
function.toString()
表示函数源代码的一个字符串
{{jsxref("Function")}}对象覆盖了从{{jsxref("Object")}}继承来的{{jsxref("Object.prototype.toString", "toString")}} 方法。对于用户定义的 {{jsxref("Function")}} 对象,toString方法返回一个字符串,其中包含用于定义函数的源文本段。
在{{jsxref("Function")}}需要转换为字符串时,通常会自动调用函数的 toString 方法。
若 this 不是 Function 对象,则 toString() 方法将抛出 {{jsxref("TypeError")}} ("Function.prototype.toString called on incompatible object") 异常,比如 {{jsxref("Proxy")}} 对象就会抛出异常。
Function.prototype.toString.call('foo'); // TypeError
如果是在内置函数或由 Function.prototype.bind 返回的函数上调用 toString(),则toString() 返回原生代码字符串,如下
"function () {\n [native code]\n}"
若是在由 Function 构造器生成的函数上调用 toString() ,则 toString() 返回创建后的函数源码,包括形参和函数体,函数名为 "anonymous"。
| Function | Function.prototype.toString result |
|---|---|
function f(){}
|
"function f(){}"
|
class A { a(){} }
|
"class A { a(){} }"
|
function* g(){}
|
"function* g(){}"
|
a => a |
"a => a" |
({ a(){} }.a)
|
"a(){}"
|
({ *a(){} }.a)
|
"*a(){}"
|
({ [0](){} }[0])
|
"[0](){}"
|
Object.getOwnPropertyDescriptor({
get a(){}
}, "a").get
|
"get a(){}"
|
Object.getOwnPropertyDescriptor({
set a(x){}
}, "a").set
|
"set a(x){}"
|
Function.prototype.toString |
"function toString() { [native code] }"
|
(function f(){}.bind(0))
|
"function () { [native code] }"
|
Function("a", "b")
|
"function anonymous(a\n) {\nb\n}"
|
| 规范版本 | 规范状态 | 注解 |
|---|---|---|
| {{SpecName('ES1')}} | {{Spec2('ES1')}} | 初始定义。在 JavaScript 1.1 中实现。 |
| {{SpecName('ES6', '#sec-function.prototype.tostring', 'Function.prototype.toString')}} | {{Spec2('ES6')}} | 对字符串表示增加了更多的特定需求。 |
| Function.prototype.toString revision | Draft | 对内置函数与行尾表示进行标准化。 |
| {{SpecName('ESDraft', '#sec-function.prototype.tostring', 'Function.prototype.toString')}} | {{Spec2('ESDraft')}} |
{{Compat("javascript.builtins.Function.toString")}}
Function.prototype.toString() 通过保存函数源码的方式来实现,而之前是通过反编译器反编译函数字节码的方式来实现。反编译器已经被移除,因此我们不再需要 indentation 参数。查看 {{bug("761723")}} 获得更多信息。Function.prototype.toString() 会对 {{jsxref("Proxy")}} 对象抛出异常 ({{bug(1100936)}})。