Files

T

koriweb 5ba5a55c78 feat: Wiki 지식 자산 업데이트 - UX Scenarios, Frontend, Game Design, Topics 추가 [2026-05-08]

2026-05-08 19:52:07 +09:00

4.7 KiB

Raw Blame History

id, title, category, status, canonical_id, aliases, duplicate_of, source_trust_level, confidence_score, tags, raw_sources, last_reinforced, github_commit, inferred_by, tech_stack

title

as const

📌 한 줄 통찰 (The Karpathy Summary)

as const는 TypeScript에서 값을 깊은 수준의 읽기 전용(deeply readonly)으로 만들고, 해당 타입을 구체적인 리터럴 값으로 좁히는(narrows types to their literal values) 데 사용되는 단언(assertion) 문법입니다 [1]. 객체나 배열 등이 변경되지 않도록 컴파일 타임 검증과 런타임 불변성을 동시에 확보할 때 유용하게 쓰입니다 [2]. 특히 구성(configuration) 객체나 룩업 테이블을 정의할 때 다른 연산자와 결합하여 매우 강력하고 안전한 타입 패턴을 형성합니다 [2, 3].

📖 구조화된 지식 (Synthesized Content)

깊은 읽기 전용 및 리터럴 타입 축소 (Deeply Readonly & Literal Type Narrowing) as const 단언(assertion)을 사용하면 값은 깊게 읽기 전용(deeply readonly) 상태가 됩니다 [1]. 이와 더불어 TypeScript는 값을 포괄적인 기본 타입(예: string이나 number)으로 넓히지 않고, 작성된 리터럴 값 자체로 타입을 좁혀서(narrow) 추론합니다 [1].
satisfies 연산자와의 결합 패턴 as const는 satisfies 연산자와 결합하여 사용할 때 불변성(immutability)과 타입 검증(type validation)을 동시에 얻을 수 있는 강력한 패턴이 됩니다 [2]. 이 조합은 절대로 변경되어서는 안 되는 설정(configuration) 객체나 룩업 테이블(lookup tables)을 작성할 때 이상적입니다 [2, 4].
컴파일 타임과 런타임의 안정성 보장 이러한 단언 패턴을 도입하면 의도치 않은 값의 변경을 방지하는 동시에, 객체가 필수적인 타입 구조와 정확히 일치하도록 유지할 수 있습니다 [2]. 결과적으로 개발자는 컴파일 타임의 철저한 검증과 타입 안전성이 보장된 불변 객체를 얻게 됩니다 [2, 3].
기타 사용 맥락 일반적으로 프론트엔드 환경에서 타입 추론이나 타입 가드를 목적으로 as const를 흔히 붙여서 사용해 왔으나, 최신 문법 구조나 패턴 매칭 라이브러리 적용 등을 통해 이러한 as const 사용을 제거(대체)할 수 있다는 의견도 존재합니다 [5].

⚠️ 모순 및 업데이트 (Contradictions & Updates)

과거 데이터와의 충돌: 자동화 엔진에 의해 매핑된 지식으로, 추후 정밀 검증 필요.
정책 변화: Programming & Language 분야의 자동 자산화 수행.

🔗 지식 연결 (Graph)

Related Topics: satisfies, readonly, Literal Types, Type Narrowing
Projects/Contexts: TypeScript 구성(configuration) 객체 및 룩업 테이블 모델링, 불변성(Immutability) 보장 패턴
Contradictions/Notes: 소스 상에 명시적인 모순은 없으나, 타입 추론과 타입 가드를 위해 관행적으로 as const를 붙여 쓰던 것을 특정 패턴 도입을 통해 생략할 수도 있다는 개발자 커뮤니티의 코멘트가 존재합니다 [5].

Last updated: 2026-04-18

🤖 LLM 활용 힌트 (How to Use This Knowledge)

언제 이 지식을 쓰는가:

(TODO)

언제 쓰면 안 되는가:

(TODO)

🧪 검증 상태 (Validation)

정보 상태: needs_review
출처 신뢰도: A
검토 이유: (P-Reinforce Phase 1 자동 정규화. 본문 검증 필요.)

🧬 중복 검사 (Duplicate Check)

기존 유사 문서: (TODO: 인덱서 클러스터 리포트 참조)
처리 방식: UPDATE (자동 정규화)
처리 이유: Phase 1 정규화 — 옛 템플릿/누락 필드 보강.

🕓 변경 이력 (Changelog)

날짜	변경 내용	처리 방식	신뢰도
2026-05-08	P-Reinforce Phase 1 정규화 (frontmatter + 헤더 표준화)	UPDATE	A

💻 코드 패턴 (Code Patterns)

패턴 1: (TODO: 이 프로젝트 컨벤션 반영한 구조 스켈레톤)

# TODO

🤔 의사결정 기준 (Decision Criteria)

선택 A를 써야 할 때:

(TODO)

선택 B를 써야 할 때:

(TODO)

기본값:

(TODO)

❌ 안티패턴 (Anti-Patterns)

[안티패턴]: (TODO: 무엇을 하면 안 되는가 + 이유 + 대신 무엇을)

4.7 KiB Raw Blame History