0Pricing
TypeScript Academy · Lekcja

Typowanie błędów (unknown) i zawężanie w catch

Typowanie parametrów catch jako unknown, a następnie ich zawężanie za pomocą instanceof/typeof lub własnych strażników na potrzeby bezpiecznej obsługi błędów

Typowanie błędów (unknown) i zawężanie w catch to bezpłatna lekcja TypeScript Academy na CoddyKit. To lekcja 2 z 3. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej TypeScript Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs TypeScript Academy zawiera 3 lekcji w sumie.

Wprowadzenie

Cel: Przechwytywać błędy jako unknown i bezpiecznie zawężać ich typ. Używać instanceof, typeof oraz niestandardowych strażników typów, aby odczytywać dane błędów bez niespodzianek.

unknown + instanceof

Zacznij od unknown. Zawężaj typ za pomocą instanceof Error, aby uzyskać dostęp do message, stack itd.

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 dla typów prymitywnych

Niektóry kod zgłasza ciągi znaków lub inne wartości prymitywne. Użyj typeof, aby zawęzić typ i obsłużyć je w kontrolowany sposób.

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);
  }
}

Własny strażnik typu

Utwórz strażnik typu zdefiniowany przez użytkownika, aby rozpoznawać kształty „podobne do błędów” pochodzące z różnych warstw.

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);
  }
}

Bezpieczne logowanie

Scentralizuj obsługę błędów. Niewielki pomocniczy mechanizm bezpiecznie zawęża typ i zapisuje błąd w logach, unikając awarii podczas samego logowania.

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) }

Wskazówki

Wskazówki:

  • Preferuj unknown w bloku catch.
  • Zawężaj typ za pomocą instanceof, typeof lub strażników.
  • Nie zakładaj, że zawsze otrzymasz Error — kod zewnętrzny może zgłosić dowolną wartość.

Sprawdzenie typowania błędów

Szybkie sprawdzenie: Dlaczego w bloku catch należy preferować unknown?

Podsumowanie

Podsumowanie: Przechwytuj błędy jako unknown, zawężaj typ za pomocą instanceof/typeof lub własnych strażników i centralizuj bezpieczne logowanie.

Często zadawane pytania

Czy lekcja „Typowanie błędów (unknown) i zawężanie w catch” jest bezpłatna?

Tak — pełny tekst „Typowanie błędów (unknown) i zawężanie w catch” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu TypeScript Academy, przejdź na CoddyKit PRO. Kurs TypeScript Academy zawiera 3 lekcji w sumie.

Co nauczysz się w „Typowanie błędów (unknown) i zawężanie w catch”?

Typowanie parametrów catch jako unknown, a następnie ich zawężanie za pomocą instanceof/typeof lub własnych strażników na potrzeby bezpiecznej obsługi błędów Ćwiczysz TypeScript Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć TypeScript Academy?

Nie wymagamy żadnego doświadczenia. TypeScript Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 2 z 3.

Ile czasu zajmuje lekcja „Typowanie błędów (unknown) i zawężanie w catch”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji TypeScript Academy?

Tak. Każda lekcja TypeScript Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

  1. Promise i typowanie async/await
  2. Typowanie błędów (unknown) i zawężanie w catch
  3. Typy wzorców współbieżności (all/settled/race)
← Powrót do TypeScript Academy