TypeScript ทำงานกับ DOM และ event
บทนี้เป็นฝั่ง เบราว์เซอร์ — โปรเจกต์ Node ข้ามได้
เปิด lib.dom
// tsconfig.json
{
"compilerOptions": {
"lib": ["ES2022", "DOM", "DOM.Iterable"]
}
}"DOM" = type ของ document, window, HTMLElement, Event ฯลฯ (Vite/Next.js template เปิดให้แล้ว) โปรเจกต์ Node ล้วนไม่ควรเปิด (จะได้ document ที่ไม่มีจริง)
querySelector — generic
// คืน Element | null — กว้างไป
const el = document.querySelector(".btn");
el.addEventListener(...); // Error: el อาจ null + Element ไม่มี method บางตัว
// ระบุ element type ด้วย generic
const btn = document.querySelector<HTMLButtonElement>(".btn");
// btn: HTMLButtonElement | null
if (btn) {
btn.disabled = true; // property ของ button
btn.addEventListener("click", () => {});
}
const input = document.querySelector<HTMLInputElement>("#email");
if (input) {
input.value; // string
}
// getElementById — คืน HTMLElement | null (ไม่มี generic)
const app = document.getElementById("app"); // HTMLElement | nullquerySelectorAll คืน NodeListOf<T> (ต้อง "DOM.Iterable" เพื่อ for...of):
const items = document.querySelectorAll<HTMLLIElement>("li.item");
for (const item of items) {
item.textContent;
}
items.forEach((item) => { });Element type hierarchy
EventTarget
└─ Node
└─ Element
└─ HTMLElement
├─ HTMLButtonElement (.disabled, .type)
├─ HTMLInputElement (.value, .checked)
├─ HTMLFormElement (.elements, .submit())
├─ HTMLAnchorElement (.href)
├─ HTMLImageElement (.src, .naturalWidth)
└─ HTMLDivElementElement ไม่มี .style, .dataset, .click() — ต้อง narrow เป็น HTMLElement ขึ้นไป
event listener — event type ตามชนิด
const btn = document.querySelector<HTMLButtonElement>(".btn")!;
btn.addEventListener("click", (event) => {
// event: MouseEvent ← infer จาก "click"
event.clientX;
event.preventDefault();
});
document.addEventListener("keydown", (event) => {
// event: KeyboardEvent
if (event.key === "Escape") { }
if (event.ctrlKey && event.key === "s") { }
});
const input = document.querySelector<HTMLInputElement>("#name")!;
input.addEventListener("input", (event) => {
// event: Event (input event ไม่มี type เฉพาะ)
const target = event.target as HTMLInputElement;
console.log(target.value);
});event.target — ต้อง cast
event.target เป็น EventTarget | null (กว้างมาก) — cast เป็น element ที่คาด:
form.addEventListener("submit", (event) => {
event.preventDefault();
// ❌ event.target.elements — Error
const form = event.target as HTMLFormElement;
const formData = new FormData(form);
const email = formData.get("email"); // FormDataEntryValue | null
// event.currentTarget เป็น type ที่แคบกว่า (element ที่ listener ผูก) — บางที infer ได้
});ทางที่ปลอดภัยกว่า cast: type guard
function isInput(el: EventTarget | null): el is HTMLInputElement {
return el instanceof HTMLInputElement;
}
input.addEventListener("input", (e) => {
if (isInput(e.target)) {
e.target.value; // narrow แล้ว
}
});typed event handler (reusable)
type ClickHandler = (event: MouseEvent) => void;
const handleClick: ClickHandler = (event) => {
console.log(event.clientX, event.clientY);
};
btn.addEventListener("click", handleClick);
btn.removeEventListener("click", handleClick); // ต้องเป็น reference เดียวกันcustom event
interface UserLoginDetail {
userId: string;
timestamp: number;
}
const event = new CustomEvent<UserLoginDetail>("user:login", {
detail: { userId: "u1", timestamp: Date.now() },
});
document.dispatchEvent(event);
document.addEventListener("user:login", (event) => {
// event: Event ← ไม่ infer CustomEvent อัตโนมัติ
const e = event as CustomEvent<UserLoginDetail>;
console.log(e.detail.userId);
});dataset และ attributes
const el = document.querySelector<HTMLElement>("[data-id]")!;
el.dataset.id; // string | undefined (data-id)
el.dataset.userName; // string | undefined (data-user-name → camelCase)
el.getAttribute("data-id"); // string | null
el.classList.add("active");
el.classList.toggle("hidden");
el.style.color = "red";null check pattern
// ❌ ! ทุกที่
const btn = document.querySelector(".btn")! as HTMLButtonElement;
// ✅ helper ที่ throw ครั้งเดียว
function requireElement<T extends Element>(selector: string): T {
const el = document.querySelector<T>(selector);
if (!el) throw new Error(`ไม่พบ element: ${selector}`);
return el;
}
const btn = requireElement<HTMLButtonElement>(".btn"); // HTMLButtonElement (ไม่ null)เรื่องที่คนมักพลาด
querySelectorไม่ใส่ generic — ได้Element | nullที่ไม่มี.value,.disabledฯลฯ- ลืมเช็ค null —
querySelectorคืน| nullเสมอ;!หรือ narrow event.targetโดยไม่ cast — เป็นEventTarget;as HTMLInputElementหรือinstanceofaddEventListener("keyup", ...)แล้วคาดว่า event เป็น KeyboardEvent — บางชนิด infer, บางชนิดไม่ ("input"→Event)removeEventListenerด้วย arrow function inline — ไม่มี reference; เก็บใน const- เปิด
"DOM"lib ในโปรเจกต์ Node —document,fetch,localStorageที่ไม่มีจริง (Node มีfetchตั้งแต่ 18 แต่ผ่าน@types/node) el.dataset.fooคาดว่าเป็น string — เป็นstring | undefined
สรุป
- เปิด
"lib": ["ES2022", "DOM", "DOM.Iterable"](frontend เท่านั้น) document.querySelector<HTMLButtonElement>(...)→T | null— ใส่ generic + เช็ค nullElement<HTMLElement<HTMLInputElement/HTMLButtonElement/… — narrow เพื่อเข้าถึง property เฉพาะaddEventListener("click", ...)→MouseEvent;"keydown"→KeyboardEvent;"input"→Event(ต้อง cast target)event.target: EventTarget | null—as HTMLInputElementหรือinstanceofguard- helper
requireElement<T>(selector)— throw ครั้งเดียว, ไม่!กระจาย
บทถัดไปว่าด้วยข้อมูลจากภายนอกและ runtime validation — JSON.parse คืน any, type ≠ runtime guarantee, และ zod