概述

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

语法

function.toString()

返回值

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

描述

Function 对象覆盖了从 Object 继承来的 Object.prototype.toString 方法。函数的 toString 方法会返回一个表示函数源代码的字符串。具体来说,包括 function关键字,形参列表,大括号,以及函数体中的内容。

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

this 不是 Function 对象,则 toString() 方法将抛出 TypeError  ("Function.prototype.toString called on incompatible object") 异常,比如 Proxy 对象就会抛出异常。

Function.prototype.toString.call('foo'); // TypeError

var proxy = new Proxy(function() {}, {});
Function.prototype.toString.call(proxy); // 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 Initial definition. Implemented in JavaScript 1.1.
ECMAScript 2015 (6th Edition, ECMA-262)
Function.prototype.toString
Standard Added more specific requirements for the string representation.
Function.prototype.toString revision Draft Standardizes native function string, line endings.
ECMAScript Latest Draft (ECMA-262)
Function.prototype.toString
Draft  

浏览器兼容性

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support (Yes) (Yes) (Yes) (Yes) (Yes)
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support (Yes) (Yes) (Yes) (Yes) (Yes) (Yes)
 

附注

从Firefox 17开始,Function.prototype.toString()通过保存函数源码的方式来实现,而之前是通过反编译器反编译函数字节码的方式来实现。反编译器已经被删除了,因此该函数返回的源码将会和定义时的源码完全相同(包括任何空白符),所以我们不再需要indentation参数来控制缩进了。查看https://bugzilla.mozilla.org/show_bug.cgi?id=761723

相关链接

 

文档标签和贡献者

此页面的贡献者: xmoyKing, lampui, AlexChao, ziyunfei, teoli
最后编辑者: xmoyKing,