Instrução function do JavaScript

Definição e uso

A instrução function declara uma função.

As funções declaradas são “salvas para uso posterior” e serão executadas em uma chamada posterior.

No JavaScript, as funções são objetos que possuem tanto atributos quanto métodos.

Também é possível definir funções usando expressões (veja definição de função).

Leia nosso tutorial de JavaScript para saber tudo que você precisa saber sobre funções. Comece com os capítulos sobre funções JavaScript e escopo JavaScript. Para mais detalhes, leia nossos tutoriais sobre definição de função, parâmetros, chamada e closures.

Dica:Use a instrução return para retornar um valor da função.

Exemplo

Declare uma função e escreva "Hello World" no elemento com id="demo" ao chamar essa função:

function myFunction() { // Declara a função
  document.getElementById("demo").innerHTML = "Hello World!";
}
myFunction(); // Chama a função

Experimente você mesmo

Mais exemplos TIY estão na parte inferior da página.

Sintaxe

function functionName(parameters) {
  código a ser executado
}

Valor do parâmetro

Parâmetro Descrição
functionName Obrigatório. Especifica o nome da função, que pode ser “salvo para uso posterior”. O nome da função pode conter letras, números, sublinhados e símbolos de dólar (segundo as regras das variáveis).
parameters

Opcional. Especifique um grupo de zero ou mais nomes de parâmetros, separados por vírgula.

Os parâmetros da função são os nomes listados na definição da função.

Os parâmetros da função são os valores reais recebidos na chamada da função. Dentro da função, os parâmetros são usados como variáveis locais.

Notas:Se falta um parâmetro na chamada da função, o valor do parâmetro ausente será definido como undefined.

Detalhes técnicos

Versão do JavaScript： ECMAScript 1

Mais exemplos

Exemplo

Retorna o valor de PI：

function myFunction() {
  return Math.PI;
}

Experimente você mesmo

Exemplo

Retorna o produto de a e b：

function myFunction(a, b) {
  return a * b;
}

Experimente você mesmo

Exemplo

Usando funções, você pode usar o mesmo código várias vezes com diferentes parâmetros para obter diferentes resultados.

Conversão de Fahrenheit para Centígrados：

function toCelsius(fahrenheit) {
  return (5/9) * (fahrenheit-32);
}

Experimente você mesmo

Exemplo

As funções podem ser usadas como variáveis.

em vez de:

temp = toCelsius(32);
text = "A temperatura é " + temp + " Centígrados";
Você pode usar:
text = "A temperatura é " + toCelsius(32) + " Centígrados";

Experimente você mesmo

Exemplo

A função JavaScript tem um objeto interno chamado arguments.

O atributo arguments.length retorna o número de argumentos recebidos ao chamar a função：

function myFunction(a, b) {
  return arguments.length;
}

Experimente você mesmo

Exemplo

Clique no botão para chamar a função, que escreverá "Hello World" no elemento com id="demo":

<button onclick="myFunction()">Clique em mim</button>
<p id="demo"></p>
<script>
function myFunction() {
  document.getElementById("demo").innerHTML = "Hello World";
}
</script>

Experimente você mesmo

Exemplo

As funções do JavaScript também podem ser definidas usando expressões.

As expressões de função podem ser armazenadas em variáveis：

var x = function (a, b) {return a * b};

Experimente você mesmo

Exemplo

Após armazenar a expressão da função em uma variável, essa variável pode ser usada como uma função：

var x = function (a, b) {return a * b};
var z = x(4, 3);

Experimente você mesmo

Suporte do navegador

Sentença Chrome IE Firefox Safari Opera
function Suporte Suporte Suporte Suporte Suporte

Páginas relacionadas

Tutorial de JavaScript：Função do JavaScript

Tutorial de JavaScript：Escopo do JavaScript

Tutorial de JavaScript：Definição de função do JavaScript

Tutorial de JavaScript：Parâmetros da função do JavaScript

Tutorial de JavaScript：Chamada de função do JavaScript

Tutorial de JavaScript：Encerramento de função em JavaScript

Manual de referência do JavaScript：Instrução return do JavaScript