ParentNode.querySelector()

Rascunho
Esta página está incompleta.

O ParentNode mixin define o querySelector() método como retornar um Element representando o primeiro elemento que corresponde ao grupo especificado de seletores que são descendentes do objeto no qual o método foi chamado.

Se você precisar de todos os elementos correspondentes à lista de seletores, usequerySelectorAll() instead.

Sintaxe

element = parentNode.querySelector(selectors);

Parâmetros

selectors
Um DOMString contendo um ou mais seletores para comparar. Essa sequência deve ser um válido lista de seletores compostos suportado pelo navegador; se não for, um SyntaxError exceção é lançada. Veja Localizando elementos DOM usando seletores para obter mais informações sobre o uso de seletores para identificar elementos. Vários seletores podem ser especificados, separando-os usando vírgulas.

Nota: Os caracteres que não fazem parte da sintaxe CSS padrão devem ser escapados usando um caractere de barra invertida. Como o JavaScript também usa escape de backspace, deve-se tomar cuidado especial ao escrever literais de string usando esses caracteres. Veja Escaping special characters Para maiores informações.

Valor de retorno

O primeiro Element que corresponda a pelo menos um dos seletores ou null se esse elemento não for encontrado.

Nota: Se o especificado selectors inclua um CSS pseudo-elemento, o valor retornado é sempre null.

Exceções

SyntaxError
A sintaxe do especificado selectors string não é válida.

Especificações

Especificação Status Comentário
DOM
The definition of 'ParentNode.querySelector()' in that specification.
Padrão em tempo real Padrão de vida
Selectors API Level 2
The definition of 'ParentNode.querySelector()' in that specification.
Obsoleto Sem alteração
DOM4
The definition of 'ParentNode.querySelector()' in that specification.
Obsoleto Definição inicial
Selectors API Level 1
The definition of 'document.querySelector()' in that specification.
Obsoleto Definição original

Compatibilidade do navegador

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
querySelectorChrome Full support 1Edge Full support 12Firefox Full support 3.5IE Full support 9
Notes
Full support 9
Notes
Notes Internet Explorer 8 only supported CSS2 selectors.
Opera Full support 10Safari Full support 4WebView Android Full support ≤37Chrome Android Full support 18Firefox Android Full support YesOpera Android Full support 10.1Safari iOS Full support 3.2Samsung Internet Android Full support 1.0

Legend

Full support  
Full support
See implementation notes.
See implementation notes.

Veja também