toString() 方法返回一个表示当前函数源代码的字符串。

语法

function.toString()

返回值

表示函数源代码的一个字符串

描述

Function对象覆盖了从Object继承来的toString 方法。对于用户定义的 Function 对象,toString方法返回一个字符串,其中包含用于定义函数的源文本段。

Function需要转换为字符串时,通常会自动调用函数的 toString 方法。

this 不是 Function 对象,则 toString() 方法将抛出 TypeError  ("Function.prototype.toString called on incompatible object") 异常,比如 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}"

规范

规范版本 规范状态 注解
ECMAScript 1st Edition (ECMA-262) Standard 初始定义。在 JavaScript 1.1 中实现。
ECMAScript 2015 (6th Edition, ECMA-262)
Function.prototype.toString
Standard 对字符串表示增加了更多的特定需求。
Function.prototype.toString revision Draft 对内置函数与行尾表示进行标准化。
ECMAScript Latest Draft (ECMA-262)
Function.prototype.toString
Draft  

浏览器兼容性

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidSafari on iOSSamsung InternetNode.js
toStringChrome Full support YesEdge Full support 12Firefox Full support 1IE Full support 5Opera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesEdge Mobile Full support YesFirefox Android Full support 4Opera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support Yesnodejs Full support Yes
Support of toString revisionChrome No support NoEdge No support NoFirefox Full support 54IE No support NoOpera No support NoSafari No support NoWebView Android No support NoChrome Android No support NoEdge Mobile No support NoFirefox Android Full support 54Opera Android No support NoSafari iOS No support NoSamsung Internet Android No support Nonodejs No support No

Legend

Full support  
Full support
No support  
No support

附注(针对Firefox)

  • 从Firefox 17开始,Function.prototype.toString() 通过保存函数源码的方式来实现,而之前是通过反编译器反编译函数字节码的方式来实现。反编译器已经被移除,因此我们不再需要 indentation 参数。查看 bug 761723 获得更多信息。
  • 从Firefox 38开始,Function.prototype.toString() 会对 Proxy 对象抛出异常 (bug 1100936)。

相关链接

文档标签和贡献者

标签: 
最后编辑者: mdnwebdocs-bot,