aboutsummaryrefslogtreecommitdiff
path: root/files/ru/tools/web_console/helpers/index.html
blob: fd55c2d723743cba6c125bb65f18ad7b0c18e364 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
---
title: Веб-Консоль Помощь
slug: Tools/Web_Console/Helpers
tags:
  - Веб-консоль
  - Веб-разработка
  - Отладка
translation_of: Tools/Web_Console/Helpers
---
<div>{{ToolsSidebar}}</div><h2 id="Команды">Команды</h2>

<p>Командная строка JavaScript, предоставляемая Веб-Консолью, предлагает несколько встроенных вспомогательных функций, которые делают определенные задачи проще.</p>

<dl>
 <dt><code>$()</code></dt>
 <dd>Ищет CSS-селектор, возвращая первый найденный элемент. Эквивалентно {{ domxref("document.querySelector()") }} или же вызывается функция $, в случае, если таковая найдена на странице.</dd>
 <dt><code>$$()</code></dt>
 <dd>Ищет CSS-селектор, возвращая перечень соответствующих ему DOM-узлов. Это упрощённый вариант, используемый вместо {{ domxref("document.querySelectorAll()") }}.</dd>
 <dd>Начиная с билда Firefox 41 этот метод больше не является упрощением для {{ domxref("document.querySelectorAll()")}}, а наоборот возвращает массив элементов.</dd>
 <dt><code>$0</code></dt>
 <dd>Ныне исследуемый элемент страницы.</dd>
 <dt><code>$_</code></dt>
 <dd><em>Появилась в Firefox 39. </em>Хранит результат последнего выражения, выполненного через командную строку. Например, если вы введёте "2+2 &lt;enter&gt;", затем "$_ &lt;enter&gt;", то консоль ответит "4".</dd>
 <dt><code>$x()</code></dt>
 <dd>Оценивает <a href="/en-US/docs/XPath">XPath</a>-выражение и возвращает массив соответствующих ему узлов.</dd>
 <dt><code>keys()</code></dt>
 <dd>Задаёт объект, возвращает перечень ключей (или имён свойств) характерных объекту. Является упрощённым вариантом <a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/keys"><code>Object.keys</code></a>.</dd>
 <dt><code>values()</code></dt>
 <dd>Задаёт объект, возвращает перечень значений объекта; является дополнением для <code>keys()</code>.</dd>
 <dt><code>clear()</code></dt>
 <dd>Очищает область вывода консоли.</dd>
 <dt><code>inspect()</code></dt>
 <dd>Задаёт объект, открывает инспектор объектов.</dd>
 <dt><code>pprint()</code></dt>
 <dd>Форматирует указанные значения до читаемого вида; полезно для дампа содержимого объектов и массивов.</dd>
 <dt><code>help()</code></dt>
 <dd>Показывает текст помощи. На самом деле (вот восхитительный пример рекурсии) он приведет вас к этой странице.</dd>
 <dt><code>cd()</code></dt>
 <dd>Переключает механизм оценки контекста JavaScript к другому айфрейму, имеющемуся на странице. Смотрите страницу <a href="/en-US/docs/Tools/Web_Console#Working_with_iframes">работа с айфреймами</a>.</dd>
 <dt><code>copy()</code></dt>
 <dd><em>Появилась в Firefox 38.</em> Копирует аргумент в клипборд. Если аргумент является строкой, то он копируется как есть. Если аргумент является DOM-узлом, то копируется его <code><a href="/en-US/docs/Web/API/Element/outerHTML">outerHTML</a></code>. Можно также использовать функцию <code><a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify">JSON.stringify</a></code>, которая также вызовет аргумент и скопирует его значение в клипборд.</dd>
 <dt><code>clearHistory()</code></dt>
 <dd><em>Появилась в Firefox 39.</em> Как и любая другая командная строка, Веб-консоль <a href="/en-US/docs/Tools/Web_Console#Command_history">помнит введённые вами команды</a>. Используйте функцию для очистки истории командной строки.</dd>
 <dt>Пожалуйста, обратитесь к тексту<a href="/en-US/docs/Web/API/console" title="/en-US/docs/Web/API/console"> API консоли</a> для получения большей информации о записи контента.</dt>
</dl>

<h2 id="Примеры">Примеры</h2>

<h3 id="Пример_Смотрим_на_содержимое_DOM-узлов">Пример: Смотрим на содержимое DOM-узлов</h3>

<p>Допустим, у вас есть DOM-узел с ID "title". На самом деле такой ID есть и у страницы, которую вы сейчас читаете, т.е. вы можете открыть Веб-консоль и попробовать прямо сейчас.</p>

<p>Давайте посмотрим на содержимое этого узла, используя <code>функции</code>:<code> $()</code> и <code>inspect()</code></p>

<pre><code>inspect($("#title"))</code></pre>

<p>Автоматически откроется окно объектного инспектора, показывающее содержимое DOM-узла, соответствующего CSS-селектору "#title", являющемуся элементом ID "title".</p>

<h3 id="Пример_Дамп_содержимого_DOM-узла">Пример: Дамп содержимого DOM-узла</h3>

<p>Это нормально и хорошо, если вы столкнулись с какими-то проблемами, используя браузер, но, давайте представим, что вы делаете удалённую отладку для пользователя и должны посмотреть на содержимое узла. В таком случае, ваш пользователь может открыть Веб-консоль, сделать дамп содержимого узла, затем скопировать текст получившегося лога, и отправить его вам по электронной почте, используя для всех своих действий функцию <code>pprint()</code></p>

<pre>pprint($("#title"))
</pre>

<p>Консоль изрыгнёт содержимое узла, так что, вы сможете взглянуть на него. Конечно, полезней использовать функцию не для DOM-узлов, но вы уже поняли идею...</p>