Post

[모던 자바스크립트 Deep Dive]48장 모듈

48.1 모듈의 일반적 의미

  • 모듈
    • 애플리케이션을 구성하는 개별적 요소
    • 재사용할 수 있는 코드 조각
    • 일반적으로 기능을 기준으로 파일 단위로 분리
    • 자신만의 파일 스코프(모듈 스포크)를 가질 수 있을 때 모듈 성립
  • 모듈은 개별적인 존재로서 애플리케이션과 분리되어 존재
    • 자신만의 파일 스코프를 갖는 모듈의 자산은 캡슐화되어 다른 모듈에서 접근 불가
  • export
    • 모듈이 공개가 필요한 자산에 한정하여 선택적으로 공개하는 것
    • 이를 통해 다른 모듈에서 재사용 가능
  • 모듈 사용자(module consumer)
    • 공개(export)된 모듈의 자산을 사용하는 모듈
  • import
    • 모듈 사용자가 모듈이 공개한 자산 중 일부 또는 전체를 선택해 자신의 스코프 내로 불러들여 재사용하는 것
  • 장점
    • 모듈을 이용해 코드의 단위를 명확히 분리해 애플리케이션을 구성할 수 있다.
    • 재사용성이 좋다.
    • 따라서 개발 효율성과 유지보수성을 높일 수 있다.

48.2 자바스크립트와 모듈

  1. 자바스크립트는 파일 스코프와 import, export를 지원하지 않는다.
  2. script 태그로 자바스크립트 파일을 로드해도 분리된 자바스크립트 파일은 결국 하나의 자바스크립트 파일 내에 있는 것처럼 동작한다.
  3. 자바스크립트를 브라우저 환경에 국한하지 않고 사용하기 위해 모듈 시스템이 해결되어야 했고 이때 제안된 것이 CommonJS와 AMD(Asynchronous Module Definition)이다.
  4. 브러우저 환경에서 모듈을 사용하기 위해선 CommonJS 또는 AMD를 구현한 모듈 로더 라이브러리르 사용해야 한다.
  5. Node.js는 모듈 시스템의 사실상 표준(de facto standard)인 CommonJS를 채택했고, 완벽히 동일하지는 않지만 기본적으로 CommonJS 사양을 따른다.
  6. 즉 Node.js는 ECMAScript 표준 사양은 아니지만 모듈 시스템을 지원하고 따라서 파일별로 독립적인 파일 스코프를 가질 수 있다.

48.3 ES6 모듈(ESM)

  • ES6에서는 클라이언트 사이드 자바스크립트에서도 동작하는 모듈 기능 추가
  • 사용법: script 태그에 type="module" 어트리뷰트를 추가

    1
    
      <script type="module" src="app.mjs"></script>
    
    • 로드된 자바스크립트 파일은 모듈로서 동작
    • 일반 자바스크립트 파일이 아닌 ESM임을 명확히 하기 위해 ESM 파일 확장자는 mjs를 사용할 것을 권장
  • ESM에는 클래스처럼 기본적으로 strict mode가 적용된다.

48.3.1 모듈 스코프

  • 일반적인 자바스크립트 파일

    1
    2
    3
    4
    5
    
      // foo.js
        
      // x 변수는 전역 변수다.
      var x = 'foo';
      console.log(window.x); // foo
    
    1
    2
    3
    4
    5
    6
    7
    
      // bar.js
        
      // x 변수는 전역 변수다. foo.js에서 선언한 전역 변수 x와 중복된 선언이다.
      var x = 'bar';
        
      // foo.js에서 선언한 전역 변수 x의 값이 재할당되었다.
      console.log(window.x); // bar
    
    1
    2
    3
    4
    5
    6
    7
    
      <!DOCTYPE html>
      <html>
      <body>
        <script src="foo.js"></script>
        <script src="bar.js"></script>
      </body>
      </html>
    
    • 분리되어 로드된 2개의 자바스크립트 파일은 하나의 자바스크립트 파일 내에 있는 것처럼 동작 ⇒ 하나의 전역을 공유
  • ESM은 파일 자체의 독자적인 모듈 스코프를 제공

    1
    2
    3
    4
    5
    6
    
      // foo.mjs
        
      // x 변수는 전역 변수가 아니며 window 객체의 프로퍼티도 아니다.
      var x = 'foo';
      console.log(x); // foo
      console.log(window.x); // undefined
    
    1
    2
    3
    4
    5
    6
    7
    
      // bar.mjs
        
      // x 변수는 전역 변수가 아니며 window 객체의 프로퍼티도 아니다.
      // foo.mjs에서 선언한 x 변수와 스코프가 다른 변수다.
      var x = 'bar';
      console.log(x); // bar
      console.log(window.x); // undefined
    
    1
    2
    3
    4
    5
    6
    7
    
      <!DOCTYPE html>
      <html>
      <body>
        <script type="module" src="foo.mjs"></script>
        <script type="module" src="bar.mjs"></script>
      </body>
      </html>
    
    • 모듈 내에서 var 키워드로 선언한 변수는 전역 변수가 아니며 window 객체의 프로퍼티도 아니다.
  • 모듈 내에서 선언한 식별자는 모듈 외부에서 참조 불가

    • 모듈 스코프가 다르기 때문
    1
    2
    3
    4
    
      // foo.mjs
        
      const x = 'foo';
      console.log(x); // foo
    
    1
    2
    3
    
      // bar.mjs
        
      console.log(x); // ReferenceError: x is not defined
    
    1
    2
    3
    4
    5
    6
    7
    
      <!DOCTYPE html>
      <html>
      <body>
        <script type="module" src="foo.mjs"></script>
        <script type="module" src="bar.mjs"></script>
      </body>
      </html>
    

