Ошибка "Element implicitly has an 'any' type" при обращении к объекту по ключу string

Причина ошибки

TypeScript — язык со строгой статической типизацией. Когда вы объявляете объект userRoles без явного указания типа, TypeScript выводит его тип как:

{
  admin: string;
  editor: string;
  viewer: string;
}

Это означает, что ключами могут быть только литеральные строки 'admin', 'editor' или 'viewer'. Когда вы пытаетесь обратиться к объекту через переменную типа string, TypeScript не может гарантировать, что эта строка будет одним из допустимых ключей — отсюда и ошибка.

Решение: сужение типа с помощью type guard

Самый безопасный способ — проверить, существует ли ключ в объекте, перед обращением. Используйте пользовательский type guard (защитник типа):

const userRoles = {
  admin: 'полный доступ',
  editor: 'редактирование',
  viewer: 'только просмотр'
} as const;

type RoleKey = keyof typeof userRoles;

function isRoleKey(key: string): key is RoleKey {
  return key in userRoles;
}

function getRole(roleName: string): string | undefined {
  if (isRoleKey(roleName)) {
    return userRoles[roleName];
  }
  return undefined;
}

Здесь as const делает объект readonly и сохраняет точные литеральные типы значений. keyof typeof userRoles даёт тип 'admin' | 'editor' | 'viewer'. Функция isRoleKey проверяет принадлежность ключа к этому объединению и сужает тип внутри блока if.

Альтернативный подход: Record с частичной типизацией

Если вы уверены, что ключи всегда будут валидны (например, после валидации на входе), можно использовать Record:

const userRoles: Record<string, string> = {
  admin: 'полный доступ',
  editor: 'редактирование',
  viewer: 'только просмотр'
};

function getRole(roleName: string): string | undefined {
  return userRoles[roleName]; // теперь ошибки нет
}

Но этот подход ослабляет типизацию — вы теряете информацию о конкретных ключах. Любая строка станет допустимым ключом, и вы не получите автодополнение в IDE.

Продвинутое решение: строгая типизация с кастомным индексным типом

Можно определить интерфейс с индексной сигнатурой, но сохранить конкретные ключи:

interface UserRoles {
  [key: string]: string | undefined;
  admin: string;
  editor: string;
  viewer: string;
}

const userRoles: UserRoles = {
  admin: 'полный доступ',
  editor: 'редактирование',
  viewer: 'только просмотр'
};

function getRole(roleName: string): string | undefined {
  return userRoles[roleName]; // работает
}

Этот способ даёт:

• Строгую типизацию известных ключей (автодополнение для admin, editor, viewer)
• Возможность обращаться по любому строковому ключу (результат — string | undefined)
• Безопасность: если ключа нет, вернётся undefined, а не выбросится исключение

Рекомендация

Для большинства реальных проектов используйте первый вариант с type guard — он сочетает строгость типов и безопасность времени выполнения. Второй вариант (Record) подходит только для очень динамических сценариев, когда ключи действительно могут быть любыми строками.

const userRoles = new Map<string, string>([
  ['admin', 'полный доступ'],
  ['editor', 'редактирование'],
  ['viewer', 'только просмотр']
]);

function getRole(roleName: string): string | undefined {
  return userRoles.get(roleName);
}