모듈 시스템은 코드를 모듈화하여 재사용성과 관리성을 높여주는 중요한 기능입니다. Node.js는 CommonJS 모듈 시스템을 기본으로 사용하며, ES6의 import/export 구문도 지원합니다.

1. CommonJS 모듈

Node.js는 CommonJS 사양을 기반으로 모듈을 정의하고 불러옵니다. 이는 대부분의 Node.js 프로젝트에서 사용되는 방식입니다.

CommonJS 특징

• 동기 방식: require()는 동기적으로 모듈을 불러옵니다. 즉, 호출 시 해당 모듈이 로드될 때까지 기다린 후, 반환된 값을 사용할 수 있습니다.
• 모듈 캐싱: require()로 불러온 모듈은 한 번만 로드되며, 이후 동일한 모듈을 다시 호출할 때는 캐싱된 값을 사용합니다.
• 파일 확장자 생략 가능: .js 파일은 확장자를 생략할 수 있습니다. (require('./math')는 math.js를 자동으로 찾습니다.)

모듈 정의 (module.exports)

CommonJS 모듈 시스템에서는 exports와 module.exports를 사용하여 모듈에서 데이터를 내보낼 수 있습니다.

• exports는 module.exports에 대한 별칭입니다. 기본적으로 exports는 module.exports와 같은 객체를 참조합니다. exports와 module.exports는 같은 객체를 참조하므로 exports에 값을 직접 할당하면 안 됩니다. module.exports만 덮어쓸 수 있습니다.
• module.exports는 파일 내에서 한 번만 사용할 수 있으며, 그 값은 객체, 함수, 클래스 등 하나의 값만 내보낼 수 있습니다. 이는 모듈의 최종 반환 값을 설정하는 것이기 때문에, 한 파일에서 여러 번 module.exports를 사용하면 마지막에 할당된 값만이 적용됩니다.

// math.js

exports.add = function add(a, b) {
    return a + b;
}

exports.sub = function sub(a, b) {
    return a - b;
}

// math.js

function add(a, b) {
    return a + b;
}

function sub(a, b) {
    return a - b;
}

module.exports = { 
	add, 
	sub 
};

모듈 가져오기 (require)

require 함수를 사용하여 다른 파일에서 모듈을 불러옵니다.

// app.js

const math = require('./math');
console.log(math.add(2, 3));  // 5
console.log(math.sub(3, 2));  // 1