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 julho de 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);

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

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

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

Specification
DOM # ref-for-dom-parentnode-queryselector1

This page was last modified on 27 de abr. de 2025 by MDN contributors.