Element.querySelector()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Retorna o primeiro elemento descendente do elemento em que a função foi invocada e que corresponde aos seletores especificado.

Sintaxe

elemento = elementoBase.querySelector(seletores);
  • elemento e elementoBase são objetos element.
  • selectores é um grupo de selectores.

Exemplo

Neste exemplo é retornado o primeiro elemento style que, ou não tem nenhum atributo type, ou tem o atributo type igual a text/css:

js
var el = document.body.querySelector(
  "style[type='text/css'], style:not([type])",
);

Notas

Retorna null se nenhum elemento for encontrado; caso contrário retorna o primeiro elemento;

Lança uma exceção SYNTAX_ERR se o grupo de seletores é inválido.

querySelector() foi introduzido em WebApps API.

O argumento de string do querySelector deve seguir a sintaxe CSS. Veja exemplos concretos em document.querySelector

Especificação

Specification
DOM Standard
# ref-for-dom-parentnode-queryselectorall①

Compatibilidade com navegadores

BCD tables only load in the browser

Veja Também