Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Sintaxe das funções de seta

As funções de seta usam `=>`. A lista de parâmetros determina se são necessários parênteses, e a forma do corpo determina se um valor é devolvido implicitamente. `this` vem do âmbito envolvente.

Versão: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxe

x => expression
() => expression
(a, b) => expression
({ amount }, factor = 2) => expression
(...args) => expression
(params) => { return expression; }
(params) => ({ key: value })
async x => expression
async (params) => { return await expression; }

Parâmetros e corpo

Uma função de seta é uma expressão de função, não uma declaração de função. O símbolo => separa os parâmetros do corpo e não é um operador. Só se podem omitir os parênteses quando há um único parâmetro escrito como um identificador simples: x => x * 2. São obrigatórios sem parâmetros, com vários parâmetros ou quando se usa um valor predefinido, desestruturação ou um parâmetro rest como ...args.

Um corpo constituído por uma expressão devolve implicitamente o valor dessa expressão. Um { logo após => abre um bloco de instruções: usa return para devolver um valor. Se a execução chegar ao fim do bloco, uma função de seta não assíncrona devolve undefined. Para devolver um literal de objeto sem return, escreve () => ({ total: 99 }). Em () => { total: 99; }, total: é uma etiqueta, não uma chave de objeto.

Contexto de chamada e async

As referências a this, super e new.target, quando permitidas, dependem do contexto léxico envolvente. Uma função de seta não cria uma ligação implícita para arguments. Se não houver uma ligação local com esse nome, as referências a arguments são resolvidas no âmbito envolvente. Fora do modo estrito, uma função de seta pode, contudo, declarar um parâmetro chamado arguments, que cria uma ligação local. call, apply e bind não alteram o seu this. Usa um método normal se a função precisar do objeto sobre o qual foi chamada. Uma função de seta não pode ser geradora; invocá-la com new lança um TypeError.

Não é permitida uma quebra de linha entre os parâmetros e =>, mas pode haver uma depois de =>. Em async (x) => x, também não coloques uma quebra de linha entre async e o início da lista de parâmetros. Uma função de seta async devolve uma Promise e pode usar await no corpo. Verifica se o ambiente de execução JavaScript de destino suporta a sintaxe.

Exemplos

{
  const calculator = {
    offset: 3,
    makeFormatter() {
      return ({ amount }, factor = 2) => ({ total: amount * factor + this.offset });
    },
  };

  const format = calculator.makeFormatter();
  const noResult = () => { total: 99; };

  console.log(format({ amount: 4 }).total);
  console.log(format.call({ offset: 100 }, { amount: 4 }).total);
  console.log(String(noResult()));
}

Resultado

11
11
undefined

As duas primeiras linhas mostram `11`: a desestruturação extrai `amount`, `factor` assume o valor predefinido `2` e `this.offset` mantém-se em `3` apesar de `call`. A última linha mostra `undefined`, porque o bloco de `noResult` não contém `return`.

Lições relacionadas

  • JavaScript · Lição 20 · Avançado · Versão: 4
  • JavaScript · Lição 21 · Avançado · Versão: 4
  • JavaScript · Lição 22 · Avançado · Versão: 4
  • JavaScript · Lição 23 · Avançado · Versão: 4
  • JavaScript · Lição 24 · Avançado · Versão: 4
  • JavaScript · Lição 25 · Avançado · Versão: 4
  • JavaScript · Lição 27 · Avançado · Versão: 4
  • JavaScript · Lição 28 · Avançado · Versão: 4
  • JavaScript · Lição 29 · Avançado · Versão: 4
  • JavaScript · Lição 30 · Avançado · Versão: 4
  • JavaScript · Lição 31 · Avançado · Versão: 4
  • JavaScript · Lição 32 · Avançado · Versão: 4
  • JavaScript · Lição 33 · Avançado · Versão: 4
  • JavaScript · Lição 34 · Avançado · Versão: 4
  • JavaScript · Lição 35 · Avançado · Versão: 4
  • JavaScript · Lição 36 · Avançado · Versão: 4
  • JavaScript · Lição 37 · Avançado · Versão: 4
  • JavaScript · Lição 38 · Avançado · Versão: 4
  • JavaScript · Lição 39 · Avançado · Versão: 4
  • JavaScript · Lição 40 · Avançado · Versão: 4
  • JavaScript · Lição 41 · Avançado · Versão: 4
  • JavaScript · Lição 42 · Avançado · Versão: 4
  • JavaScript · Lição 43 · Avançado · Versão: 4
  • JavaScript · Lição 44 · Avançado · Versão: 4
  • JavaScript · Lição 45 · Avançado · Versão: 4

Fontes