이벤트 타입과 사용자 지정 이벤트; HTMLElement 하위 타입 좁히기
올바른 타입으로 DOM 이벤트를 처리하고, CustomEvent 페이로드를 만들며, HTMLElement 하위 타입을 안전하게 좁힙니다.
이벤트 타입과 사용자 지정 이벤트; HTMLElement 하위 타입 좁히기은(는) CoddyKit의 무료 TypeScript Academy 강의입니다. 이것은 3개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 TypeScript Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. TypeScript Academy 강의에는 총 3개의 강의가 포함되어 있습니다.
소개
목표: 타입이 지정된 이벤트 수신기를 추가하고, 요소 타입을 안전하게 좁히며, 페이로드와 함께 CustomEvent를 발생시킵니다.
- 이벤트 타입(MouseEvent, KeyboardEvent, InputEvent)
- instanceof로 target/currentTarget 타입 좁히기
- CustomEvent detail 페이로드
타입이 지정된 수신기
수신기 시그니처는 이벤트 이름에 따라 타입이 지정됩니다: click → MouseEvent, keydown → KeyboardEvent. 명확성을 위해 타입 주석을 명시적으로 추가합니다.
const btn = document.querySelector("#btn");
if (btn) {
btn.addEventListener("click", (ev: MouseEvent) => {
console.log("x=", ev.clientX, "y=", ev.clientY);
});
}
window.addEventListener("keydown", (ev: KeyboardEvent) => {
console.log("key=", ev.key);
});target과 currentTarget 비교
target은 원래 이벤트가 발생한 출처이므로 여러 타입일 수 있고, currentTarget은 수신기 객체입니다. 요소 API를 사용하기 전에 instanceof로 타입을 좁힙니다.
document.addEventListener("input", (ev: InputEvent) => {
const t = ev.target;
const c = ev.currentTarget; // here: Document
if (t instanceof HTMLInputElement) {
console.log("value=", t.value);
}
});CustomEvent 페이로드
CustomEvent<T>는 타입이 지정된 detail 페이로드를 전달합니다. 일치하는 제네릭 매개변수로 발생시키고 처리합니다.
type CounterDetail = { delta: number };
const inc = new CustomEvent<CounterDetail>("counter:change", {
detail: { delta: 1 }
});
document.dispatchEvent(inc);
document.addEventListener("counter:change", (ev: CustomEvent<CounterDetail>) => {
console.log("delta=", ev.detail.delta);
});하위 타입 좁히기
instanceof를 사용하여 특정 HTML 요소 클래스(예: HTMLButtonElement, HTMLAnchorElement)로 타입을 좁힙니다.
document.addEventListener("click", (ev: MouseEvent) => {
const el = ev.target;
if (el instanceof HTMLButtonElement) {
el.disabled = true; // safe: HTMLButtonElement API
} else if (el instanceof HTMLAnchorElement) {
console.log("href=", el.href);
}
});위임 및 가드
위임: 상위 요소(document)에서 수신한 다음, 일치하는 요소를 찾고 API에 접근하기 전에 타입을 좁힙니다.
document.addEventListener("click", (ev: MouseEvent) => {
const el = ev.target as Element | null;
if (!el) return;
const btn = el.closest("button.btn-primary");
if (btn instanceof HTMLButtonElement) {
console.log("delegated click on:", btn.textContent);
}
});타입 좁히기 확인
빠른 확인: 이벤트 처리기에서 요소 전용 API에 접근하는 가장 안전한 방법은 무엇입니까?
복습
복습: 이벤트 이름은 이벤트 타입을 나타냅니다. instanceof로 target/currentTarget의 타입을 좁히고, CustomEvent<T>의 detail에 데이터를 담습니다.
AI 튜터와 함께 TypeScript을(를) 배우세요 — 무료
브라우저에서 실제 코드를 작성하고 실행하며, 24/7 AI 튜터로부터 즉각적인 도움을 받고, 웹이나 앱에서 중단한 부분부터 계속 학습하세요.
- 코스
- 101
- 레슨
- 352
자주 묻는 질문
“이벤트 타입과 사용자 지정 이벤트; HTMLElement 하위 타입 좁히기” 강의는 무료인가요?
네 — “이벤트 타입과 사용자 지정 이벤트; HTMLElement 하위 타입 좁히기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 TypeScript Academy 강의 전체를 잠금 해제할 수 있습니다. TypeScript Academy 강의에는 총 3개의 강의가 포함되어 있습니다.
“이벤트 타입과 사용자 지정 이벤트; HTMLElement 하위 타입 좁히기”에서 뭘 배우나요?
올바른 타입으로 DOM 이벤트를 처리하고, CustomEvent 페이로드를 만들며, HTMLElement 하위 타입을 안전하게 좁힙니다. 브라우저에서 직접 실행하는 실습 코드로 TypeScript Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
TypeScript Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 TypeScript Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 3개 중 2번째 강의입니다.
“이벤트 타입과 사용자 지정 이벤트; HTMLElement 하위 타입 좁히기” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 TypeScript Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 TypeScript Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- lib DOM 타입과 querySelector(엄격한 null 검사)
- 이벤트 타입과 사용자 지정 이벤트; HTMLElement 하위 타입 좁히기
- FormData, URL, URLSearchParams 사용