GaramX

사용자 도구

사이트 도구

현재 위치: home » typescript » enum
추적: • enum • xml_sql
typescript:enum

차이

문서의 선택한 두 판 사이의 차이를 보여줍니다.

차이 보기로 링크

양쪽 이전 판이전 판
다음 판		이전 판
typescript:enum [2019/07/28 16:16] – [declare or ambient] taekgutypescript:enum [2025/04/15 10:05] (현재) – 바깥 편집 127.0.0.1
줄 28: 줄 28:
 </code> </code>
 spec은 이 대체를 호출합니다. 개인적으로 소리가 좋기때문에 "inlining"으로 명명하겠다. 때때로 열거형 값이 향후 API 버전에서 변경 될 수 있기 때문에 열거형 멤버가 인라인되지 않게하려는 경우가 있습니다. spec은 이 대체를 호출합니다. 개인적으로 소리가 좋기때문에 "inlining"으로 명명하겠다. 때때로 열거형 값이 향후 API 버전에서 변경 될 수 있기 때문에 열거형 멤버가 인라인되지 않게하려는 경우가 있습니다.
 +
 +===== Enums, how do they work? =====
 +열거 형의 각 측면별로 이것을 분해 해 봅시다. 불행히도이 네 섹션은 다른 모든 섹션의 용어를 참조 할 것 이므로 이 모든 것을 두 번 이상 읽어야합니다.
 +
 +==== computed vs non-computed (constant) ====
 +Enum 멤버는 계산됨 이거나 아니거나다. 스펙은 비계산 멤버는 //constant//라 명명한다, 그러나 //const//와 충돌을 회피하기 위해서 //non-computed//라 부르겠다.
 +
 +computed enum 멤버는 컴파일 타임에 값을 알 수 없는 멤버입니다. 물론 계산 된 멤버에 대한 참조는 인라인 될 수 없습니다. 반대로 계산되지 않은 열거 형 멤버는 한 번 컴파일 타임에 알려진 값입니다. 계산되지 않은 멤버에 대한 참조는 항상 인라인됩니다.
 +
 +어떤 enum 멤버가 계산되고 계산되지 않는 것입니까? 첫째, const enum의 모든 멤버는 이름에서 알 수 있듯이 상수 (즉, 계산되지 않음)입니다. 비 const 열거 형의 경우에는 앰비언트(선언) enum인지 또는 non-ambient enum인지 여부에 따라 다릅니다.
 +
 +declare enum (즉, ambient enum)의 멤버는 초기화가 있는 경우에만 상수입니다. 그렇지 않으면 computed이다. declare enum에서 numeric 초기화만 사용할 수 있습니다.
 +예:
 +<code javascript>
 +declare enum Foo {
 +  X, // computed
 +  Y = 2, // Non-computed
 +  Z, // Computed! Not 3! Careful!
 +  Q = 1 + 1 // Error
 +}
 +</code>
 +
 +마지막으로 non-declare non-const enum의 멤버는 항상 계산 된 것으로 간주됩니다. 그러나 컴파일 타임에 계산할 수 있는 경우 해당 초기화식이 상수로 축소됩니다. 이것은 비 const 열거 형 멤버가 결코 인라인되지 않음을 의미합니다 (이 동작은 TypeScript 1.5에서 변경되었으므로 맨 아래의 "TypeScript에서 변경된 사항"참조)
 +
 +==== const vs non-const ====
 +=== const ===
 +enum선언은 ''const''수정자를 가질 수 있다. 만약 enum이 ''const''라면 모든 멤버는 inline으로 처리된다.
 +<code javascript>
 +const enum Foo { A = 4 }
 +var x = Foo.A; // emitted as "var x = 4;", always
 +</code>
 +const enum은 컴파일 할 때 lookup object를 생성하지 않습니다. 이러한 이유 때문에 위 참조 코드에서 Foo를 참조하는 것은 회원 참조의 일부분을 제외하고는 오류입니다. 런타임에는 Foo 객체가 없습니다.
 +
 +=== non-const ===
 +enum 선언에 const 한정자가없는 경우 멤버가 계산되지 않은 경우에만 멤버에 대한 참조가 인라인됩니다. non-const, non-declare enum은 lookup object를 생성합니다.
 +
 +==== declare(ambient) vs non-declare ====
 +중요한 서문은 TypeScript의 ''declare''이 매우 구체적인 의미를 갖는다는 것입니다.//이 객체는 다른 곳에 존재합니다.// 기존 개체를 설명하기위한 것입니다. 실제로 존재하지 않는 객체를 정의하기 위해 declare를 사용하면 나쁜 결과가 발생할 수 있습니다. 우리는 나중에 그것들을 탐구 할 것입니다.
 +
 +=== declare ===
 +declare enum은 lookup object를 생성하지 않습니다. 해당 멤버에 대한 참조는 해당 멤버가 계산되면 inline됩니다 (위의 computed vs non-computed 항목 참조).
 +
 +declare enum에 대한 다른 형식의 참조가 허용된다는 점에 유의해야합니다. 이 코드는 컴파일 오류가 아니지만 런타임에 실패합니다.
 +<code javascript>
 +// Note: Assume no other file has actually created a Foo var at runtime
 +declare enum Foo { Bar }
 +var s = 'Bar'
 +var b = Foo[s]; // Fails
 +</code>
 +이 오류는 "컴파일러에게 거짓말하지 마십시오"라는 범주에 속합니다. 런타임에 Foo라는 객체가 없으면 declare enum Foo!를 작성하지 마십시오!
 +
 +declare const enum은 --preserveConstEnums (아래 참조)를 제외하고 const enum과 다르지 않습니다.
 +
 +=== non-declare ===
 +non-declare enum은 const가 아닌 경우 lookup object를 생성합니다. inlining은 위에 설명되어 있습니다.
 +
 +=== --preserveConstEnums flag ===
 +이 플래그는 정확히 한 가지 효과를 냅니다. non-declare const enum은 조회 객체를 방출합니다. 인라인은 영향을받지 않습니다. 이것은 디버깅에 유용합니다.
 +
 +==== Common Errors ====
 +가장 일반적인 실수는 일반 enum이나 const enum이 더 적절한 경우 선언 열거 형을 사용하는 것입니다. 일반적인 형식은 다음과 같습니다.
 +<code javascript>
 +module MyModule {
 +    // Claiming this enum exists with 'declare', but it doesn't...
 +    export declare enum Lies {
 +        Foo = 0,
 +        Bar = 1     
 +    }
 +    var x = Lies.Foo; // Depend on inlining
 +}
 +
 +module SomeOtherCode {
 +    // x ends up as 'undefined' at runtime
 +    import x = MyModule.Lies;
 +
 +    // Try to use lookup object, which ought to exist
 +    // runtime error, canot read property 0 of undefined
 +    console.log(x[x.Foo]);
 +}
 +</code>
 +<WRAP center round important 60%>
 +기억하십시오 : 실제로 존재하지 않는 것을 ''declare''하지 마십시오. 항상 inlining을 원하면 const enum을 사용하고, lookup object를 원한다면 enum을 사용하십시오.
 +</WRAP>
 +
 +==== Changes in TypeSript ====
 +TypeScript 1.4와 1.5 사이에는 non-declare non-const enums의 모든 멤버를 computed로 처리하도록 변경되었습니다 ([[https://github.com/Microsoft/TypeScript/issues/2183|https://github.com/Microsoft/TypeScript/issues/2183 참조]]). 그들은 리터럴로 명시적으로 초기화됩니다. 이렇게 말하면, 인라인 동작을 보다 예측 가능하고보다 명확하게 const enum의 개념을 일반 enum으로부터 분리하는 "아기 분리 해제". 이 변경 이전에 non-const enum의 non-computed 멤버는 보다 적극적으로 inline되었습니다.
 ===== Enums ===== ===== Enums =====
 enum을 사용하면 이름이 부여된 상수 집합을 정의할 수 있다. enum을 사용하면 이름이 부여된 상수 집합을 정의할 수 있다.
줄 162: 줄 248:
 var directions = [0 /* Up */, 1 /* Down */, 2 /* Left */, 3 /* Right */]; var directions = [0 /* Up */, 1 /* Down */, 2 /* Left */, 3 /* Right */];
 </code> </code>
 +https://engineering.linecorp.com/ko/blog/typescript-enum-tree-shaking
 ==== Ambient enums ==== ==== Ambient enums ====
 앰비언트 열거 형은 이미 존재하는 열거 형의 모양을 설명하는 데 사용됩니다. 앰비언트 열거 형은 이미 존재하는 열거 형의 모양을 설명하는 데 사용됩니다.
typescript/enum.1564330574.txt.gz · 마지막으로 수정됨: 2025/04/15 10:05 (바깥 편집)

문서 도구