Esta página foi traduzida do inglês pela comunidade.Saiba mais e junte-se à comunidade MDN Web Docs.
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);
elementoeelementoBasesão objetoselement.selectoresé um grupo deselectores.
Exemplo
Neste exemplo é retornado o primeiro elementostyle que, ou não tem nenhum atributo type, ou tem o atributo type igual atext/css:
var el = document.body.querySelector( "style[type='text/css'], style:not([type])",);Notas
Retornanull se nenhum elemento for encontrado; caso contrário retorna o primeiro elemento;
Lança uma exceçãoSYNTAX_ERR se o grupo de seletores é inválido.
querySelector() foi introduzido em WebApps API.
O argumento de string doquerySelector deve seguir a sintaxe CSS. Veja exemplos concretos emdocument.querySelector
Especificação
| Specification |
|---|
| DOM # ref-for-dom-parentnode-queryselectorall① |