Function.prototype.toString()

Probieren Sie es aus

function sum(a, b) {
  return a + b;
}

console.log(sum.toString());
// Expected output: "function sum(a, b) {
//                     return a + b;
//                   }"

console.log(Math.abs.toString());
// Expected output: "function abs() { [native code] }"

Syntax

toString()

Parameter

Keine.

Rckgabewert

Ein String, der den Quellcode der Funktion reprsentiert.

Beschreibung

Das Function-Objekt berschreibt die toString()-Methode, die von Object geerbt wurde; es erbt nicht Object.prototype.toString. Bei benutzerdefinierten Function-Objekten gibt die toString-Methode einen String zurck, der das Quelltextsegment enthlt, das zur Definition der Funktion verwendet wurde.

JavaScript ruft die toString-Methode automatisch auf, wenn ein Function-Objekt als Textwert dargestellt werden soll, z. B. wenn eine Funktion mit einem String verkettet wird.

Die toString()-Methode wirft eine TypeError-Ausnahme ("Function.prototype.toString called on incompatible object"), wenn das this-Wertobjekt kein Function-Objekt ist.

Function.prototype.toString.call("foo"); // throws TypeError

Wenn die toString()-Methode auf eingebauten Funktionsobjekten, einer durch Function.prototype.bind() erstellten Funktion oder anderen Nicht-JavaScript-Funktionen aufgerufen wird, gibt toString() einen native function string zurck, der aussieht wie

function someName() { [native code] }

Bei intrinsischen Objektsmethoden und Funktionen ist someName der anfngliche Name der Funktion; andernfalls kann der Inhalt implementierungsabhngig sein, wird jedoch immer in der Eigenschaftennamenssyntax sein, wie [1 + 1], someName oder 1.

Wenn die toString()-Methode auf eine durch den Function-Konstruktor erstellte Funktion aufgerufen wird, gibt toString() den Quellcode einer synthetisierten Funktionsdeklaration namens "anonymous" zurck, wobei die bereitgestellten Parameter und Funktionskrper verwendet werden. Zum Beispiel wird Function("a", "b", "return a + b").toString() folgendes zurckgeben:

function anonymous(a,b
) {
return a + b
}

Seit ES2018 verlangt die Spezifikation, dass der Rckgabewert von toString() genau derselbe Quellcode ist, wie er deklariert wurde, einschlielich aller Leerzeichen und/oder Kommentare oder, falls der Host den Quellcode aus irgendeinem Grund nicht verfgbar hat, muss ein nativer Funktionsstring zurckgegeben werden. Untersttzung fr dieses berarbeitete Verhalten finden Sie in der Kompatibilittstabelle.

Beispiele

Vergleich von tatschlichem Quellcode und toString-Ergebnissen

function test(fn) {
  console.log(fn.toString());
}

function f() {}
class A {
  a() {}
}
function* g() {}

test(f); // "function f() {}"
test(A); // "class A { a() {} }"
test(g); // "function* g() {}"
test((a) => a); // "(a) => a"
test({ a() {} }.a); // "a() {}"
test({ *a() {} }.a); // "*a() {}"
test({ [0]() {} }[0]); // "[0]() {}"
test(Object.getOwnPropertyDescriptor({ get a() {} }, "a").get); // "get a() {}"
test(Object.getOwnPropertyDescriptor({ set a(x) {} }, "a").set); // "set a(x) {}"
test(Function.prototype.toString); // "function toString() { [native code] }"
test(function f() {}.bind(0)); // "function () { [native code] }"
test(Function("a", "b")); // function anonymous(a\n) {\nb\n}

Beachten Sie, dass nach der berarbeitung von Function.prototype.toString() bei einem Aufruf von toString() Implementierungen nie erlaubt sind, einen Funktionsquelltext zu synthetisieren, der kein nativer Funktionsstring ist. Die Methode gibt immer den exakten Quellcode zurck, der zur Erstellung der Funktion verwendet wurde einschlielich der obigen getter- und setter-Beispiele. Der Function-Konstruktor selbst hat die Fhigkeit, den Quellcode fr die Funktion zu synthetisieren (und ist daher eine Form von implizitem eval()).

Erhalten des Quelltexts einer Funktion

Es ist mglich, den Quelltext einer Funktion zu erhalten, indem man sie in einen String umwandelt zum Beispiel, indem man sie in eine Template-Literal einfgt:

function foo() {
  return "bar";
}
console.log(`${foo}`);
// function foo() {
//   return "bar";
// }

Dieser Quelltext ist exakt, einschlielich aller eingefgten Kommentare (die ansonsten nicht von der internen Darstellung der Engine gespeichert werden).

function foo /* a comment */() {
  return "bar";
}
console.log(foo.toString());
// function foo /* a comment */() {
//   return "bar";
// }

Spezifikationen

Browser-Kompatibilitt

Siehe auch

• Object.prototype.toString()