2024년 3월 4일 작성

TypeScript Void Type - 함수가 값을 반환하지 않을 때

TypeScript의 Void Type은 함수가 명시적으로 값을 반환하지 않을 때 사용하는 type으로, 함수의 목적이 반환 값이 아닌 어떤 동작을 수행하는 것임을 나타냅니다.

void Type : 함수가 명시적으로 값을 반환하지 않을 때

  • void type은 함수가 명시적으로 값을 반환하지 않을 때 사용하는 type입니다.
    • 함수가 실행된 후에 어떠한 값도 반환하지 않음을 명시적으로 표시하는 방법입니다.
    • 이는 함수의 목적이 반환 값이 아닌 어떤 동작을 수행하는 것임을 나타냅니다.
  • 함수 type signature의 void 반환 type을 보고 함수의 목적을 더 쉽게 이해할 수 있으며, 실수로 반환 값을 기대하는 code를 작성하는 것을 방지할 수 있습니다.
    • void type은 함수의 의도(동작을 수행하되, 호출자에게 값을 반환하지 않을 것임)를 명확히 표현합니다.

기본적인 void 사용

  • 함수가 값을 반환하지 않고 종료될 때, 반환 type으로 void를 지정합니다.
    • 이는 함수가 단순히 작업을 수행하고 명시적인 반환 값 없이 종료됨을 나타냅니다.

  • 가장 흔한 void 사용 사례입니다.

  • 이런 함수는 작업을 실행하긴 하지만, 호출자에게 반환 값을 돌려주지 않습니다.
    • 주로 logging, message 출력, event triggering 등의 부수 효과(side effects)를 위해 수행합니다.
function printMessage(message: string): void {
    console.log(message);
}

function greet(name: string): void {
    console.log(`Hello, ${name}!`);
}

const logError = (error: Error): void => {
    console.error(error.message);
};

void Callback 함수를 매개 변수로 사용하는 경우

  • 함수가 callback 함수를 매개 변수로 받을 때, 해당 callback의 반환 type으로 void를 사용할 수 있습니다.
  • 이는 callback이 어떤 작업을 수행하기는 하지만, 그 결과를 호출자에게 반환하지 않고, 단지 동작을 수행하기만 한다는 것을 명시합니다.
function processUserInput(callback: (input: string) => void) {
    const input = "Some input";
    callback(input);
}
  • 이 함수는 사용자 입력을 처리하고, callback 함수에 그 입력을 전달합니다.
  • callback 함수는 입력을 사용해 작업을 수행하지만, 값은 반환하지 않습니다.

Interface나 Type Alias에서의 void 사용

  • void type은 interface나 type alias 내의 함수 signature에서도 사용될 수 있습니다.
interface ILogger {
    log: (message: string) => void;
    error: (error: Error) => void;
}

type Callback = (success: boolean) => void;
  • ILogger interface는 log와 error를 출력하는 두 method를 정의하며, 모두 반환 값 없이 동작합니다.
  • Callback type은 boolean 매개 변수를 받고, 반환 값 없이 동작하는 함수의 type을 나타냅니다.

Promise와 void type

  • Promise<void>는 비동기 작업이 성공적으로 완료되었지만, 특정 값을 반환하지 않음을 나타낼 때 유용합니다.
    • 예를 들어, database에 data를 저장하는 비동기 함수는 작업이 완료된 후 반환 값 없이 성공적으로 완료되었다는 사실만 알립니다.
async function saveToDatabase(data: any): Promise<void> {
    // database에 data를 저장하는 logic
}

void와 undefined, null의 관계

  • void type은 다른 type과는 달리, 변수에 할당할 수 있는 값이 매우 제한적입니다.
  • TypeScript에서 void type의 변수에 할당할 수 있는 유일한 값은 undefined와 null입니다.
    • null은 strictNullChecks option이 비활성화된 경우에만 할당할 수 있습니다.
  • 하지만, 일반적으로 void type을 변수에 사용하는 것보다는 함수의 반환 type으로 사용하는 경우가 훨씬 더 많습니다.
function logMessage(message: string): void {
    console.log(message);
}

let unusable: void = undefined;
  • void를 반환 type으로 사용하는 함수가 undefined를 명시적으로 반환하는 것도 일반적이지 않습니다.
  • void type을 가진 함수에서 return문을 사용할 수는 있지만, 어떤 값도 반환하지 않아야 합니다.
function doNothing(): void {
    return;    // OK
    return undefined;    // OK, but not recommended
    return null;    // Error if strictNullChecks is enabled
}

void와 undefined

  • void type 함수는 기술적으로 undefined를 반환할 수 있습니다.
    • TypeScript에서 함수가 반환 값을 명시하지 않으면 자동으로 undefined를 반환합니다.
  • 그러나 void를 반환 type으로 명시한 함수에서 return undefined;를 사용하는 것은 권장되지 않습니다.
    • undefined 값을 반환하는 것은 void의 의도와 상충될 수 있으며, 함수의 반환 값에 대한 의도를 혼란스럽게 만들 수 있습니다.
  • void 함수에서는 가능한 return;만 사용하거나, return문을 전혀 사용하지 않는 것이 좋습니다.

void와 null

  • void type은 undefined와 null을 엄격하게 구분합니다.
    • 두 type에 대한 void의 동작이 다릅니다.
  • strictNullChecks option이 활성화된 TypeScript 환경에서는 void type 함수에서 null을 반환하려고 시도하면 type error가 발생합니다.
    • 반대로 strictNullChecks option이 비활성화된 경우에는 null 반환이 가능합니다.
  • strictNullChecks가 활성화되면, null은 void type에 할당할 수 없으며, 이는 type 안전성을 강화하는 데 도움을 줍니다.

목차