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() (en-US) 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

No compatibility data found for api.ParentNode.querySelector.
Check for problems with this page or contribute missing data to mdn/browser-compat-data.

Veja também