🐶 좋은코드 나쁜코드 4장 오류

🪂 복구 가능한 오류

• 사용자가 잘못된 양식으로 입력하는 경우, 사용자에게 안내를 통해 복구 가능
  • 전화번호 양식을 지키지 않는 경우
• 네트워크 에러나는 경우 사용자에게 잠시 후 이용가능하도록 안내 가능

🎿 복구할 수 없는 오류

• 엔지니어의 실수로 인한 것
• 코드와 함께 추가되어야 하는 리소스
  • 프로젝트 환경 변수 , 기본 설정값들
    • DB정보 등등
• 어떤 코드가 다른코드를 잘못 호출하는 경우
  • 인수를 잘못 호출한다던지

🗽 신속하게 실패하기/요란하게 실패하기

개념 의미

신속하게 실패	가능한 문제가 발생한 시점부터 오류를 나타내는 것
요란하게 실패	실패를 숨기지 않고 알리는것

신속하게 실패하기 예시

• 잘못된 인자를 넣거나 할 경우

// 문제가 생긴쪽에서 부터 오류를 나타낸다
function prepareUrl(url) {
  if (!url) throw new Error("URL이 존재하지 않습니다");

  console.log("setting url");
}

function playMusic() {
  prepareUrl();
}

playMusic();

요란하게 실패하기 예시

// throw를 통해 함수를 호출하는곳에서 인지하도록 한다
function prepareUrl(url) {
  if (!url) throw new Error("URL이 존재하지 않습니다");

  console.log("setting url");
}

function playMusic() {
  prepareUrl();
}

playMusic();

🛼 오류 전달 방법

명시적 방법

코드에 오류가 있음을 인지할 수 밖에 하는것

• 검사예외: JS에서는 강제로 검사예외 처리하는것이 존재하지 않는다.
• 널값을 이용한 오류 전달: 널값을 반환하는 방식이며, 오류가 발생한 이유 대한 정보를 제공하지 않는다

/**
 * @param {Object} value - 넓이를 계산할 객체
 * @param {number} value.width - 직사각형의 너비
 * @param {number} value.height - 직사각형의 높이
 * @returns {undefined|number}
 */
function getArea(value) {
  // 오류가 발생하면 값이 없는건지 설명이 없다.
  // 주석에 다는 방식도 있겠지만, 정확하지 않을 가능성이 높다
  if (!value) return;

  return value.width * value.height;
}

// 널값에 대한 오류 처리
function displayArea() {
  const result = getArea({
    width: 2,
    height: 3,
  });

  if (!result) {
    console.error("displayArea error result is undefined");
  } else {
    console.log("success displayArea : " + result);
  }
}
displayArea();

• 리절트 반환 유형: 널값반환은 어떤 오류인지 감지가 불가능하다는 단점이 있다. 그리하여 Result유형을 사용하면 오류에 대한 정보도 같이 전달이 가능하다. 다만 에러가 존재하는지(hasError) 확인하고, 없으면 getValue를 통해 확인해야한다. 이것을 인지못하면 , 순서에 오류가 존재한다

class Result {
  #value;
  #error;

  constructor(value, error) {
    this.#value = value;
    this.#error = error;
  }

  static ofValue(value) {
    return new Result(value, null);
  }

  static ofError(error) {
    return new Result(null, error);
  }

  hasError() {
    return this.#error;
  }

  getValue() {
    return this.#value;
  }

  getError() {
    return this.#error;
  }
}

function getName(name) {
  if (!name) {
    return Result.ofError(new Error("name is empty"));
  }

  return Result.ofValue(name);
}

function displayName() {
  const result = getName("홍길동");

  if (result.hasError()) {
    console.error(result.getError());
  } else {
    console.log("my name is " + result.getValue());
  }
}

displayName();

• 아웃컴 반환 유형: Result는 작업에 대한 수행결과라고 한다면, 아웃컴은 수행에 대한 성공여부에 대한것을 알리는것에 가깝다

class Mission {
  #missionId;

  constructor(missionId) {
    this.#missionId = missionId;
  }

  isOpen() {
    if (this.#missionId === "FOOTBALL") return false;
    else return true;
  }

  participate() {
    // 미션 수행로직..
  }
}

/**
 * @param {Mission} mission
 * @returns {Boolean} // 불린에 따라 성공여부를 리턴한다
 */
function participateMission(mission) {
  if (mission.isOpen()) {
    mission.participate();
    return true; // 미션 참여가능하면 True
  }

  return false; // 미션 참여 불가능하면 False
}

const result = participateMission(new Mission("BASEBALL"));
console.log(result);

암시적 방법

💡코드를 호출하는 쪽에서 알리지만, 그 오류를 신경쓰지 않아도 된다

• 비검사 예외: 코드를 호출하는 쪽에서 인지 못할 가능성이 높다

class NegativeNumberException extends Error { // 비검사 예외 유형임을 나타내는 클래스
  #erroneousNumber;

  constructor(erroneousNumber) {
    super(`음수는 허용되지 않습니다: ${erroneousNumber}`);
    this.name = "NegativeNumberException";
    this.#erroneousNumber = erroneousNumber;
  }

  getErroneousNumber() {
    return this.#erroneousNumber;
  }
}

function getSquareRoot(value) {
  if (value < 0) {
    // 오류에 대해 비검사 예외 발생
    throw new NegativeNumberException(value);
  }

  return Math.sqrt(value);
}

function displaySquareRoot() {
  value = -1;

  try {
    getSquareRoot(value);
  } catch (error) {
    // 비검사 예외 처리
    console.error("[displaySquareRoot error] ", error);
  }
}

displaySquareRoot();

• 프로미스 또는 Future : Promise형태로 오류를 반환할 수 있다. 다만 호출하는쪽에서는 Promise 실패에 대한 세부적인 내용을 알아야 한다

/**
 *
 * @param {String} message
 * @returns {Promise<String>}
 */
function sendMessage(message) {
  return new Promise((resolve, reject) => {
    if (!message || !message.trim()) {
      reject(new Error("전달할 메세지가 없습니다"));
    }

    resolve("메세지 전송에 성공하였습니다");
  });
}

sendMessage()
  .then(() => {
    console.log("success send message");
  })
  .catch((err) => {
    console.error(`[sendMessage error] : ${err}`);
  });

• 매직값 반환: 값의 의미를 알기 위해서는 문서를 읽어야 하므로, 암시적 전달 기법이다.

function getSquareRoot(value) {
  if (value < 0) {
    return -1; // 매직값 반환 다만, 어떤 오류인지는 확인하기 어렵다
  }

  return Math.sqrt(value);
}