Declaração de função
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
A declaração function define uma função com os especificados parâmetros.
Você pode também definir funções usando o construtor Function
e uma function 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 objeto Function
e tem todas as propriedades, métodos e comportamentos dos objetos Function
. Veja Function
para informações detalhadas sobre as funções.
Uma função pode também ser criada usando uma expressão (veja function expression
).
Por padrão, funções retornam undefined
. Para retornar qualquer outro valor, a função precisa ter uma instrução return
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ção if
. 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, veja esse 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 que function expressions
não são hoisted:
notHoisted(); // TypeError: notHoisted is not a function
var 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
Specification |
---|
ECMAScript Language Specification # sec-function-definitions |
Compatibilidade com navegadores
BCD tables only load in the browser