48.3.2 export 키워드

  • 다른 모듈이 재사용할 수 있도록 모듈 내부에서 선언한 식별자를 외부에 공개하기 위해 사용
  • 선언문 앞에 사용하여 모든 식별자를 export할 수 있다.

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    
      // lib.mjs
        
      // 변수의 공개
      export const pi = Math.PI;
        
      // 함수의 공개
      export function square(x) {
        return x * x;
      }
        
      // 클래스의 공개
      export class Person {
        constructor(name) {
          this.name = name;
        }
      }
    
  • export할 대상을 하나의 객체로 구성하여 한 번에 export할 수 있다.

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    
      // lib.mjs
        
      const pi = Math.PI;
        
      function square(x) {
        return x * x;
      }
        
      class Person {
        constructor(name) {
          this.name = name;
        }
      }
        
      // 변수, 함수 클래스를 하나의 객체로 구성하여 공개
      export { pi, square, Person };
    

48.3.3 import 키워드

  • 다른 모듈에서 공개(export)한 식별자를 자신의 모듈 스코프 내부로 로드하기 위해 사용
  • 다른 모듈이 export한 식별자 이름으로 import해야 한다.
    • ESM의 경우 파일 확장자를 생략할 수 있다.
    1
    2
    3
    4
    5
    6
    7
    8
    9
    
      // app.mjs
        
      // 같은 폴더 내의 lib.mjs 모듈이 export한 식별자 이름으로 import한다.
      // ESM의 경우 파일 확장자를 생략할 수 없다.
      import { pi, square, Person } from './lib.mjs';
        
      console.log(pi);         // 3.141592653589793
      console.log(square(10)); // 100
      console.log(new Person('Lee')); // Person { name: 'Lee' }
    
    1
    2
    3
    4
    5
    6
    
      <!DOCTYPE html>
      <html>
      <body>
        <script type="module" src="app.mjs"></script>
      </body>
      </html>
    
    • app.mjs는 애플리케이션의 진입점(entry point)이므로 반드시 script 태그로 로드해야 한다.
    • lib.mjsapp.mjsimport문에 의해 로드되는 의존성(dependency)이므로 script 태그로 로드하지 않아도 된다.
  • 하나의 이름으로 한 번에 식별자 이름을 import할 수 있다.
    • import되는 식별자는 as 뒤에 지정한 이름의 객체의 프로퍼티로 할당된다.
    1
    2
    3
    4
    5
    6
    7
    8
    
      // app.mjs
        
      // 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할 수 있다.

    1
    2
    3
    4
    5
    6
    7
    8
    
      // 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' }
    

default 키워드

  • 모듈에서 하나의 값만 export 하는 경우 default 키워드를 사용할 수 있다.
    • 이때 기본적으로 이름 없이 하나의 값을 export한다.
    1
    2
    3
    
      // lib.mjs
        
      export default x => x * x;
    
  • default 키워드를 사용하는 경우 var, let, const 키워드는 사용할 수 없다.

    1
    2
    3
    4
    5
    
      // lib.mjs
        
      export default const foo = () => {};
      // => SyntaxError: Unexpected token 'const'
      // export default () => {};
    
  • default 키워드와 함께 export한 모듈은 {} 없이 임의의 이름으로 import한다.

    1
    2
    3
    4
    5
    
      // app.mjs
        
      import square from './lib.mjs';
        
      console.log(square(3)); // 9
    
This post is licensed under CC BY 4.0 by the author.