Syntax

querySelector(selectors)

Parameters

selectors

A string containing one or more CSS selectors separated by commas.

Return value

An Element object representing the first element in the document that matches the specified set of CSS selectors, or null is returned if there are no matches.

Examples

Basic example

In this basic example, the first element in the DocumentFragment with the class myclass is returned:

const el = documentfragment.querySelector(".myclass");

CSS syntax and the method's argument

The string argument pass to querySelector must follow the CSS syntax. To match ID or selectors that do not follow the CSS syntax (by using semicolon or space inappropriately for example), it's mandatory to escape the wrong character with a double back slash:

<div id="foo\bar"></div>
<div id="foo:bar"></div>

document.querySelector("#foo\bar"); // Does not match anything
document.querySelector("#foo\\\\bar"); // Match the first div
document.querySelector("#foo:bar"); // Does not match anything
document.querySelector("#foo\\:bar"); // Match the second div

Specifications

Browser compatibility

See also

• The DocumentFragment interface it belongs to.