Как правильно парсить JSON строку в TypeScript с типизацией

Правильный парсинг JSON с типизацией в TypeScript

Вы столкнулись с классической проблемой — JSON.parse() всегда возвращает тип any, потому что TypeScript не может статически проанализировать содержимое строки. Вот несколько правильных подходов к решению.

1. Использование дженериков с JSON.parse (базовый подход)

Самый простой способ — использовать обобщённый тип (generic) с JSON.parse. Хотя стандартный JSON.parse не принимает дженерики, вы можете создать функцию-обёртку:

function parseJSON<T>(jsonString: string): T {
  return JSON.parse(jsonString) as T;
}

interface User {
  name: string;
  age: number;
  isActive: boolean;
}

const jsonString = '{"name": "John", "age": 30, "isActive": true}';
const user = parseJSON<User>(jsonString);
console.log(user.name); // TypeScript знает, что это string

2. Проверка типов во время выполнения (рекомендуемый подход)

Простое приведение через as не гарантирует, что данные действительно соответствуют интерфейсу. Лучше добавить валидацию:

function isUser(obj: any): obj is User {
  return (
    typeof obj === 'object' &&
    obj !== null &&
    typeof obj.name === 'string' &&
    typeof obj.age === 'number' &&
    typeof obj.isActive === 'boolean'
  );
}

function parseAndValidateUser(jsonString: string): User {
  const parsed = JSON.parse(jsonString);
  if (isUser(parsed)) {
    return parsed;
  }
  throw new Error('Invalid user data format');
}

const user = parseAndValidateUser(jsonString);
// Теперь user точно соответствует интерфейсу User

3. Использование библиотек для валидации

Для сложных объектов рекомендую использовать специализированные библиотеки:

• Zod — современная библиотека для декларативной валидации
• Yup — популярная библиотека для схем валидации
• io-ts — функциональный подход с выведением типов

Пример с Zod:

import { z } from 'zod';

const UserSchema = z.object({
  name: z.string(),
  age: z.number(),
  isActive: z.boolean(),
});

type User = z.infer<typeof UserSchema>;

function parseUser(jsonString: string): User {
  const parsed = JSON.parse(jsonString);
  return UserSchema.parse(parsed); // Автоматически проверяет и типизирует
}

4. Обработка ошибок

Всегда оборачивайте парсинг в try-catch:

try {
  const user = parseJSON<User>(jsonString);
  // Работаем с user
} catch (error) {
  if (error instanceof SyntaxError) {
    console.error('Некорректный JSON:', error.message);
  } else {
    console.error('Ошибка валидации:', error);
  }
}

Важные моменты

• TypeScript не может проверить данные во время выполнения — это особенность языка
• Всегда проверяйте данные из внешних источников (API, файлы, пользовательский ввод)
• Используйте unknown вместо any для большей безопасности
• Для production-кода обязательно добавляйте валидацию

Помните: правильная типизация JSON в TypeScript — это комбинация статической типизации на этапе компиляции и проверки данных во время выполнения. Только так можно обеспечить надёжность вашего приложения.

class User {
  constructor(
    public name: string,
    public age: number,
    public isActive: boolean
  ) {}

  static fromJSON(json: string): User {
    const data = JSON.parse(json);
    return new User(data.name, data.age, data.isActive);
  }

  greet(): string {
    return `Привет, я ${this.name}`;
  }
}

const user = User.fromJSON('{"name": "John", "age": 30, "isActive": true}');
console.log(user.greet()); // Работает с методами класса