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 | null

querySelectorAll คืน 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)
             └─ HTMLDivElement

Element ไม่มี .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 หรือ instanceof
  • addEventListener("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 + เช็ค null
  • Element < HTMLElement < HTMLInputElement/HTMLButtonElement/… — narrow เพื่อเข้าถึง property เฉพาะ
  • addEventListener("click", ...) → MouseEvent; "keydown" → KeyboardEvent; "input" → Event (ต้อง cast target)
  • event.target: EventTarget | null — as HTMLInputElement หรือ instanceof guard
  • helper requireElement<T>(selector) — throw ครั้งเดียว, ไม่ ! กระจาย

บทถัดไปว่าด้วยข้อมูลจากภายนอกและ runtime validation — JSON.parse คืน any, type ≠ runtime guarantee, และ zod