0Pricing
TypeScript Academy · Урок

Типизация ошибок (unknown), сужение типов в catch

Типизируйте параметры catch как unknown, затем сужайте их с помощью instanceof/typeof или пользовательских защит для безопасной обработки ошибок.

«Типизация ошибок (unknown), сужение типов в catch» — бесплатный урок TypeScript Academy на CoddyKit. Это урок 2 из 3. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения TypeScript Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс TypeScript Academy содержит 3 уроков всего.

Введение

Цель: перехватывать ошибки как unknown и безопасно уточнять их тип. Вы будете использовать instanceof, typeof и пользовательские защитники типов, чтобы без неожиданностей читать данные ошибки.

unknown и instanceof

Начинайте с типа unknown. Уточняйте его с помощью instanceof Error, чтобы получить доступ к message, stack и другим полям.

async function boom(): Promise<void> { throw new Error("boom") }

async function run() {
  try {
    await boom();
  } catch (e: unknown) {
    if (e instanceof Error) {
      console.error("Handled:", e.message);
    } else {
      console.error("Non-Error thrown:", e);
    }
  }
}

run();

typeof для примитивов

Некоторый код выбрасывает строки или другие примитивы. Используйте typeof, чтобы уточнить тип и корректно обработать значение.

function throwString() { throw "bad" }

try {
  throwString();
} catch (e: unknown) {
  if (typeof e === "string") {
    console.warn("string error:", e.toUpperCase());
  } else {
    console.warn("other error", e);
  }
}

Пользовательский защитник

Создайте пользовательский защитник типов, чтобы распознавать структуры, похожие на ошибки, из разных уровней приложения.

type ErrorLike = { message: string; code?: string };

function isErrorLike(e: unknown): e is ErrorLike {
  return !!e && typeof e === "object" && "message" in e;
}

try {
  throw { message: "oops", code: "E_BAD" };
} catch (e: unknown) {
  if (isErrorLike(e)) {
    console.error(e.message, e.code ?? "no-code");
  } else {
    console.error("unknown error", e);
  }
}

Безопасное журналирование

Централизуйте обработку ошибок. Небольшая вспомогательная функция безопасно уточняет тип и записывает ошибку в журнал, не допуская сбоев самого журналирования.

function logErrorSafe(e: unknown): void {
  if (e instanceof Error) {
    console.error("Error:", e.message);
  } else if (typeof e === "string") {
    console.error("Error(string):", e);
  } else {
    try {
      console.error("Error(obj):", JSON.stringify(e));
    } catch {
      console.error("Error(unknown)");
    }
  }
}

try { throw { oops: true } } catch (e: unknown) { logErrorSafe(e) }

Советы

Советы:

  • В блоке catch отдавайте предпочтение типу unknown.
  • Уточняйте тип с помощью instanceof, typeof или защитников типов.
  • Не предполагайте, что это всегда Error: сторонний код может выбросить что угодно.

Проверка типизации ошибок

Быстрая проверка: почему в блоке catch следует отдавать предпочтение типу unknown?

Итоги

Итоги: перехватывайте ошибки как unknown, уточняйте тип с помощью instanceof/typeof или пользовательских защитников и централизуйте безопасное журналирование.

Часто задаваемые вопросы

Урок «Типизация ошибок (unknown), сужение типов в catch» бесплатный?

Да — полный текст урока «Типизация ошибок (unknown), сужение типов в catch» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс TypeScript Academy, подпишись на CoddyKit PRO. Курс TypeScript Academy содержит 3 уроков всего.

Чему я научусь в уроке «Типизация ошибок (unknown), сужение типов в catch»?

Типизируйте параметры catch как unknown, затем сужайте их с помощью instanceof/typeof или пользовательских защит для безопасной обработки ошибок. Ты практикуешь TypeScript Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.

Нужен ли мне опыт, чтобы начать TypeScript Academy?

Предыдущий опыт не требуется. TypeScript Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 2 из 3.

Сколько времени занимает урок «Типизация ошибок (unknown), сужение типов в catch»?

Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.

Можно ли писать и запускать код в этом уроке TypeScript Academy?

Да. Каждый урок TypeScript Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.

Все уроки этого курса

  1. Promise , типизация async/await
  2. Типизация ошибок (unknown), сужение типов в catch
  3. Шаблоны конкурентного выполнения (all/settled/race): типы
← Назад к TypeScript Academy