Adeclaração function define uma função com os especificados parâmetros.

Você pode também definir funções usando o construtorFunction e umafunction expression.

Sintaxe

function name([param,[, param,[..., param]]]) {   [statements]}

name

O nome da função.

param

O nome de um argumento a ser passado para a função. Uma função pode ter atè 255 argumentos.

statements

As instruções que compõem o corpo da função.

Descrição

Uma função criada com uma declaração function é um objetoFunction e tem todas as propriedades, métodos e comportamentos dos objetosFunction. VejaFunction para informações detalhadas sobre as funções.

Uma função pode também ser criada usando uma expressão (vejafunction expression).

Por padrão, funções retornamundefined. Para retornar qualquer outro valor, a função precisa ter uma instruçãoreturn que especifica o valor para retorno.

Criando funções condicionalmente

Funções podem ser condicionalmente declaradas, isso é, uma instrução de função pode ser aninhada dentro de uma instruçãoif. A maioria dos navegadores que não sejam Mozilla ir tratar essas declarações condicionais como uma incondicional e criará a função se a condição for true ou não, vejaesse artigo para uma visão geral. Portanto, ela não pode ser usada para criação de expressões de função condicional.

Declarações de funções hoisting

Declarações de funções em JavaScript são hoisted à definição da função. Você pode usar uma função antes de tê-la declarado:

hoisted(); // logs "foo"function hoisted() {  console.log("foo");}

Note quefunction expressions não são hoisted:

notHoisted(); // TypeError: notHoisted is not a functionvar notHoisted = function () {  console.log("bar");};

Exemplos

Usando funções

O seguinte código declara uma função que retorna a quantidade total das vendas, quando dados os números de unidades vendidas dos produtos a, b e c.

function calc_sales(units_a, units_b, units_c) {  return units_a * 79 + units_b * 129 + units_c * 699;}

Especificações

Compatibilidade com navegadores

Veja também

• Functions and function scope
• Function
• function expression
• function* statement
• function* expression
• Arrow functions
• GeneratorFunction