Declarao de funo

Sintaxe

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

name

O nome da funo.

param

O nome de um argumento a ser passado para a funo. Uma funo pode ter at 255 argumentos.

statements

As instrues que compem o corpo da funo.

Descrio

Uma funo criada com uma declarao function um objeto Function e tem todas as propriedades, mtodos e comportamentos dos objetos Function. Veja Function para informaes detalhadas sobre as funes.

Uma funo pode tambm ser criada usando uma expresso (veja function expression).

Por padro, funes retornam undefined. Para retornar qualquer outro valor, a funo precisa ter uma instruo return que especifica o valor para retorno.

Criando funes condicionalmente

Funes podem ser condicionalmente declaradas, isso , uma instruo de funo pode ser aninhada dentro de uma instruo if. A maioria dos navegadores que no sejam Mozilla ir tratar essas declaraes condicionais como uma incondicional e criar a funo se a condio for true ou no, veja esse artigo para uma viso geral. Portanto, ela no pode ser usada para criao de expresses de funo condicional.

Declaraes de funes hoisting

Declaraes de funes em JavaScript so hoisted definio da funo. Voc pode usar uma funo antes de t-la declarado:

hoisted(); // logs "foo"

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

Note que function expressions no so hoisted:

notHoisted(); // TypeError: notHoisted is not a function

var notHoisted = function () {
  console.log("bar");
};

Exemplos

Usando funes

O seguinte cdigo declara uma funo que retorna a quantidade total das vendas, quando dados os nmeros 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;
}

Especificaes

Compatibilidade com navegadores

Veja tambm

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