TypeScript: erro "Element implicitly has an 'any' type" — análise e soluções

Introdução: quando o TypeScript diz «não» a uma simples string

Você está programando em TypeScript, tudo vai bem, mas de repente o compilador emite uma mensagem assustadora:

Element implicitly has an 'any' type because expression of type 'string' can't be used to index type '{ ... }'.

Situação familiar? Se você já trabalhou com objetos e chaves dinâmicas em TypeScript, quase certamente já encontrou esse erro. Ele está entre os 5 erros mais frequentes no Stack Overflow sobre TypeScript, e não é à toa.

Neste artigo, vamos analisar por que esse erro ocorre, como corrigi-lo corretamente e — o mais importante — como projetar o código para que ele nunca apareça. O artigo será útil tanto para iniciantes que estão aprendendo TypeScript quanto para desenvolvedores experientes que desejam revisar o assunto.

O que significa esse erro? Explicação simples

TypeScript é uma linguagem de tipagem estrita. Ele garante que você não acesse propriedades de um objeto com um tipo de chave incorreto. Vamos imaginar uma situação simples:

const user = {\n  name: 'Ana',\n  age: 25,\n  city: 'Moscou'\n};\n\nconst key: string = 'name';\nconsole.log(user[key]); // ❌ Erro!

À primeira vista, tudo parece lógico: o objeto user tem a propriedade name, e passamos a string 'name'. Mas o TypeScript vê um problema: o tipo da variável key é string, e não um literal específico 'name' | 'age' | 'city'.

Imagine que você vai a uma biblioteca e diz: «Me dê um livro». O bibliotecário perguntará: «Qual exatamente?» — afinal, existem milhares de livros. O TypeScript funciona da mesma forma: ele não pode garantir que qualquer string corresponda a uma propriedade do objeto.

O erro traduzido literalmente é: «O elemento tem implicitamente o tipo any, porque a expressão do tipo string não pode ser usada para indexar». Em palavras simples: você está tentando acessar um objeto com uma chave cujo tipo é muito genérico.

Top 5 situações em que o erro ocorre

1. Acesso dinâmico a propriedades de objeto

O caso mais comum é quando você obtém uma chave de uma fonte externa (API, entrada do usuário, array de chaves):

const config = {\n  theme: 'dark',\n  language: 'ru',\n  notifications: true\n};\n\nfunction getConfigValue(key: string) {\n  return config[key]; // ❌ Erro!\n}

2. Trabalhando com enum ou constantes

const COLORS = {\n  red: '#FF0000',\n  green: '#00FF00',\n  blue: '#0000FF'\n};\n\nfunction getColorCode(colorName: string) {\n  return COLORS[colorName]; // ❌ Erro!\n}

3. Iteração sobre chaves de objeto com Object.keys()

const scores = {\n  math: 95,\n  physics: 88,\n  chemistry: 92\n};\n\nObject.keys(scores).forEach(key => {\n  console.log(scores[key]); // ❌ Erro!\n});

Esta é uma «armadilha» clássica: Object.keys() retorna string[], e não (keyof typeof scores)[].

4. Uso de Map ou Record com genéricos

const cache: Record<string, any> = {};\nconst key: string = 'user_123';\ncache[key] = { name: 'Ivan' }; // ✅ Funciona\n\n// Mas se tiparmos com mais precisão:\ninterface UserCache {\n  [id: string]: { name: string };\n}\nconst users: UserCache = {};\nconst userId: string = 'user_456';\nconsole.log(users[userId]); // ❌ Erro!

5. Funções que recebem chaves como parâmetros

interface Product {\n  id: number;\n  title: string;\n  price: number;\n}\n\nfunction updateProductField(product: Product, field: string, value: any) {\n  product[field] = value; // ❌ Erro!\n}

5 formas de corrigir o erro (da simples à correta)

Forma 1: Type assertion (as any) — rápido, mas perigoso

A maneira mais simples e mais «suja»