Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

Function()-Konstruktor

Baseline
Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

Warnung: Die an diesen Konstruktor übergebenen Argumente werden dynamisch als JavaScript geparst und ausgeführt. APIs wie diese gelten als Injection-Sinks und können einen Angriffsvektor für Cross-Site-Scripting (XSS) darstellen.

Sie können dieses Risiko verringern, indem Sie stets TrustedScript-Objekte statt Strings übergeben und die Verwendung von Trusted Types erzwingen.

Weitere Informationen finden Sie unter Sicherheitsaspekte.

Der Function()-Konstruktor erstellt Function-Objekte. Durch den direkten Aufruf des Konstruktors lassen sich Funktionen dynamisch erstellen. Dies bringt jedoch Sicherheitsprobleme und ähnliche, wenn auch weitaus weniger bedeutende, Leistungsprobleme mit sich wie eval(). Anders als eval (das möglicherweise Zugriff auf den lokalen Gültigkeitsbereich hat) erstellt der Function-Konstruktor jedoch Funktionen, die ausschließlich im globalen Gültigkeitsbereich ausgeführt werden.

Probieren Sie es aus

const sum = new Function("a", "b", "return a + b");

console.log(sum(2, 6));
// Expected output: 8

Syntax

js
new Function(functionBody)
new Function(arg1, functionBody)
new Function(arg1, arg2, functionBody)
new Function(arg1, arg2, /* …, */ argN, functionBody)

Function(functionBody)
Function(arg1, functionBody)
Function(arg1, arg2, functionBody)
Function(arg1, arg2, /* …, */ argN, functionBody)

Hinweis: Function() kann mit oder ohne new aufgerufen werden. In beiden Fällen wird eine neue Function-Instanz erstellt.

Parameter

arg1, …, argN Optional

TrustedScript-Instanzen oder Strings, die Namen für die formalen Parameter der Funktion angeben. Der Wert muss einem gültigen JavaScript-Parameter entsprechen (einem einfachen Bezeichner, einem Rest-Parameter oder einem destrukturierten Parameter, optional mit einem Standardwert) oder einer durch Kommas getrennten Liste solcher Strings.

Da die Parameter auf dieselbe Weise wie Funktionsausdrücke geparst werden, sind Leerzeichen und Kommentare zulässig. Zum Beispiel: "x", "theValue = 42", "[a, b] /* numbers */" – oder "x, theValue = 42, [a, b] /* numbers */". ("x, theValue = 42", "[a, b]" ist ebenfalls korrekt, wenn auch sehr schwer zu lesen.)

functionBody

Ein TrustedScript oder ein String mit den JavaScript-Anweisungen, aus denen die Funktionsdefinition besteht.

Ausnahmen

SyntaxError

Die Argumente für die Funktionsparameter können nicht als gültige Parameterliste geparst werden, oder functionBody kann nicht als gültige JavaScript-Anweisungen geparst werden.

TypeError

Ein Parameter ist ein String, während Trusted Types durch eine CSP erzwungen werden und keine Standard-Policy definiert ist.

Beschreibung

Mit dem Function-Konstruktor erstellte Function-Objekte werden beim Erstellen der Funktion geparst. Das ist weniger effizient, als eine Funktion mit einem Funktionsausdruck oder einer Funktionsdeklaration zu erstellen und sie im Code aufzurufen, da solche Funktionen zusammen mit dem übrigen Code geparst werden.

Alle an den Konstruktor übergebenen Argumente außer dem letzten werden in der Reihenfolge ihrer Übergabe als Bezeichnernamen für die Parameter der zu erstellenden Funktion behandelt. Die Funktion wird dynamisch als Funktionsausdruck kompiliert, wobei der Quelltext folgendermaßen zusammengesetzt wird:

js
`function anonymous(${args.join(",")}
) {
${functionBody}
}`;

Dies lässt sich durch Aufrufen der Methode toString() der Funktion beobachten.

Anders als bei gewöhnlichen Funktionsausdrücken wird der Name anonymous jedoch nicht zum Gültigkeitsbereich von functionBody hinzugefügt, da functionBody nur Zugriff auf den globalen Gültigkeitsbereich hat. Wenn functionBody nicht im Strict Mode ausgeführt wird (der Funktionskörper selbst muss die Direktive "use strict" enthalten, da er den Strict Mode nicht aus dem umgebenden Kontext übernimmt), können Sie mit arguments.callee auf die Funktion selbst verweisen. Alternativ können Sie den rekursiven Teil als innere Funktion definieren:

