ExpertiDict

TypeScript · Essencial · Português · Técnico

parâmetro opcional

/paˈɾɐ̃metɾu opsjoˈnaw/substantivo masculino

Parâmetro marcado com ? depois do nome, que pode ser omitido na chamada. Dentro da função, o tipo dele passa a incluir undefined.

Onde usar

Aparece em assinaturas de utilitários, como formatar(valor, moeda?). Importa porque, com strict ligado, usar o parâmetro sem tratar undefined gera erro de compilação.

Em código

function oi(nome: string, titulo?: string) {
  return (titulo ?? 'Sr.') + ' ' + nome;
}
oi('Lima');
oi('Lima', 'Dra.');

Exemplos

Torna o segundo argumento um parâmetro opcional, quase ninguém passa o título.

Como o parâmetro opcional pode ser undefined, trata esse caso antes de usar.

Cuidado

Não confunda com parâmetro com valor padrão: o opcional chega como undefined, enquanto o padrão (n = 10) recebe um valor e dispensa o ponto de interrogação.

Sinônimos

optional parameter

Antônimos

parâmetro obrigatório

Veja também

Todos os termos de TypeScript