JavaScript свойство Node.previousSibling

Определение и применение

JavaScript свойство previousSibling объекта Node возвращает дочерний узел предшествующий указанному узлу внутри родительского элемента, или null, если указанный узел является первым дочерним узлом в родительском элементе.

Для того, чтобы возвратить дочерний узел следующий за указанным узлом внутри родительского элемента, или null, если указанный узел является последним дочерним узлом в родительском элементе, вы можете воспользоваться свойством nextSibling.

Поддержка браузерами

Спецификация: dom.spec.whatwg

Поддерживается во всех основных браузерах с 2015 года.

Показать браузеры
Совместимостьapi.Node.previousSibling
ВозможностьКомпьютерыМобильные
ChromeEdgeFirefoxOperaSafariChrome AndroidFirefox for AndroidOpera AndroidSafari on iOSSamsung BrowserWebView AndroidWebView on iOS
previousSibling✓1✓12✓1✓≤12.1✓1✓18✓4✓≤12.1✓1✓1.0✓4.4✓1

поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31

JavaScript синтаксис

JavaScript
const previousNode = node.previousSibling;

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

DOM Standard.

Пример использования

Все узлы перед выделенным пунктом

Нажмите ▶, затем Click me: под кнопкой появятся имена всех узлов перед выделенным пунктом — #text и LI попеременно. Замените previousSibling на previousElementSibling в main.js и сравните.

index.html
HTML
<button data-migration-click-0="">Click me</button>
<ul>
  <li>1</li>
  <li>2</li>
  <li>3</li>
  <li>4</li>
  <li class="active">5</li>
</ul>
<p id="result"></p>
main.js
JavaScript
function myFunc() {
    let elem = document.querySelector('.active').previousSibling,
        result = document.getElementById('result')

    while (elem) {
        result.innerHTML += elem.nodeName + '<br>'
        elem = elem.previousSibling
    }
}

// Обработчики кнопок перенесены из HTML для запуска с CSP без inline-скриптов.
document.querySelector('[data-migration-click-0]').addEventListener('click', function () {
    myFunc()
})
document.querySelector('[data-migration-click-0]').removeAttribute('data-migration-click-0')

В этом примере с использованием метода addEventListener() при нажатии на кнопку (HTML элемент <button>) вызываем функцию, которая:

  • Инициализирует две переменные, первая содержит ссылку на элемент, который является дочерним узлом предшествующим элементу с классом active внутри родительского элемента, а вторая ссылку на элемент в который мы будем выводить результат.
  • С помощью цикла while и свойства nodeName мы добавляем в элемент <p> строковое значение, определяющее имя текущего узла (узел, предшествующий элементу, содержавшемуся в переменной elem), и тег переноса строки (<br>). Мы изменяем значение переменной elem на узел, который мы добавили в элемент <p>. Цикл while будет срабатывать до тех пор пока не вернется значение null - указанный узел будет первым дочерним узлом в родительском элементе. В результате чего это позволит нам вывести все узлы предшествующие элементу с классом active:
    • Поочерёдно значения #text (текстовый узел - пробел между элементами) и LI (узел элемента - <li>): по четыре раза, начиная с #text. Обратите внимание, что имена элементов возвращаются в верхнем регистре (в XHTML и других XML-документах исходный регистр сохраняется).
    • #text - (текстовый узел - пробел перед первым элементом <li>).