Quem é você, objeto? Descobrindo o nome da classe em TypeScript (runtime)

Por que você pode precisar do nome da classe em tempo de execução?

Imagine: você está escrevendo um sistema complexo em TypeScript. Você tem uma hierarquia de classes — User, Admin, Moderator. Em algum lugar no fundo do código, você recebe um objeto, mas não sabe quem ele é de verdade. Você vê apenas object no console.

Ou você está construindo um logger que deve exibir não apenas [Object], mas um nome de classe significativo: [User: John]. Ou você está escrevendo um decorator que deve decidir como processar o objeto, dependendo do seu tipo.

É aí que entra a pergunta com milhares de visualizações no Stack Overflow: "Get an object's class name at runtime". Hoje não vamos apenas dar a resposta, mas vamos olhar por baixo do capô do TypeScript e JavaScript para entender como isso realmente funciona.

Sim, TypeScript é uma extensão do JavaScript. Toda a mágica dos tipos desaparece após a compilação. Mas o nome da classe não é um tipo, é uma propriedade do protótipo. E ele permanece conosco em tempo de execução.

A maneira mais simples: constructor.name

Se você já pesquisou essa pergunta, provavelmente já viu esta linha única:

class User {\n  constructor(public name: string) {}\n}\n\nconst user = new User("Alice");\nconsole.log(user.constructor.name); // "User"

Funciona? Sim. Rápido? Sim. Mas há nuances que podem te pegar se você não souber como isso funciona.

Como funciona por baixo dos panos?

Cada objeto em JavaScript tem a propriedade constructor. Esta é uma referência à função que criou o objeto. E qualquer função (uma classe também é uma função) tem a propriedade name.

Quando você escreve user.constructor.name, o motor faz o seguinte:

\n
• Percorre a cadeia de protótipos do objeto user.
\n
• Encontra a propriedade constructor em User.prototype.
\n
• Lê o name da função construtora User.
\n

É uma operação barata, mas não é gratuita. Na maioria dos casos, você nem vai notar.

Quando constructor.name não funciona?

Aqui está a pegadinha clássica:

const obj = Object.create(null);\nconsole.log(obj.constructor); // undefined\n// console.log(obj.constructor.name); // TypeError!

Um objeto criado com Object.create(null) não tem protótipo. Ele não tem constructor. Cuidado.

O segundo caso é a minificação. Se você usa um bundler (Webpack, Terser) que renomeia as classes, constructor.name pode retornar algo como t ou e. Isso é um problema apenas para produção, mas é bom saber.

Alternativa: instanceof e verificações personalizadas

Às vezes você não precisa apenas do nome, mas de uma verificação: "Este objeto é uma instância da classe X?"

class Animal {}\nclass Dog extends Animal {}\n\nconst dog = new Dog();\n\nconsole.log(dog instanceof Dog);    // true\nconsole.log(dog instanceof Animal); // true\nconsole.log(dog instanceof Object); // true

instanceof funciona através da cadeia de protótipos. Ele verifica se Dog.prototype está na cadeia de protótipos do objeto dog. Se sim — true.

Mas instanceof não te dá uma string com o nome. Ele te dá um valor booleano. Para logs ou serialização, isso não serve.

Combinando: verificação + nome

Você pode escrever uma utilidade que primeiro verifica o tipo e depois retorna o nome:

function getClassName(obj: any): string | null {\n  if (obj === null || obj === undefined) return null;\n  if (typeof obj !== 'object' && typeof obj !== 'function') return null;\n\n  // Proteção contra Object.create(null)\n  if (!obj.constructor) return 'Object (no prototype)';\n\n  const name