js
const recursiveFn = new Function(
  "count",
  `
(function recursiveFn(count) {
  if (count < 0) {
    return;
  }
  console.log(count);
  recursiveFn(count - 1);
})(count);
`,
);

Beachten Sie, dass die beiden dynamischen Teile des zusammengesetzten Quelltexts – die Parameterliste args.join(",") und functionBody – zunächst getrennt geparst werden, um sicherzustellen, dass beide syntaktisch gültig sind. Dadurch werden injektionsartige Versuche verhindert.

js
new Function("/*", "*/) {");
// SyntaxError: Unexpected end of arg string
// Doesn't become "function anonymous(/*) {*/) {}"

Sicherheitsaspekte

Mit dieser Methode können beliebige Eingaben ausgeführt werden, die an einen der Parameter übergeben werden. Handelt es sich bei der Eingabe um einen potenziell unsicheren, von einem Benutzer bereitgestellten String, kann dies einen Angriffsvektor für Cross-Site-Scripting (XSS) darstellen. Das folgende Beispiel geht davon aus, dass untrustedCode von einem Benutzer bereitgestellt wurde:

js
const untrustedCode = "alert('Potentially evil code!');";
const adder = new Function("a", "b", untrustedCode);

Websites mit einer Content Security Policy (CSP), die script-src oder default-src angibt, verhindern standardmäßig die Ausführung solchen Codes. Wenn Sie die Ausführung von Skripten über Function() zulassen müssen, können Sie diese Risiken verringern, indem Sie stets TrustedScript-Objekte statt Strings übergeben und mithilfe der CSP-Direktive require-trusted-types-for die Verwendung von Trusted Types erzwingen. Dadurch wird sichergestellt, dass die Eingabe eine Transformationsfunktion durchläuft.

Damit Function() ausgeführt werden kann, müssen Sie außerdem das Schlüsselwort trusted-types-eval in der CSP-Direktive script-src angeben. Das Schlüsselwort unsafe-eval erlaubt Function() ebenfalls, ist aber deutlich weniger sicher als trusted-types-eval, da es die Ausführung auch in Browsern zulassen würde, die Trusted Types nicht unterstützen.

Die für Ihre Website erforderliche CSP könnte beispielsweise so aussehen:

http
Content-Security-Policy: require-trusted-types-for 'script'; script-src '<your_allowlist>' 'trusted-types-eval'

Das Verhalten der Transformationsfunktion hängt vom konkreten Anwendungsfall ab, für den ein vom Benutzer bereitgestelltes Skript erforderlich ist. Wenn möglich, sollten Sie die zulässigen Skripte genau auf den Code beschränken, dessen Ausführung Sie vertrauen. Falls das nicht möglich ist, können Sie die Verwendung bestimmter Funktionen innerhalb des bereitgestellten Strings zulassen oder blockieren.

Beispiele

Der Kürze halber wird in diesen Beispielen auf die Verwendung von Trusted Types verzichtet. Code, der den empfohlenen Ansatz zeigt, finden Sie unter Verwendung von TrustedScript bei eval().

Argumente mit dem Function-Konstruktor angeben

Der folgende Code erstellt ein Function-Objekt, das zwei Argumente entgegennimmt.

js
// Example can be run directly in your JavaScript console

// Create a function that takes two arguments, and returns the sum of those arguments
const adder = new Function("a", "b", "return a + b");

// Call the function
adder(2, 6);
// 8

Die Argumente a und b sind Namen formaler Parameter, die im Funktionskörper return a + b verwendet werden.

Ein Funktionsobjekt aus einer Funktionsdeklaration oder einem Funktionsausdruck erstellen

js
// The function constructor can take in multiple statements separated by a semicolon. Function expressions require a return statement with the function's name

// Observe that new Function is called. This is so we can call the function we created directly afterwards
const sumOfArray = new Function(
  "const sumArray = (arr) => arr.reduce((previousValue, currentValue) => previousValue + currentValue); return sumArray",
)();

// call the function
sumOfArray([1, 2, 3, 4]);
// 10

// If you don't call new Function at the point of creation, you can use the Function.call() method to call it
const findLargestNumber = new Function(
  "function findLargestNumber (arr) { return Math.max(...arr) }; return findLargestNumber",
);

// call the function
findLargestNumber.call({}).call({}, [2, 4, 1, 8, 5]);
// 8

// Function declarations do not require a return statement
const sayHello = new Function(
  "return function (name) { return `Hello, ${name}` }",
)();

// call the function
sayHello("world");
// Hello, world

Spezifikationen

Spezifikation
ECMAScript® 2027 Language Specification
# sec-function-constructor

Browser-Kompatibilität

Siehe auch