function
BaselineWidely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Объявление функции определяет функцию с указанными аргументами.
Также вы можете определять функции через конструкторFunction
илифункциональное выражение
.
Синтаксис
function name([param,[, param,[..., param]]]) { [statements]}
name
Имя функции.
paramN
Имя аргумента, переданного в функцию. Максимальное количество аргументов, которое может принять функция, может варьироваться в зависимости от движков.
statements
Инструкции, которые составляют тело функции.
Описание
Функция, созданная через объявление функции, является объектомFunction
и обладает всеми свойствами, методами и поведением объектов такого типа. СмотритеFunction
для подробной информации о функциях.
Также функцию можно создать с помощью выражения (см.функциональное выражение
).
По умолчанию функции возвращаютundefined
. Чтобы вернуть другое значение, функция должна содержать инструкциюreturn
, которая указывает, какое значение возвращать.
Функции, создаваемые по условию
Функции могут объявлены условно, иначе говоря, объявление функции может содержаться внутри условного оператора. Большинство браузеров, отличных от Mozilla, трактуют подобные условные объявления безотносительно условия, и создадут функцию, вне зависимости от истинностного значения условия; смотритестатью об этом. Поэтому такое использование не рекомендуется, для условного создания функций используйте функциональные выражения.
Поднимание объявленной функции
Объявление функции в JavaScript поднимает определение функции. Вы можете использовать функцию до того, как вы её объявили:
hoisted(); // выводит "foo"function hoisted() { console.log("foo");}
Заметьте, чтофункциональные выражения
не поднимаются:
notHoisted(); // TypeError: notHoisted не является функциейvar notHoisted = function () { console.log("bar");};
Примеры
Использованиеfunction
Следующий код объявляет функцию, возвращающую итоговое количество продаж, сложенное из количества продаж продуктовa
,b
иc
.
function calc_sales(units_a, units_b, units_c) { return units_a * 79 + units_b * 129 + units_c * 699;}
Спецификации
Specification |
---|
ECMAScript® 2026 Language Specification # sec-function-definitions |