반응형

타입스크립트의 모듈 시스템 이해하기

모듈의 기본 개념과 중요성

모듈은 독립적인 기능 단위로, 코드를 체계적으로 구성하는 핵심 요소입니다. 모듈 시스템을 사용함으로써 얻을 수 있는 주요 이점들은 다음과 같습니다:

  1. 유지 보수성 향상
    • 코드 중복을 최소화하여 버그 발생 가능성 감소
    • 기능별로 분리된 코드로 수정이 용이
  2. 전역 스코프 오염 방지
    • 각 파일이 독립적인 스코프를 가짐
    • 변수명 충돌 문제 해결
  3. 재사용성 증가
    • 모듈을 여러 프로젝트에서 재사용 가능
    • 코드의 재사용성과 이식성 향상

TypeScript의 두 가지 모듈 시스템

1. 외부 모듈 (External Modules)

ES6의 모듈 시스템을 기반으로 하며, importexport 키워드를 사용합니다.

// math.ts
export function add(x: number, y: number): number {
    return x + y;
}

export function multiply(x: number, y: number): number {
    return x * y;
}

// main.ts
import { add, multiply } from './math';

console.log(add(2, 3));      // 5
console.log(multiply(2, 3)); // 6

2. 내부 모듈 (Internal Modules / Namespace)

네임스페이스를 사용한 TypeScript 고유의 모듈화 방식입니다.

// validation.ts
namespace Validation {
    export interface StringValidator {
        isValid(s: string): boolean;
    }

    export class EmailValidator implements StringValidator {
        isValid(s: string): boolean {
            const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
            return emailRegex.test(s);
        }
    }
}

// 사용하기
let emailChecker = new Validation.EmailValidator();

모듈 시스템의 특징 비교

ES Modules (외부 모듈)의 장점

  1. 현대적인 접근방식
    • ES6 표준을 따르는 방식
    • 대부분의 모던 도구들과 호환성이 좋음
  2. 트리 쉐이킹 지원
    • 사용하지 않는 코드를 제거하여 번들 크기 최적화
    • 더 효율적인 코드 관리 가능
  3. 명확한 의존성 관리
    • 의존성을 명시적으로 선언
    • 컴파일 시점에 의존성 체크 가능
// 명시적인 의존성 선언
import { Component } from './component';
import { Utils } from './utils';

export class MyComponent extends Component {
    constructor() {
        super();
        Utils.doSomething();
    }
}

Namespace (내부 모듈)의 특징

  1. 레거시 지원
    • 오래된 TypeScript 프로젝트와의 호환성
    • AMD/CommonJS 이전의 모듈화 방식
  2. 단일 파일 번들링
    • --outFile 컴파일러 옵션으로 단일 파일 생성
    • 간단한 프로젝트에서 유용
/// <reference path="validations.ts" />
namespace App {
    export class Main {
        start() {
            let validator = new Validation.EmailValidator();
            console.log(validator.isValid("test@email.com"));
        }
    }
}

현대적인 개발에서의 권장사항

  1. ES Modules 사용 권장
    • 새로운 프로젝트는 ES Modules 사용
    • 더 나은 도구 지원과 생태계 통합
  2. 점진적 마이그레이션
    • 기존 네임스페이스 기반 코드는 점진적으로 ES Modules로 전환
    • 호환성을 고려한 전환 계획 수립
  3. 모듈 시스템 일관성
    • 한 프로젝트 내에서 일관된 모듈 시스템 사용
    • 혼합 사용은 가급적 피하기

컴파일 설정과 모듈 시스템

Namespace

{
    "compilerOptions": {
        "target": "es5",
        "module": "amd",
        "outFile": "./dist/bundle.js",
        "rootDir": "./src",
        "strict": true
    }
}

ES Modules

{
    "compilerOptions": {
        "module": "es2015",        // ES Modules 사용
        "moduleResolution": "node", // 모듈 해석 방식
        "target": "es5",           // 출력 JS 버전
        "sourceMap": true,         // 소스맵 생성
        "outDir": "./dist"         // 출력 디렉토리
    }
}

이러한 현대적인 접근 방식을 통해 더 안정적이고 유지보수가 용이한 TypeScript 프로젝트를 구축할 수 있습니다.

반응형
반응형

ES5.1

var myobj = (function () {

    // private members

    var name = "my, oh my";

    // implement the public part

    return {

        getName: function () {

            return name;

        }

    };

}());

myobj.getName(); // "my, oh my"



메모리 아끼는법 

function Gadget() {

    // private member

    var name = 'iPod';

    // public function

    this.getName = function () {

        return name;

    };

}

Gadget.prototype = (function () {

    // private member

    var browser = "Mobile Webkit";

    // public prototype members

    return {

        getBrowser: function () {

            return browser;

        }

    };

}());

 

 

