04 June 2025 | Last updated 20 August 2025

`querySelector` typing

typed-query-selector — improved typing for querySelector and querySelectorAll methods with type inference based on CSS selectors.

⚠️ Requires TypeScript version 4.1 or higher.

Installation

bash

npm install --save-dev typed-query-selector

ts

// typed-query-selector.d.ts
import "typed-query-selector";

Result

ts

document.querySelector("div#app"); // HTMLDivElement
document.querySelector("div#app > form#login"); // HTMLFormElement
document.querySelectorAll("span.badge"); // NodeListOf<HTMLSpanElement>
document.querySelector("button#submit"); // HTMLButtonElement