Взаимодействие с DOM с помощью консоли

Консоль — отличный способ взаимодействия с веб-страницей в браузере. В средствах разработчика вы обычно взаимодействуете с DOM, используя инструмент "Проверка " для выбора элементов и инструмент "Элементы " для изменения DOM, например для добавления или изменения атрибутов или стилей элемента.

Средство "Консоль" также можно использовать для взаимодействия с DOM с помощью кода JavaScript. Например, можно находить элементы в дереве DOM и управлять ими с помощью API DOM.

Дополнительные сведения о средстве "Проверка " см. в разделе "Анализ страниц" с помощью средства "Проверка". Дополнительные сведения об инструменте Elements см. в статье Проверка, редактирование и отладка HTML и CSS с помощью средства Elements.

Поиск элемента в дереве DOM

Чтобы найти элемент в дереве DOM с помощью средства "Консоль ":

  1. Перейдите на веб-страницу, которую нужно проверить. Например, откройте страницу демонстрационной версии взаимодействия с DOM средства DevTools Console в новой вкладке или окне.

  2. Нажмите клавиши CTRL+SHIFT+J (Windows, Linux) или COMMAND+OPTION+J (macOS). Средство "Консоль" открывается в средствах разработчика рядом с веб-страницей.

  3. Введите или вставьте следующий код в консоль и нажмите клавишу ВВОД.

    document.querySelector('main');
    

    Элемент <main> из дерева DOM отображается в консоли:

    Консоль средств разработчика, отображающая выражение document.querySelector и результирующий основной элемент

  4. В Консоли наведите курсор на полученный элемент HTML <main> или нажмите Shift+Tab. На отрисованной веб-странице средства разработчика выделяют соответствующий <main> элемент:

    Основной элемент, выделенный на отрисованной веб-странице

Изменение DOM веб-страницы

Вы можете внести изменения в дерево DOM веб-страницы с помощью средства "Консоль ". В этом примере вы устанавливаете значение атрибута элемента DOM с помощью консоли, чтобы повлиять на стиль элемента: вы добавляете серый фон к <h1> заголовку страницы.

  1. Перейдите на веб-страницу, которую вы хотите изменить. Например, откройте страницу демонстрационной версии взаимодействия с DOM средства DevTools Console в новой вкладке или окне.

  2. Нажмите клавиши CTRL+SHIFT+J (Windows, Linux) или COMMAND+OPTION+J (macOS). Средство "Консоль" открывается в средствах разработчика рядом с веб-страницей.

  3. Вставьте в консоль следующий код:

    document.querySelector("h1").style.backgroundColor = "lightgrey";
    

    За заголовком страницы появляется серый фон:

    Средство

Получение ссылки на элемент

На сложной веб-странице бывает сложно найти нужный элемент для изменения. Но вы можете использовать средство проверки , которое поможет вам. Предположим, вы хотите изменить текст первой ссылки в элементе Section 1 отображаемой страницы:

Ссылка, которую вы хотите изменить на странице

Чтобы получить ссылку на элемент ссылки, который требуется изменить:

  1. Перейдите на веб-страницу, которую нужно проверить. Например, откройте страницу демонстрационной версии взаимодействия с DOM средства DevTools Console в новой вкладке или окне.

  2. Нажмите клавиши CTRL+SHIFT+J (Windows, Linux) или COMMAND+OPTION+J (macOS). Средство "Консоль" открывается в средствах разработчика рядом с веб-страницей.

  3. Щелкните средство Проверить (значок средства проверки), а затем на отрисованной веб-странице наведите курсор на ссылку, например на ссылку 1:

    При наведении курсора на ссылку при использовании средства

  4. Щелкните ссылку, на которую наведен курсор на отрисованной веб-странице. Средства разработчика открывают инструмент "Элементы " с выбранным соответствующим элементом:

    Инструмент

  5. ... Нажмите кнопку рядом с элементом в дереве DOM и выберите команду Копировать>JS-путь:

    Пункт меню Копировать путь JS в инструменте Элементы

    Вот путь JS, который вы скопировали:

    document.querySelector("body > main > section:nth-child(1) > ul > li:nth-child(1) > a")
    

    Указанный выше путь представляет собой селектор CSS, указывающий на элемент ссылки, выбранный с помощью средства "Проверка ".

  6. В консоли вставьте скопированный путь JavaScript, но пока не нажимайте клавишу ВВОД.

  7. Измените текст ссылки на Updated link. Для этого добавьте .textContent = "Updated link" к ранее вставленному пути JavaScript:

    Средство

