HTML: Markup language
CSS: Styling language
JavaScript: Scripting language
Web APIs: Programming interfaces
All web technology
Learn web development
Discover our tools
Get to know MDN better
Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.
View in English Always switch to English
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Die function Deklaration erstellt eine Bindung einer neuen Funktion mit einem gegebenen Namen.
function
Sie können Funktionen auch mithilfe des function Ausdrucks definieren.
function calcRectArea(width, height) { return width * height; } console.log(calcRectArea(5, 6)); // Expected output: 30
function name(param0) { statements } function name(param0, param1) { statements } function name(param0, param1, /* …, */ paramN) { statements }
name
Der Funktionsname.
param
Der Name eines formalen Parameters für die Funktion. Die maximale Anzahl von Argumenten variiert in verschiedenen Engines. Für die Syntax der Parameter siehe die Referenz für Funktionen.
statements
Die Anweisungen, die den Rumpf der Funktion bilden.
Eine function Deklaration erstellt ein Function Objekt. Jedes Mal, wenn eine Funktion aufgerufen wird, gibt sie den Wert zurück, der durch die zuletzt ausgeführte return Anweisung angegeben wird, oder undefined, wenn das Ende des Funktionsrumpfes erreicht ist. Siehe Funktionen für detaillierte Informationen zu Funktionen.
Function
return
undefined
function Deklarationen verhalten sich wie eine Mischung aus var und let:
var
let
globalThis
Warnung: Im Nicht-strict Mode verhalten sich Funktionsdeklarationen innerhalb von Blöcken seltsam. Deklarieren Sie Funktionen innerhalb von Blöcken nur, wenn Sie sich im strict mode befinden.
Funktionen können bedingt deklariert werden – das heißt, eine Funktionsanweisung kann innerhalb einer if Anweisung geschachtelt werden. Im Nicht-strict Mode sind die Ergebnisse jedoch inkonsistent zwischen Implementierungen.
if
console.log( `'foo' name ${ "foo" in globalThis ? "is" : "is not" } global. typeof foo is ${typeof foo}`, ); if (false) { function foo() { return 1; } } // In Chrome: // 'foo' name is global. typeof foo is undefined // // In Firefox: // 'foo' name is global. typeof foo is undefined // // In Safari: // 'foo' name is global. typeof foo is function
Die Wirkung auf den Gültigkeitsbereich und das Hoisting ändert sich nicht, unabhängig davon, ob der if-Körper tatsächlich ausgeführt wird.
console.log( `'foo' name ${ "foo" in globalThis ? "is" : "is not" } global. typeof foo is ${typeof foo}`, ); if (true) { function foo() { return 1; } } // In Chrome: // 'foo' name is global. typeof foo is undefined // // In Firefox: // 'foo' name is global. typeof foo is undefined // // In Safari: // 'foo' name is global. typeof foo is function
Im strict mode sind Funktionsdeklarationen auf Blockebene auf diesen Block beschränkt und werden an die Spitze des Blocks gehoben.
"use strict"; { foo(); // Logs "foo" function foo() { console.log("foo"); } } console.log( `'foo' name ${ "foo" in globalThis ? "is" : "is not" } global. typeof foo is ${typeof foo}`, ); // 'foo' name is not global. typeof foo is undefined
Funktionsdeklarationen in JavaScript werden an die Spitze des umgebenden Funktions- oder globalen Gültigkeitsbereichs gehoben. Sie können die Funktion verwenden, bevor Sie sie deklariert haben:
hoisted(); // Logs "foo" function hoisted() { console.log("foo"); }
Beachten Sie, dass Funktionsausdrücke nicht gehoben werden:
notHoisted(); // TypeError: notHoisted is not a function var notHoisted = function () { console.log("bar"); };
Ob function Deklarationen im gleichen Gültigkeitsbereich neu deklariert werden können, hängt davon ab, in welchem Gültigkeitsbereich sie enthalten sind.
Auf oberster Ebene eines Skripts verhalten sich function Deklarationen wie var und können durch eine andere function oder var neu deklariert werden, aber nicht durch let, const, oder class.
const
class
function a(b) {} function a(b, c) {} console.log(a.length); // 2 let a = 2; // SyntaxError: Identifier 'a' has already been declared
Wenn function Deklarationen durch var neu deklariert werden, überschreibt der Initialisierer der var Deklaration immer den Funktionswert, unabhängig von ihrer relativen Position. Dies liegt daran, dass Funktionsdeklarationen vor allen Initialisierern gehoben werden, sodass der Initialisierer später kommt und den Wert überschreibt.
var a = 1; function a() {} console.log(a); // 1
Auf der obersten Ebene des Funktionsrumpfes verhält sich function auch wie var und kann neu deklariert werden oder denselben Namen wie ein Parameter haben.
function foo(a) { function a() {} console.log(typeof a); } foo(2); // Logs "function"
Auf der obersten Ebene eines Moduls oder eines Blocks im strict mode verhalten sich function Deklarationen wie let und können durch keine andere Deklaration neu deklariert werden.
// Assuming current source is a module function foo() {} function foo() {} // SyntaxError: Identifier 'foo' has already been declared
"use strict"; { function foo() {} function foo() {} // SyntaxError: Identifier 'foo' has already been declared }
Eine function Deklaration innerhalb eines catch Blocks kann nicht denselben Namen wie der catch-gebundene Bezeichner haben, selbst im Nicht-strict Mode.
catch
try { } catch (e) { function e() {} // SyntaxError: Identifier 'e' has already been declared }
Der folgende Code deklariert eine Funktion, die den Gesamtbetrag an Verkäufen zurückgibt, wenn die Anzahl der verkauften Einheiten von drei Produkten angegeben ist.
function calcSales(unitsA, unitsB, unitsC) { return unitsA * 79 + unitsB * 129 + unitsC * 699; }
JavaScript aktivieren, um diese Browser-Kompatibilitätstabelle anzuzeigen.
function*
async function
async function*