.query()

Element? ParentNode.query(String relativeSelectors)

Tags:

Traversal

Warning! Current browsers do not yet support .query(), please use a polyfill until they do.

Finds the first element matching the supplied relative selectors.

node.query(relativeSelector);

Returns the first element that is a descedent of node that matches relativeSelectors.

To query the entire document, simply do:

document.query(relativeSelector);

Examples

HTML:

<ul class="list-one">
    <li class="one">Item 1</li>
    <li>
        <ul class="list-two">
            <li class="two">Item 2</li>
            <li class="three">Item 3</li>
        </ul>
    </li>
</ul>

Example 1

JavaScript:

let result = document.query(".two");

Result is the <li class="two">Item 2</li> element.

Example 2

JavaScript:

let ul = document.query("ul");
let result = ul.query("> *");

Result is the <li class="one">Item 1</li> element.