Чтобы изменить дерево DOM в консоли, используйте любые API DOM. Для большего удобства консоль поставляется с несколькими вспомогательными служебными методами.

Полезные служебные функции консоли

В средстве "Консоль " доступно множество методов повышения удобства и сочетаний клавиш в виде служебных функций. Некоторые из этих служебных функций очень полезны для взаимодействия с деревом DOM веб-страницы и описаны ниже. Дополнительные сведения см. в разделе Вспомогательные функции и селекторы средства "Консоль".

Получение элементов с помощью функций и сочетаний клавиш $

Персонаж $ имеет особое значение в средстве «Консоль »:

  • Функции $() and $$() — это укороченные document.querySelector() версии функций and document.querySelectorAll() .

  • $0, , , $3$2и $4 — это ярлыки для элементов, $1которые вы недавно выделили в средстве "Элементы". $0 всегда является самым последним выбранным элементом. Так, в предыдущем примере Получить ссылку на элемент, выбрав элемент с помощью средства Проверка , можно изменить его текст, чтобы $0.textContent = "Updated link" получить тот же эффект.

  • $x() позволяет выбирать элементы DOM с помощью XPath.

В этом примере функция служебной $$() программы используется для перечисления всех ссылок на веб-странице. Затем вы используете эту функцию вместе с методом массива filter() , чтобы избавиться от ссылок, которые не начинаются ( https например, якорных ссылок на данной веб-странице), чтобы отфильтровать список и включить в него только внешние ссылки.

  1. Перейдите на веб-страницу, с которой вы хотите получить ссылки. Например, откройте страницу демонстрационной версии взаимодействия с DOM средства DevTools Console в новой вкладке или окне.

  2. Нажмите клавиши CTRL+SHIFT+J (Windows, Linux) или COMMAND+OPTION+J (macOS). Средство "Консоль" открывается в средствах разработчика рядом с веб-страницей.

  3. Чтобы получить список всех ссылок на странице, введите следующий код в консоли и нажмите клавишу ВВОД:

    $$('a');
    

    Результат функции $$('a') в консоли, которая является массивом элементов

    $$('a') является сокращением от document.querySelectorAll('a').

  4. Разверните список ссылок, зарегистрированных в консоли, а затем разверните первый объект ссылки. Отображаются свойства ссылки:

    При развертывании первого элемента массива отображаются его свойства.

  5. Чтобы уменьшить объем сведений, возвращаемых $$() функцией, используйте map() метод массива. Метод map() работает, поскольку $$() функция возвращает массив.

    $$('a').map(a => {
      return {url: a.getAttribute("href"), text: a.innerText}
    });
    

    Приведенный выше код возвращает массив всех ссылок, где каждый объект link сопоставлен с объектами JavaScript со url свойствами and text .

  6. Разверните несколько возвращенных объектов связи, чтобы увидеть их свойства:

    Список ссылок на странице с текстом каждой ссылки и атрибутом href

  7. Чтобы отображать только внешние ссылки, удалите filter() ссылки, которые не начинаются с https:

    $$('a').map(a => {
       return {url: a.getAttribute("href"), text: a.innerText}
    }).filter(a => {
       return a.url.startsWith("https");
    });
    

    Список внешних ссылок на странице

Отображение элементов DOM в таблице

