ExpertiDict

TypeScript · Essencial · Inglês · Técnico

possibly undefined

/ˈpɑsəbli ʌndɪˈfaɪnd/expressão

Mensagem de erro emitida quando você usa um valor cujo tipo inclui undefined sem tratá-lo antes. É a checagem de strictNullChecks em ação.

Onde usar

É o erro que mais assusta quem migra para strict. A resposta certa é tratar o caso com if, ?? ou ?., e não calar o compilador com ! ou as.

Em código

function tam(s?: string) {
  // s.length; // erro: possibly undefined
  if (s === undefined) return 0;
  return s.length;
}
const n = tam('abc');

Exemplos

I got a possibly undefined error after turning on strict.

Recebi um erro de possibly undefined depois de ligar o strict.

Handle the possibly undefined case with an early return.

Trate o caso possibly undefined com um retorno antecipado.

Cuidado

Não resolva com ! por reflexo: você troca um erro de compilação por um possível TypeError em produção.

Sinônimos

is possibly undefined

Veja também

Todos os termos de TypeScript