Tipos DOM de lib e querySelector (verificações estritas de nulo)
Entenda os tipos DOM de lib e selecione elementos com segurança usando querySelector e verificações estritas de nulo.
Tipos DOM de lib e querySelector (verificações estritas de nulo) é uma aula grátis de TypeScript Academy no CoddyKit. Esta é a aula 1 de 3. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de TypeScript Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de TypeScript Academy inclui 3 aulas no total.
Introdução
Objetivo: usar tipos da biblioteca DOM e querySelector com segurança. Você verificará primeiro se o resultado é null e depois usará tipos restringidos para as APIs dos elementos.
Tipos da biblioteca DOM
A biblioteca DOM do TS fornece tipos para globais do navegador, como Document, HTMLElement e Event, oferecendo IntelliSense e verificações.
// DOM types come from the lib DOM definitions
// Examples: Document, HTMLElement, HTMLInputElement, Event
const title: string = document.title; // Document API
console.log("Title:", title);Tipo de querySelector
querySelector retorna Element | null. Com strictNullChecks, você precisa tratar explicitamente o caso nulo.
const el = document.querySelector("#app");
// el: Element | null with strictNullChecks
console.log("Found?", el !== null);Guarda com retorno antecipado
Faça a guarda antecipadamente: verifique se o valor é null e retorne ou lance uma exceção. Depois da guarda, a variável não será nula nesse ramo.
function mount() {
const root = document.querySelector("#app");
if (!root) {
console.warn("No #app found");
return; // root is narrowed below only if present
}
// root: Element
root.innerHTML = "<strong>Hello TS + DOM</strong>";
}
mount();Restrição para subtipo
Restrinja ainda mais o tipo com instanceof para um subtipo específico, como HTMLInputElement, para disponibilizar APIs específicas do elemento.
function readInputValue() {
const input = document.querySelector("#name");
if (!(input instanceof HTMLInputElement)) {
return; // not an <input>
}
// input: HTMLInputElement
console.log("value=", input.value);
}
readInputValue();Cuidado com a asserção de não nulo
Evite a asserção de não nulo (!), a menos que tenha certeza absoluta. As guardas tornam a execução mais segura.
function bad() {
const root = document.querySelector("#app")!; // unsafe if #app missing
// Potential runtime error below if root is actually null
root.textContent = "unsafe";
}
// Prefer guarded version instead of non-null assertionVerificação do padrão de guarda
Verificação rápida: depois de const el = document.querySelector("#app") com verificações estritas de nulos, qual é o próximo passo mais seguro?
Recapitulação
Recapitulação: os tipos DOM fornecem suporte ao IntelliSense. querySelector retorna Element | null; faça uma guarda antes de usar o resultado. Restrinja o tipo com instanceof para usar APIs específicas do elemento.
Perguntas Frequentes
A aula “Tipos DOM de lib e querySelector (verificações estritas de nulo)” é grátis?
Sim — o texto completo de “Tipos DOM de lib e querySelector (verificações estritas de nulo)” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de TypeScript Academy, atualize para CoddyKit PRO. O curso de TypeScript Academy inclui 3 aulas no total.
O que vou aprender em “Tipos DOM de lib e querySelector (verificações estritas de nulo)”?
Entenda os tipos DOM de lib e selecione elementos com segurança usando querySelector e verificações estritas de nulo. Você pratica TypeScript Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar TypeScript Academy?
Nenhuma experiência prévia é necessária. TypeScript Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 1 de 3.
Quanto tempo leva a aula “Tipos DOM de lib e querySelector (verificações estritas de nulo)”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de TypeScript Academy?
Sim. Cada aula de TypeScript Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Tipos DOM de lib e querySelector (verificações estritas de nulo)
- Tipos de eventos, eventos personalizados; redução de subtipos de HTMLElement
- Trabalhando com FormData, URL, URLSearchParams