В предыдущем примере вы отображали список элементов со страницы в консоли. Элементы отображаются в виде массива JavaScript. Чтобы упростить использование списка элементов в консоли, вместо этого их можно отобразить в сортируемой таблице, используя console.table() служебную функцию:

  1. Перейдите на веб-страницу, которую нужно проверить. Например, откройте страницу демонстрационной версии взаимодействия с DOM средства DevTools Console в новой вкладке или окне.

  2. Нажмите клавиши CTRL+SHIFT+J (Windows, Linux) или COMMAND+OPTION+J (macOS). Средство "Консоль" открывается в средствах разработчика рядом с веб-страницей.

  3. Вставьте в консоль следующий код и нажмите клавишу ВВОД:

    console.table($$('img'), ['src','alt'])
    

    Список <img> элементов на веб-странице отображается в консоли в формате таблицы, при этом каждое изображение src и alt атрибуты представляют собой столбцы:

    Средство

Получение всех заголовков страниц и URL-адресов привязки

В этом примере вы получаете все заголовки веб-страницы, у которых есть атрибут, id и создаете URL-адрес, указывающий на каждый заголовок.

  1. Перейдите на веб-страницу, которую нужно проверить. Например, откройте страницу демонстрационной версии взаимодействия с DOM средства DevTools Console в новой вкладке или окне.

  2. Нажмите клавиши CTRL+SHIFT+J (Windows, Linux) или COMMAND+OPTION+J (macOS). Средство "Консоль" открывается в средствах разработчика рядом с веб-страницей.

  3. Скопируйте и вставьте следующий код в консоль, затем нажмите клавишу ВВОД:

    let headings = $$('main [id]').filter(el => {
      return el.nodeName.startsWith('H');
    }).map(el => {
      return `${el.innerText}: ${document.location.href}#${el.id}\n`;
    });
    console.log(headings.join("\n"));
    

    Результат будет содержать текст с содержимым для заголовка каждого раздела, за которым следует полный URL-адрес заголовка раздела:

    Средство

Копирование сведений с консоли

В предыдущих примерах были созданы списки элементов и строк сведений. Может быть полезно скопировать сгенерированные сведения из консоли и вставить их в другое место.

Чтобы скопировать возвращаемое значение из выражения, запущенного в консоли, используйте служебную copy() функцию:

  1. Перейдите на веб-страницу, из которой вы хотите извлечь некоторые сведения. Например, откройте страницу демонстрационной версии взаимодействия с DOM средства DevTools Console в новой вкладке или окне.

  2. Нажмите клавиши CTRL+SHIFT+J (Windows, Linux) или COMMAND+OPTION+J (macOS). Средство "Консоль" открывается в средствах разработчика рядом с веб-страницей.

  3. Чтобы скопировать список всех URL-адресов изображений на странице, введите следующий код в консоли и нажмите клавишу ВВОД:

    copy($$('img').map(img => img.src).join("\n"));
    

    Служебная copy() функция может принимать любой аргумент, который можно преобразовать в строку, и копировать его в буфер обмена. В этом примере аргументом является строка, содержащая все URL-адреса изображений на странице, разделенные новой строкой.

  4. Откройте текстовый редактор, например Visual Studio Code, а затем вставьте скопированные URL-адреса изображений в редактор:

    Список URL изображений в текстовом редакторе

Очистка консоли

При выполнении кода в консоли часто возникает множество входных операторов и результатов вывода, которые больше не нужно отображать. Очистить консоль можно с помощью служебной clear() функции.

Вывод списка прослушивателей событий, назначенных элементу

Чтобы получить список всех прослушивателей событий, назначенных элементу, используйте служебную getEventListeners() функцию:

  1. Перейдите на веб-страницу, которую нужно проверить. Например, откройте страницу демонстрационной версии взаимодействия с DOM средства DevTools Console в новой вкладке или окне.

  2. Нажмите клавиши CTRL+SHIFT+J (Windows, Linux) или COMMAND+OPTION+J (macOS). Средство "Консоль" открывается в средствах разработчика рядом с веб-страницей.

  3. Щелкните средство "Проверка ", а затем на отрисованной веб-странице щелкните одно из изображений, чтобы выбрать его. Откроется средство "Элементы ", а выбранный элемент изображения будет выделен в дереве DOM:

    Средство

  4. Откройте средство "Консоль ", введите следующий код и нажмите клавишу ВВОД:

    getEventListeners($0);
    

    В приведенном выше фрагменте $0 кода — это ярлык для выделенного <img> в данный момент элемента в средстве "Элементы ". Служебная getEventListeners() функция возвращает объект, содержащий все прослушиватели событий, назначенные образу.

  5. Разверните объект, а затем разверните единственный прослушиватель событий в списке, чтобы просмотреть свойства прослушивателя. Свойство listener показывает имя функции, которая вызывается при срабатывании события (в этом примере): showImage

    Развернутый объект, отображающий свойство прослушивателя