ES6 

class Gadget {

var name = 'iPod'

getName() {

return name; 

}



static getBrowser() {

  var browser = "Mobile Webkit";

  return browser;

  }

}

 

 

ES2021+

class Gadget {

  #name = 'iPod'

  getName() {

  return name; 

  }
}

 

참조: 

http://www.2ality.com/2016/01/private-data-classes.html

반응형
반응형

화면 영역에서 클릭한 영역마다 HTML 엘리멘트가 겹칠경우 겹치 영역에 따라 다른 이벤트를 처리하기 위해서는 이벤트 구분이 필요하다.


픽셀단위로 영역을 짜르는 경우는 해상도가 디바이스마다 다른 요즘환경에서는 사용하기 어려운 방법이기 때문에 

다른방법으로 영역을 잡는 방법이 있지 않을까 해서 자바스크립트 레퍼런스를 뒤지던중 아래와 같은 방법으로 처리하게되었다.


$("selector").click(function(evt) { var target = evt.originalEvent.target; if (target.nodeName == "CANVAS") { // 클릭한 영역이 캔버스일 경우 처리 } else if (target.nodeName == "DIV") { // 클릭한 영역이 DIV일 경우 처리 } });


기존 클릭 영역을 동적으로 계산하는 방식은 정확도가 매우 부정확했지만 이와 같은 방법으로 

다른 구준자를 넣어 동일한 엘리먼트들에 대해서도 다른 방식으로 처리하는 방식으로 응용할수 있지 않을까 생가한다 .

반응형
반응형

프로젝트를 제작하며 사용하는 유용한 자바스크립트 라이브러리 모음 (2016-11-13 업데이트) 


Tabular: 테이블 표출

- 홈페이지: http://olifolkerd.github.io/tabulator/

- 사용법:https://www.sitepoint.com/dynamic-tables-json/


Kendo UI: 종합 UI  

- 홈페이지: http://www.telerik.com/kendo-ui


Flowchart.js: Flowchart 라이브러리

http://flowchart.js.org/


Fullcalendar

https://fullcalendar.io/



반응형
반응형

Webpack 을 사용하면서 개인적으로 자주 사용하게 되는 플러그인 목록 정리


1. CommonsChunkPlugin (https://github.com/webpack/docs/wiki/optimization) 

멀티페이지 어플리케이션의 경우 공통적으로 사용 되는 모듈들을 추적하여 따로 넣는 경우



참고:

1. 웹팩 플러그인 리스트: https://github.com/webpack/docs/wiki/list-of-plugins


반응형
반응형



1. 

stylesheets/

|

|-- modules/              # Common modules

|   |-- _all.scss         # Include to get all modules

|   |-- _utility.scss     # Module name

|   |-- _colors.scss      # Etc...

|   ...

|

|-- partials/             # Partials

|   |-- _base.sass        # imports for all mixins + global project variables

|   |-- _buttons.scss     # buttons

|   |-- _figures.scss     # figures

|   |-- _grids.scss       # grids

|   |-- _typography.scss  # typography

|   |-- _reset.scss       # reset

|   ...

|

|-- vendor/               # CSS or Sass from other projects

|   |-- _colorpicker.scss

|   |-- _jquery.ui.core.scss

|   ...

|

`-- main.scss            # primary Sass file



참고:

http://thesassway.com/beginner/how-to-structure-a-sass-project


2. 

반응형
반응형

얼마전에 Typescript 2.0이 발표되었고 가장 큰 변화점이라고 하면 기존 typings 멸령어 대신에 아래와 같이 간편화가 되었다는 것이다.

이제 typings 로 하던 불편함을 npm 에서 바로 실행할수 있게되었다. 


기존이 아래와 같은 방식으로 설치했다면

typings install dt~mocha --global --save


이제 아래와 같은 식으로 설치 가능하다. 

npm install --save-dev @types/lodash

타입스크립트는 처음 설정이 까다롭지만 처음부터 타입스크립트로 개발하다보며 유지보수에 놀라운 효율을 발견하게 될것이다



반응형
반응형

전세계를 타겟팅으로 하는 프로그램을 개발하다보면 각각의 지역별로 시간차이를 이용해서 로직을 작성할때가 있습니다.

그때 기준으로 사용되는 GMT 또는 UTC 를 브라우저 상에서 구하는 방법입니다. 

GMT 와 UTC 는 정확히는 다르지만 표현하는 시간대는 같다고 보시면 됩니다. 

Browser 상에서 new Date() 를 치면 GMT를 기준으로 시간대가 표시되는데 문자를 추출할수 있습니다. 

 

 

 

1. GMT 오프셋 구하기 

 

var offset = new Date().getTimezoneOffset();
console.log(offset);

출력: -540

 

시간 구하기 

offset / 60 

출력: -9

 

2. 현재 GMT 구하기

new Date().toString().match(/([A-Z]+[\+-][0-9]+)/)[1]
출력: GMT+0900

 

 

참고:

1. https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/getTimezoneOffset

2. http://stackoverflow.com/questions/1091372/getting-the-clients-timezone-in-javascript

 

반응형
반응형

Typescript 는 기본적으로 파일안에 범위안에 선언되어 있지 않은 함수나 변수들에 대해서 컴파일 오류를 발생하게된다. 

브라우저관련으로 자바스크립트로 프로그래밍을 하다보면 간혹 전역으로 변수 혹은 함수를 공유할 경우가 생기는데

기존 자바스크립트는 window 객체에 추가혹은 전역 범위에 함수나 혹은 변수를 추가하면 내부적으로 자동으로 window객체에 추가되어

전역적으로 사용가능했으나 Typescript에서는 되지않았다.


interface Window { MyNamespace: any; }

window.MyNamespace = window.MyNamespace || {};

참고:

http://stackoverflow.com/questions/12709074/how-do-you-explicitly-set-a-new-property-on-window-in-typescript

반응형
반응형

기존 JavaScript 코드베이스를 TypeScript로 통합하기

기존 순수 JavaScript 코드베이스를 TypeScript로 옮길 때 발생할 수 있는 주요 문제 중 하나는 모듈 경로를 찾지 못하는 문제입니다. 이 문제를 해결하기 위해 설정 및 모듈 사용 방법에 대해 정리했습니다.


TypeScript 설정 추가

tsconfig.json에서 다음 두 옵션을 설정하여 기존 JavaScript 파일을 TypeScript 프로젝트에 포함할 수 있습니다.

{
  "compilerOptions": {
    "allowJs": true,  // JavaScript 파일을 포함
    "checkJs": false  // JavaScript 파일의 타입 검사 비활성화
  }
}

주요 효과

  • allowJs: TypeScript 프로젝트에 JavaScript 파일을 포함할 수 있습니다.
  • checkJs: JavaScript 파일에 대해 타입 검사를 하지 않습니다.

기존 모듈의 사용

만약 a.js 파일이 아래와 같이 정의되어 있다면:

a.js

function hey() {
    console.log("hey");
}
export { hey };

이를 TypeScript에서 사용하는 방법은 다음과 같습니다.

main.ts

1. ES 모듈 방식

import * as moduleA from './a'; // 또는 명시적으로 상대 경로 작성
moduleA.hey();

2. CommonJS 스타일

const moduleA = require('./a');
moduleA.hey();

더 TypeScript스러운 방법으로 사용하기

1. .d.ts 파일로 타입 정의 추가

JavaScript 모듈의 타입을 정의하면 TypeScript 코드에서 안전하게 사용할 수 있습니다.

a.d.ts

declare module './a' {
    export function hey(): void;
}

이렇게 하면 TypeScript는 a.js를 사용할 때 타입 정보를 제공합니다.


2. 타입 정의가 포함된 라이브러리 사용

써드파티 JavaScript 라이브러리를 사용할 때는 이미 제공된 타입 정의를 활용할 수 있습니다. 타입 정의는 @types/ 패키지를 통해 설치 가능합니다.

npm install --save-dev @types/library-name

이후 TypeScript에서 바로 타입 정보를 활용할 수 있습니다.


3. ES 모듈로 변환

기존 JavaScript 코드를 TypeScript와 자연스럽게 동작하도록 리팩토링할 수도 있습니다.

기존 JavaScript (a.js)

export function hey() {
    console.log("hey");
}

TypeScript에서 사용 (main.ts)

import { hey } from './a';
hey();

추가 참고 자료

  1. 공식 TypeScript 문서 - JavaScript 파일 포함하기
  2. TypeScript에서 JavaScript 모듈 사용하기
  3. TypeScript 공식 문서 - Declaration Files

마무리

위 방법들을 활용하면 기존 JavaScript 코드베이스를 TypeScript로 점진적으로 통합할 수 있습니다.
다음 단계로는:

  1. 타입 정의를 작성하거나
  2. @types 패키지를 활용해 써드파티 라이브러리를 더 TypeScript스럽게 사용할 수 있습니다.
반응형

'Front-End > Java Script' 카테고리의 다른 글

Webpack 유용한 플러그인 모음  (0) 2016.10.30
현재 브라우저의 UTC(UTC) 타임 구하기  (0) 2016.10.05
자바스크립트 모듈 번들러 (1) - webpack  (0) 2016.07.25
ES6 문법 Cheat Sheet  (0) 2016.04.21
JavaScript 객체  (0) 2014.11.06

+ Recent posts