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

No compatibility data found. Please contribute data for "api.ParentNode.querySelector" (depth: 1) to the MDN compatibility data repository.

Veja também