Отслеживание событий, запущенных на странице

Веб-сайты, использующие JavaScript, часто реагируют на пользовательские события, происходящие в браузере. Уследить за всеми событиями, запускаемыми браузером, может быть сложно. Служебная monitorEvents() функция позволяет отслеживать события, которые запускаются на веб-странице.

Отслеживание всех событий элемента

Чтобы запустить мониторинг событий, выполните следующие действия.

  1. Перейдите на веб-страницу, которую необходимо отслеживать. Например, откройте страницу демонстрационной версии взаимодействия с DOM средства DevTools Console в новой вкладке или окне.

  2. Нажмите клавиши CTRL+SHIFT+J (Windows, Linux) или COMMAND+OPTION+J (macOS). Средство "Консоль" открывается в средствах разработчика рядом с веб-страницей.

  3. Чтобы начать отслеживать события, запущенные на элементе, например, на одном из <img> элементов, введите в Console следующий код и нажмите клавишу ВВОД:

    monitorEvents(document.querySelector('img'));
    

    Приведенный выше код отслеживает все события, которые запускаются на первом <img> элементе страницы.

  4. На отрисованной веб-странице наведите курсор на изображение и переместите мышь или клавишу TAB на изображение с помощью клавиатуры. Такие события, как mouseover, mousemove, и focus регистрируются на консоли:

    Средство

При отслеживании событий вы получаете журналы в консоли каждый раз, когда событие запускается браузером. Это может привести к сильному шуму в консоли. Вы также можете отслеживать определенные события, связанные с элементом.

Отслеживание определенных событий в элементе

Чтобы начать отслеживать определенные события в элементе:

  1. Перейдите на веб-страницу, которую необходимо отслеживать. Например, откройте страницу демонстрационной версии взаимодействия с DOM средства DevTools Console в новой вкладке или окне.

  2. Нажмите клавиши CTRL+SHIFT+J (Windows, Linux) или COMMAND+OPTION+J (macOS). Средство "Консоль" открывается в средствах разработчика рядом с веб-страницей.

  3. Чтобы начать отслеживать только события mousedown, mouseup и click, которые запускаются для первого <img> элемента на странице, введите следующий код в консоли и нажмите клавишу ВВОД:

    monitorEvents(document.querySelector('img'), ['mousedown', 'mouseup', 'click']);
    
  4. На отрисованной веб-странице щелкните первое изображение. mousedown, mouseupи click события регистрируются на консоли:

    Средство

Отслеживание событий в окне

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

  1. Вставьте в консоль следующий код:

    monitorEvents(window, ['resize', 'scroll']);
    
  2. Прокрутите страницу и измените размер окна браузера. Консоль регистрирует триггерные события:

    Средство

Остановка мониторинга событий

При отслеживании событий в DOM на консоли может быть шумно. Чтобы остановить мониторинг событий, используйте служебную unmonitorEvents() функцию:

unmonitorEvents(document.querySelector('img'));
unmonitorEvents(document.querySelector('img'), ['mousedown', 'mouseup', 'click']);
unmonitorEvents(window, ['resize', 'scroll']);

Сохранение сценариев взаимодействия DOM в виде фрагментов

Если вы вводите один и тот же код взаимодействия DOM несколько раз в консоли, вместо этого рассмотрите возможность сохранения кода в виде фрагмента, а затем запуска фрагмента. Фрагменты сохраняются в средстве "Источники ", и вы можете запускать их оттуда или из меню команд. Дополнительные сведения см. в статье Запуск фрагментов JavaScript на любой веб-странице.

См. также