Сужение перехваченных ошибок: unknown и Error

Добро пожаловать

Изменение в TS 4.0

// err is now: unknown
try { doSomething(); }
catch (err) {
  // err.message; // Error — cannot access on unknown
}

Сужение типа через instanceof

catch (err) {
  if (err instanceof Error) {
    console.error(err.message, err.stack);
  } else {
    console.error('Unknown error:', String(err));
  }
}

Проверка типа isError

function isError(e: unknown): e is Error {
  return e instanceof Error;
}
catch (e) {
  if (isError(e)) console.error(e.message);
}

Сужение до пользовательского типа ошибки

catch (err) {
  if (err instanceof NetworkError) { /* retry */ }
  else if (err instanceof AuthError) { /* redirect */ }
  else if (err instanceof Error) { /* generic */ }
  else throw err;
}

useUnknownInCatchVariables

{ "compilerOptions": { "useUnknownInCatchVariables": true } }

Строковые ошибки

catch (err) {
  const message = err instanceof Error ? err.message : String(err);
  console.error(message);
}

Вспомогательная функция для типизированного выбрасывания

function throwErr(msg: string, code = 500): never {
  const e: AppError = Object.assign(new Error(msg), { statusCode: code });
  throw e;
}

Повторное выбрасывание неизвестных ошибок

catch (err) {
  if (err instanceof KnownError) handle(err);
  else throw err; // propagate unknowns
}

Границы ошибок в React

componentDidCatch(error: unknown, info: ErrorInfo) {
  if (error instanceof Error) logError(error.message);
}

Тестирование перехваченных ошибок

test('catches errors', async () => {
  jest.spyOn(api, 'fetch').mockRejectedValue(new NetworkError());
  const result = await safeRun();
  expect(result.ok).toBe(false);
});

Быстрая проверка

Итоги