모듈module은 일반적으로 기능을 기준으로 파일 단위로 분리된 애플리케이션 구성 요소로서 재사용 가능한 코드 조각을 말한다.
- 모듈이 성립하려면 자신만의 파일스코프(모듈스코프) 를 가질 수 있어야한다. 이를 통해 모듈은 캡슐화되어 다른 모듈에서 접근할 수 없고, 애플리케이션과 완전히 분리되어 존재한다.
- 하지만 그와 동시에 다른 모듈에 의해 재사용되어야 의미가 있으므로,
import와export를 제공한다.
모듈에서 공개가 필요한 자산에 한정하여 명시적으로 선택적 공개하는 것을 말한다.
모듈 사용자module consumer가 모듈이 공개export한 자산 중 일부 또는 전체를 선택해 자신의 스코프 내로 불러들여 재사용하는 것을 말한다.
자바스크립트는 웹페이지의 단순한 보조 기능 처리라는 제한적인 용도를 목적으로 태어나 언어로서 부족한 기능이 존재한다. 대표적으로 모듈 시스템을 지원하지 않았다.
<script/>태그를 사용하여 외부 자바스크립트 파일을 로드할 수는 있지만, 독립적인 파일스코프를 갖지 않는다.- 결과적으로 하나의 파일에 작성된 것 처럼 동작한다.
- 분리된 파일들의 전역 변수가 중복되는 등의 문제가 발생할 수 있다.
자바스크립트를 브라우저 환경 외에서도 사용하려는 노력과 함께, 모듈 시스템 CommonJS와 AMD(Asynchronous Module Definition)이 제안되었다.
- ECMAScript 표준 사양은 아니지만,
Node.js는 모듈 시스템을 지원했다. - 자바스크립트 런타임 환경
Node.js는 완전히는 아니지만 기본적으로CommonJS사양을 따르고 있다.
이후 ES6에서 클라이언트 사이드 자바스크립트에서도 동작하는 모듈 기능이 추가되었다.
script태그에type="module"어트리뷰트를 추가한다.- ESM파일임을 명확히 하기 위해 파일 확장자를 .mjs로 하기를 권장한다.
- ESM은 기본적으로
strict mode가 적용된다.<script type="module" src="app.mjs"></script>
-
ESM이 아닌 일반적인 자바스크립트 파일은 분리해서 로드해도 독자적인 모듈 스코프를 갖지 않는다.
일반 자바스크립트 파일 예제 코드
// foo.js // x 변수는 전역 변수다. var x = 'foo'; console.log(window.x); // foo
// bar.js // x 변수는 전역 변수다. foo.js에서 선언한 전역 변수 x와 중복된 선언이다. var x = 'bar'; // foo.js에서 선언한 전역 변수 x의 값이 재할당되었다. console.log(window.x); // bar
<!DOCTYPE html> <html> <body> <script src="foo.js"></script> <script src="bar.js"></script> </body> </html>
-
ESM은 파일 자체의 독자적인 모듈 스코프를 제공하여, 모듈 내에서 선언한 변수는 전역 변수도
window객체의 프로퍼티도 아니다.ESM 파일 예제 코드
// foo.mjs // x 변수는 전역 변수가 아니며 window 객체의 프로퍼티도 아니다. var x = 'foo'; console.log(x); // foo console.log(window.x); // undefined
// bar.mjs // x 변수는 전역 변수가 아니며 window 객체의 프로퍼티도 아니다. // foo.mjs에서 선언한 x 변수와 스코프가 다른 변수다. var x = 'bar'; console.log(x); // bar console.log(window.x); // undefined
<!DOCTYPE html> <html> <body> <script type="module" src="foo.mjs"></script> <script type="module" src="bar.mjs"></script> </body> </html>
-
모듈 스코프가 다르기 때문에 모듈 내에서 선언한 식별자는 모듈 외부에서 참조할 수 없다.
모듈간 참조 예제 코드
// foo.mjs const x = 'foo'; console.log(x); // foo
// bar.mjs console.log(x); // ReferenceError: x is not defined
<!DOCTYPE html> <html> <body> <script type="module" src="foo.mjs"></script> <script type="module" src="bar.mjs"></script> </body> </html>
export 키워드는 모듈 내부에서 선언한 식별자를 외부에 공개하여 다른 모듈에서 재사용할 수 있게 한다.
- export 키워드는 선언문 앞에 사용한다.
export const pi = Math.PI; // 변수의 공개 export function square(x) {} // 함수의 공개 export class Person {} // 클래스의 공개
- export 대상을 객체로 구성하여 한 번에 export 할 수 있다.
// lib.mjs export const pi = Math.PI; export function square(x) {} export class Person {} // 변수, 함수 클래스를 하나의 객체로 구성하여 공개 export { pi, square, Person };
import 키워드는 다른 모듈에서 공개export한 식별자를 자신의 모듈 스코프 내부로 로드한다.
- 다른 모듈이 export 한 식별자 이름으로 import 해야하며 ESM의 경우 파일 확장자를 생략할 수 없다.
// app.mjs import { pi, square, Person } from './lib.mjs';
<!DOCTYPE html> <html> <body> <script type="module" src="app.mjs"></script> </body> </html>
- 애플리케이션 진입점인
app.mjs는 반드시 script 태그로 로드해야하지만,lib.mjs는 import 문에 의해 로드되는 의존성dependency로 script 태그로 로드하지 않아도 된다. - 하나의 이름으로 한 번에 import 할 수 있다.
// lib.mjs 모듈이 export한 모든 식별자를 lib 객체의 프로퍼티로 모아 import한다. import * as lib from './lib.mjs'; console.log(lib.pi); // 3.141592653589793 console.log(lib.square(10)); // 100 console.log(new lib.Person('Lee')); // Person { name: 'Lee' }
- 다른 모듈에서 export 한 식별자 이름을 변경하여 import 할 수 있다.
// app.mjs // lib.mjs 모듈이 export한 식별자 이름을 변경하여 import한다. import { pi as PI, square as sq, Person as P } from './lib.mjs'; console.log(PI); // 3.141592653589793 console.log(sq(2)); // 4 console.log(new P('Kim')); // Person { name: 'Kim' }
모듈에서 하나의 값만 export 한다면 default 키워드를 사용할 수 있다. 이 경우 이름 없이 하나의 값을 export 한다.
export다음에 사용한다.export default (x) => x * x;
defualt키워드를 사용하는 경우var,let,const키워드는 사용할 수 없다.// lib.mjs export default const foo = () => {}; // => SyntaxError: Unexpected token 'const'
default키워드로 export 한 모듈은{}없이 임의의 이름으로 import 한다.import square from './lib.mjs'; console.log(square(3)); // 9