0Pricing
TypeScript Academy · Aula

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 assertion

Verificaçã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

  1. Tipos DOM de lib e querySelector (verificações estritas de nulo)
  2. Tipos de eventos, eventos personalizados; redução de subtipos de HTMLElement
  3. Trabalhando com FormData, URL, URLSearchParams
← Voltar para TypeScript Academy