문자열과 숫자 인덱스 시그니처 비교
숫자 키의 규칙과 특성을 이해합니다.
문자열과 숫자 인덱스 시그니처 비교은(는) CoddyKit의 무료 TypeScript Academy 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 TypeScript Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. TypeScript Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
두 종류의 인덱스 keys
TypeScript는 문자열 및 숫자 인덱스 시그니처를 모두 지원합니다. 두 시그니처는 비슷해 보이지만 JavaScript가 실제로 객체의 keys를 저장하는 방식 때문에 다르게 동작합니다.
숫자 인덱스 시그니처
숫자 인덱스 시그니처 { [i: number]: T }는 숫자 위치로 인덱싱되는 객체를 설명합니다. 가장 자연스러운 예로 배열과 배열처럼 동작하는 구조가 있습니다.
type NumberList = { [index: number]: string }
const names: NumberList = { 0: "ana", 1: "leo" }
console.log(names[0]) // anaJS는 숫자 keys를 문자열로 변환합니다
핵심 사실은 다음과 같습니다. JavaScript 객체의 keys는 항상 문자열입니다. obj[0]이라고 작성하면 엔진은 실제로 key를 문자열 "0"으로 저장합니다. TypeScript는 이러한 현실을 모델링합니다.
const obj: Record<string, string> = {}
obj[1] = "one"
console.log(obj["1"]) // one — same key!
console.log(Object.keys(obj)) // ["1"]호환성 규칙
숫자 key는 내부적으로 문자열이므로 TypeScript는 다음 규칙을 적용합니다. 객체에 숫자 인덱스 시그니처와 문자열 인덱스 시그니처가 둘 다 있으면 숫자 인덱스의 값 타입을 문자열 인덱스의 값 타입에 할당할 수 있어야 합니다.
interface Mixed {
[key: string]: string
[index: number]: string // must match the string value type
}
const m: Mixed = { 0: "a", name: "b" }
console.log(m[0], m.name)이 규칙이 존재하는 이유
obj[0]과 obj["0"]이 같은 위치를 가리킨다면 한쪽의 값 타입은 숫자이고 다른 쪽은 문자열일 수 없습니다. 따라서 일관성을 유지하려면 숫자 인덱스의 값 타입이 문자열 인덱스의 값 타입에 포함되는 하위 타입이어야 합니다.
// This is an ERROR:
// interface Bad {
// [key: string]: string
// [index: number]: number // number not assignable to string
// }숫자 인덱스: 배열
배열은 대표적인 숫자 인덱스 타입입니다. 내장된 Array<T> 타입에는 사실상 숫자 인덱스 시그니처가 있으므로 arr[i]는 T를 반환합니다.
const nums: number[] = [10, 20, 30]
const first: number = nums[0]
console.log(first + nums[2]) // 40튜플도 숫자로 인덱싱됩니다
튜플은 숫자 인덱싱을 기반으로 하지만 특정 위치를 특정 타입에 연결합니다. 범위를 벗어난 숫자 접근은 요소 타입의 유니언으로 대체되거나 오류로 표시됩니다.
const pair: [string, number] = ["age", 30]
const label: string = pair[0]
const value: number = pair[1]
console.log(label + ": " + value)문자열 인덱스는 두 방식의 조회를 허용합니다
문자열 인덱스 시그니처가 있는 객체는 숫자로 보이는 접근도 허용합니다. 숫자가 먼저 문자열 key로 변환되기 때문입니다.
type Bag = { [key: string]: number }
const b: Bag = {}
b[5] = 100 // stored as key "5"
console.log(b["5"]) // 100숫자 인덱스는 문자열을 허용하지 않습니다
반대의 경우는 성립하지 않습니다. 숫자 인덱스 시그니처만 있는 타입의 객체는 JS에서 기술적으로 허용하더라도 컴파일 시점에 문자열 keys를 거부합니다.
type OnlyNumbers = { [i: number]: string }
const o: OnlyNumbers = { 0: "x" }
// o.name = "y" // Error: property name not on number-indexed type
console.log(o[0])둘 중 선택하기
순서나 위치를 기반으로 하는 데이터에는 숫자 인덱스를 사용하십시오. 예를 들면 목록과 튜플이 있습니다. 이름으로 조회하는 데이터에는 문자열 인덱스를 사용하십시오. 예를 들면 사전과 캐시가 있습니다. 확실하지 않다면 문자열 인덱스가 더 일반적인 선택입니다.
type Positions = { [i: number]: { x: number; y: number } }
type ByName = { [name: string]: { x: number; y: number } }
const p: Positions = { 0: { x: 1, y: 2 } }
console.log(p[0].x)실용적인 Mixed 객체
값 타입이 두 시그니처 모두에 맞을 때는 두 시그니처를 결합할 수 있습니다. 이름이 지정된 슬롯도 제공하는 희소 배열형 컨테이너에 유용합니다.
interface Flexible {
[key: string]: number
[index: number]: number
}
const f: Flexible = { 0: 1, total: 99 }
console.log(f[0] + f.total) // 100빠른 확인
문자열 인덱스 시그니처와 숫자 인덱스 시그니처의 차이에 대한 이해도를 테스트해 보십시오.
복습
JS는 모든 key를 문자열로 저장하고 숫자를 문자열 key로 변환하므로 문자열 인덱스 시그니처와 숫자 인덱스 시그니처는 서로 다르게 동작합니다. 두 시그니처가 모두 있으면 숫자 인덱스의 값 타입을 문자열 인덱스의 값 타입에 할당할 수 있어야 합니다. 숫자 인덱싱은 배열과 튜플을 모델링하고, 문자열 인덱싱은 사전을 모델링합니다. 문자열 인덱스 객체는 숫자 접근을 허용하지만, 숫자 인덱스 객체는 컴파일 시점에 문자열 keys를 거부합니다.
AI 튜터와 함께 TypeScript을(를) 배우세요 — 무료
브라우저에서 실제 코드를 작성하고 실행하며, 24/7 AI 튜터로부터 즉각적인 도움을 받고, 웹이나 앱에서 중단한 부분부터 계속 학습하세요.
- 코스
- 101
- 레슨
- 352
자주 묻는 질문
“문자열과 숫자 인덱스 시그니처 비교” 강의는 무료인가요?
네 — “문자열과 숫자 인덱스 시그니처 비교” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 TypeScript Academy 강의 전체를 잠금 해제할 수 있습니다. TypeScript Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“문자열과 숫자 인덱스 시그니처 비교”에서 뭘 배우나요?
숫자 키의 규칙과 특성을 이해합니다. 브라우저에서 직접 실행하는 실습 코드로 TypeScript Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
TypeScript Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 TypeScript Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.
“문자열과 숫자 인덱스 시그니처 비교” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 TypeScript Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 TypeScript Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- 인덱스 시그니처 정의
- 문자열과 숫자 인덱스 시그니처 비교
- 알려진 키와 동적 키 결합
- 인덱스 시그니처와 Record 비교