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

CKTIS / JavaScript

?.: acesso e chamadas opcionais

O encadeamento opcional interrompe o acesso quando a base verificada é null ou undefined. Devolve undefined em vez de avaliar o resto dessa cadeia.

Versão: ECMAScript 2020+

Sintaxe

object?.property
object?.[key]
callback?.()

user?.name lê a propriedade apenas quando user não é null nem undefined. user?.[key] permite uma chave calculada e callback?.() uma chamada opcional. Considera também objetos intermédios ausentes, como em user?.address?.city.

O operador não transforma qualquer erro em undefined. Um nome de base não declarado pode continuar a lançar um ReferenceError, e um valor existente mas não invocável em callback?.() lança um TypeError. Uma exceção lançada dentro da função chamada também não é ocultada.

O curto-circuito aplica-se a uma cadeia contínua. Se user for null, (user?.address).city pode lançar um erro porque os parênteses terminaram a cadeia opcional. Não podes atribuir a user?.name: não é um destino válido de atribuição.

Podes combinar acesso opcional com ??, por exemplo user?.name ?? "Guest". Usa esta construção para dados realmente opcionais e valida explicitamente os campos obrigatórios; caso contrário, estruturas de entrada incorretas podem passar despercebidas.

Exemplos

const user = null;
console.log(user?.address?.city ?? "Guest");
let index = 0;
console.log(user?.[index++]);
console.log(index);

Resultado

Guest
undefined
0
const callback = 7;
try {
  callback?.();
} catch (error) {
  console.log(error.name);
}

Resultado

TypeError

Fontes