ExpertiDict

JavaScript · Essencial · Inglês · Técnico

querySelector

/ˈkwɪɹi sɪˈlɛktɚ/substantivo

Método do document que recebe um seletor CSS e devolve o primeiro elemento correspondente, ou null se nada combinar. Para pegar todos os elementos, existe querySelectorAll.

Onde usar

Usado para pegar um botão ou campo antes de ler ou alterar. Um erro comum nos logs é 'Cannot read properties of null', quando o seletor não achou nada.

Em código

const btn = document.querySelector('#ok');
if (btn) {
  btn.disabled = true;
}
const lis = document.querySelectorAll('li');
console.log(lis.length);

Exemplos

The querySelector returned null because the id was misspelled.

O querySelector devolveu null porque o id estava escrito errado.

Use querySelectorAll if you need every button on the page.

Use querySelectorAll se precisar de todos os botões da página.

Cuidado

Esperar uma lista: querySelector devolve só um elemento, e para vários se usa querySelectorAll.

Veja também

Todos os termos de JavaScript