Element.querySelector()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Возвращает первый элемент, являющийся потомком элемента, на который применено правило указанной группы селекторов.

Синтаксис

element = baseElement.querySelector(selectors);
  • element и baseElement это element объекты.
  • selectors - это группа селекторов для поиска совпадения.

Пример

Данный пример получает первый элемент style, который не имеет атрибута type или этот атрибут равен text/css, в теле (body) HTML документа:

js
var el = document.body.querySelector(
  "style[type='text/css'], style:not([type])",
);

Примечания

Возвращает null если совпадения не найдены, иначе первый найденный элемент.

Генерирует исключение SYNTAX_ERR если указанная группа селекторов не корректна.

querySelector() был представлен в WebApps API.

Строка аргументов передаваемая querySelector() должна удовлетворять синтаксису CSS. Более подробные примеры смотрите в document.querySelector.

Спецификации

Specification
DOM Standard
# ref-for-dom-parentnode-queryselectorall①

Совместимость с браузерами

BCD tables only load in the browser

Смотрите также