Function.prototype.toString()

Die toString() Methode gibt eine Stringrepräsentation des Quelltextes einer Funktion zurück.

Syntax

function.toString()

Rückgabewert

Eine Stringrepräsentation des Quelltextes der Funktion.

Das Function Objekt überschreibt die von Object geerbte Methode toString (en-US); sie erbt nicht von Object.prototype.toString (en-US). Für benutzerdefinierte Function Objekte gibt die toString Methode einen String zurück, welcher den Quelltext, der die Funktion definiert, enthält.

JavaScript ruft die toString Methode automatisch auf, wenn einen Function als Text repräsentiert werden muss, z. B. wenn eine Funktion mit einem String konkateniert wird.

Die toString() Methode erzeugt eine TypeError Fehler("Function.prototype.toString called on incompatible object"), wenn das Objekt von this Objekt kein Function Objekt ist. Dieser wird auch bei einem Proxy Objekte erzeugt, zum Beispiel:

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

var proxy = new Proxy(function() {}, {});
Function.prototype.toString.call(proxy); // TypeError

Wenn die toString() Methode auf eingebauten Objekten oder einer von Function.prototype.bind erstellten Methode aufgerufen wird, gibt toString() native function string zurück, was wie folgt aussiet:

"function () {\n    [native code]\n}"

Wenn die toString() Methode auf einer Funktion aufgerufen wird, die mit dem Function Konstruktor erstellt wurde, gibt diese den Quelltext der syntetischen Funktionsdeklerations mit dem Namen "anonymous" zurück, welche die Parameter und den Funktionrumpf enthält.

Beispiele

Funktion	Ergebnis von Function.prototype.toString
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}"

Spezifikationen

Spezifikation	Status	Kommentar
ECMAScript 1st Edition (ECMA-262)	Standard	Initiale Definition. Implementiert in JavaScript 1.1.
ECMAScript 2015 (6th Edition, ECMA-262) Die Definition von 'Function.prototype.toString' in dieser Spezifikation.	Standard	Spezifischere Anforderungen wurden an die Stringrepräsentation hinzugefügt.
Function.prototype.toString revision	Draft	Standardisierung nativer Funktionsstrings am Zeilenende.
ECMAScript (ECMA-262) Die Definition von 'Function.prototype.toString' in dieser Spezifikation.	Lebender Standard

Browserkompatibilität

BCD tables only load in the browser

Firefox spezifische Hinweise

Seit Firefox 17, ist Function.prototype.toString() implementiert zum Speichern von Funktionsquelltexten. Der Decompiler wurde entfernt, so das der indentation Parameter nicht mehr gebraucht wird. Für mehr Details siehe Bug 761723.
Seit Firefox 38, erzeugt Function.prototype.toString() einen Fehler für Proxy Objekts (Bug 1100936).

Siehe auch

Object.prototype.toString() (en-US)