From 074785cea106179cb3305637055ab0a009ca74f2 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:42:52 -0500 Subject: initial commit --- files/ru/web/api/console/assert/index.html | 112 +++++++++++ files/ru/web/api/console/clear/index.html | 53 +++++ files/ru/web/api/console/count/index.html | 170 ++++++++++++++++ files/ru/web/api/console/countreset/index.html | 130 ++++++++++++ files/ru/web/api/console/debug/index.html | 56 ++++++ files/ru/web/api/console/dir/index.html | 91 +++++++++ files/ru/web/api/console/dirxml/index.html | 57 ++++++ files/ru/web/api/console/error/index.html | 170 ++++++++++++++++ files/ru/web/api/console/group/index.html | 147 ++++++++++++++ files/ru/web/api/console/index.html | 261 +++++++++++++++++++++++++ files/ru/web/api/console/info/index.html | 157 +++++++++++++++ files/ru/web/api/console/log/index.html | 92 +++++++++ files/ru/web/api/console/profile/index.html | 43 ++++ files/ru/web/api/console/table/index.html | 205 +++++++++++++++++++ files/ru/web/api/console/time/index.html | 62 ++++++ files/ru/web/api/console/timeend/index.html | 76 +++++++ files/ru/web/api/console/timelog/index.html | 92 +++++++++ files/ru/web/api/console/timestamp/index.html | 39 ++++ files/ru/web/api/console/trace/index.html | 66 +++++++ files/ru/web/api/console/warn/index.html | 67 +++++++ 20 files changed, 2146 insertions(+) create mode 100644 files/ru/web/api/console/assert/index.html create mode 100644 files/ru/web/api/console/clear/index.html create mode 100644 files/ru/web/api/console/count/index.html create mode 100644 files/ru/web/api/console/countreset/index.html create mode 100644 files/ru/web/api/console/debug/index.html create mode 100644 files/ru/web/api/console/dir/index.html create mode 100644 files/ru/web/api/console/dirxml/index.html create mode 100644 files/ru/web/api/console/error/index.html create mode 100644 files/ru/web/api/console/group/index.html create mode 100644 files/ru/web/api/console/index.html create mode 100644 files/ru/web/api/console/info/index.html create mode 100644 files/ru/web/api/console/log/index.html create mode 100644 files/ru/web/api/console/profile/index.html create mode 100644 files/ru/web/api/console/table/index.html create mode 100644 files/ru/web/api/console/time/index.html create mode 100644 files/ru/web/api/console/timeend/index.html create mode 100644 files/ru/web/api/console/timelog/index.html create mode 100644 files/ru/web/api/console/timestamp/index.html create mode 100644 files/ru/web/api/console/trace/index.html create mode 100644 files/ru/web/api/console/warn/index.html (limited to 'files/ru/web/api/console') diff --git a/files/ru/web/api/console/assert/index.html b/files/ru/web/api/console/assert/index.html new file mode 100644 index 0000000000..1ca29fa5f7 --- /dev/null +++ b/files/ru/web/api/console/assert/index.html @@ -0,0 +1,112 @@ +--- +title: console.assert() +slug: Web/API/Console/assert +tags: + - API + - Debugging + - console + - web console + - Отладка +translation_of: Web/API/console/assert +--- +
{{APIRef("Console API")}}{{Non-standard_Header}}
+ +

Метод console.assert() записывает сообщение об ошибке в консоль в случае, если утверждение ложно. Если утверждение истинно - ничего не происходит.

+ +

{{AvailableInWorkers}}

+ +
+

Важно: Реализация метода console.assert() в браузере и Node.js отличается.

+ +

В браузере, вызов console.assert() с ложным утверждением вызовет печать ошибки в консоль без прерывания текущего выполнения скрипта, а в Node.js в аналогичном случае будет выброшена ошибка - AssertionError.

+
+ +

Синтаксис

+ +
console.assert(assertion, obj1 [, obj2, ..., objN]);
+console.assert(assertion, msg [, subst1, ..., substN]); // си-подобное форматирование строк
+
+ +

Параметры

+ +
+
assertion
+
Любое логическое утверждение. Если утверждение ложно - сообщение об ошибке записывается в консоль.
+
obj1 ... objN
+
Список JavaScript объектов для вывода. Строковое представление этих объектов добавляются в порядке, указанном в списке, и выводятся.
+
msg
+
Строка JavaScript, содержащая ноль или более строк подстановки.
+
subst1 ... substN
+
Объекты JavaScript, которыми нужно заменить строки подстановки в рамках параметра msg. Этот параметр даёт дополнительный контроль над форматированием вывода.
+
+ +

Примеры

+ +

В следующем примере кода демонстрируется использование объекта JavaScript после утверждения:

+ +
const errorMsg = '# не чётное число';
+for (let number = 2; number <= 5; number += 1) {
+    console.log('# равно ' + number);
+    console.assert(number % 2 === 0, {number: number, errorMsg: errorMsg});
+    // или, при использовании {{jsxref("Operators/Object_initializer", "сокращения имён свойств в ECMAScript 2015", "Новая_нотация_в_ECMAScript_2015")}}:
+    // console.assert(number % 2 === 0, {number, errorMsg});
+}
+// output:
+// # равно 2
+// # равно 3
+// Assertion failed: {number: 3, errorMsg: "# не чётное число"}
+// # равно 4
+// # равно 5
+// Assertion failed: {number: 5, errorMsg: "# не чётное число"}
+
+ +

Обратите внимание, что хотя строка, содержащая строку подстановки, работает как параметр для console.log в Node и многих, если не большинстве, браузерах...

+ +
console.log('слово %s', 'foo');
+// output: слово foo
+
+ +

...использование такой строки в настоящее время не работает в качестве параметра для console.assert во всех браузерах:

+ +
console.assert(false, 'слово %s', 'foo');
+// корректный вывод в Node.js и некоторых браузерах
+//     (например Firefox v60.0.2):
+// Assertion failed: слово foo
+// некорректный вывод в некоторых браузерах
+//     (например Chrome v67.0.3396.87):
+// Assertion failed: слово %s foo
+ +

Смотрите также Вывод текста в консоль в документации {{domxref("console")}} для более детальной информации.

+ +

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

+ + + + + + + + + + + + + + + + +
СпецификацииСтатусКомментарий
{{SpecName("Console API", "#consoleassertexpression-object", "console.assert()")}}{{Spec2("Console API")}}Первоначальное определение
+ +

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

+ + + +

{{Compat("api.Console.assert")}}

+ +

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

+ + diff --git a/files/ru/web/api/console/clear/index.html b/files/ru/web/api/console/clear/index.html new file mode 100644 index 0000000000..b86317d69a --- /dev/null +++ b/files/ru/web/api/console/clear/index.html @@ -0,0 +1,53 @@ +--- +title: clear() +slug: Web/API/Console/clear +tags: + - API + - консоль +translation_of: Web/API/Console/clear +--- +
{{APIRef("Console API")}}{{Non-standard_header}}
+ +

Очищает консоль.

+ +

Содержимое консоли заменяется на информационное сообщение, которое может быть следующим: "Консоль очищена".

+ +

Заметка для Google Chrome, от функции console.clear() не будет никакого эффекта, если у пользователя установлена надстройка "Preserve log upon navigation" в настройках.

+ +

Синтаксис

+ +
console.clear();
+
+ +

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

+ + + + + + + + + + + + + + + + +
ХарактеристикаСтатусКомментарий
{{SpecName("Console API", "#consoleclear", "console.clear()")}}{{Spec2("Console API")}}Первоначальное определение
+ +

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

+ +

{{Compat("api.Console.clear")}}

+ +
+ +

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

+ + diff --git a/files/ru/web/api/console/count/index.html b/files/ru/web/api/console/count/index.html new file mode 100644 index 0000000000..c91f2fffe9 --- /dev/null +++ b/files/ru/web/api/console/count/index.html @@ -0,0 +1,170 @@ +--- +title: Console.count() +slug: Web/API/Console/count +translation_of: Web/API/Console/count +--- +
{{APIRef("Console API")}}
+ +
Выводит число, равное тому, сколько раз была вызвана конкретная функция count(). Эта функция также принимает необязательный аргумент label.
+ +

{{AvailableInWorkers}}

+ +

Если label передается в функцию, то она выводит число вызовов функции count() с такой же точно label.

+ +

Если label опущена, то функция выводит такое число, сколько раз была вызвана функция count() в этой отдельной строке.

+ +

Например, при таком коде:

+ +
var user = "";
+
+function greet() {
+  console.count();
+  return "hi " + user;
+}
+
+user = "bob";
+greet();
+user = "alice";
+greet();
+greet();
+console.count();
+ +

В консоль выведется:

+ +
"<no label>: 1"
+"<no label>: 2"
+"<no label>: 3"
+"<no label>: 1"
+
+ +

 

+ +

Обратите внимание на итоговую строку вывода журнала: отдельный вызов count () в строке 11 рассматривается как независимое событие.

+ +

Если мы передадим переменную user в качестве аргумента label при первом вызове функции count(), aи строку "alice" при втором:

+ +
var user = "";
+
+function greet() {
+  console.count(user);
+  return "hi " + user;
+}
+
+user = "bob";
+greet();
+user = "alice";
+greet();
+greet();
+console.count("alice");
+ +

На выходе мы увидим:

+ +
"bob: 1"
+"alice: 1"
+"alice: 2"
+"alice: 3"
+ +

Таким образом мы сохранили различные счетчики основываясь только на значении label. Поскольку строка  "alice"  в строке 11 совпала со значением user дважды, это не сочлось отдельным событием.

+ +

Синтаксис

+ +
console.count([label]);
+
+ +

Параметры

+ +
+
label
+
Строка. Если она передается, count() выводит такое число, которое сообветсвует количеству  раз вызова данной функции с таким же точно label.
+
+ +

Specifications

+ + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName("Console API", "#count", "console.count()")}}{{Spec2("Console API")}}Initial definition
+ +

Browser compatibility

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatGeckoDesktop("30.0")}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
Available in workers{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatGeckoDesktop("38.0")}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidEdgeFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatGeckoMobile("30.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
Available in workers{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatGeckoMobile("38.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
diff --git a/files/ru/web/api/console/countreset/index.html b/files/ru/web/api/console/countreset/index.html new file mode 100644 index 0000000000..b5bdb7e3b8 --- /dev/null +++ b/files/ru/web/api/console/countreset/index.html @@ -0,0 +1,130 @@ +--- +title: Console.countReset() +slug: Web/API/Console/countReset +translation_of: Web/API/Console/countReset +--- +
{{APIRef("Console API")}}
+ +

Сбрасывает значение счетчика. Эта функция также принимает необязательный аргумент label.

+ +

{{AvailableInWorkers}}

+ +

Если аргумент label передан, то функция сбросит счетчик связанный с этим аргументом.

+ +

Если значение label опущено, то функция сбросит счетчик, заданый по умолчанию.

+ +

Синтаксис

+ +
console.countReset([label]);
+
+ +

Параметры

+ +
+
label
+
Строка.
+ Если аргумент label был передан, countReset() сбросит к 0 счетчик для этого label.
+ Если нет, count() сбросит к 0 счетчик, заданый по умолчанию.
+
+ +

Возвращаемое значение

+ +

Если аргумент label был передан:

+ +
 counter-name: 0
+ +

Если аргумент label не был определен:

+ +
default: 0
+ +

Исключения

+ +

Если аргумент label был передан, но такого счетчика не существует countReset вернет предупреждение:

+ +
Counter "counter-name" doesn’t exist.
+ +

Если аргумент label не был передан и count() не был вызван ранее, countReset вернет предупреждение:

+ +
Counter "default" doesn’t exist.
+ +

Примеры

+ +

Например, при таком коде:

+ +
var user = "";
+
+function greet() {
+  console.count();
+  return "hi " + user;
+}
+
+user = "bob";
+greet();
+user = "alice";
+greet();
+greet();
+console.count();
+console.countReset();
+ +

Вывод консоли будет примерно таким:

+ +
"default: 1"
+"default: 2"
+"default: 3"
+"default: 1"
+"default: 0"
+
+ +

Заметьте, что вызов console.counterReset() сбросил до 0 значение счетчика заданного по умолчанию.

+ +

Если мы присвоим переменную user как арумент label при первом вызове count(), и строку "alice" при втором:

+ +
var user = "";
+
+function greet() {
+  console.count(user);
+  return "hi " + user;
+}
+
+user = "bob";
+greet();
+user = "alice";
+greet();
+greet();
+console.countReset("bob");
+console.count("alice");
+ +

Вывод будет примерно таким:

+ +
"bob: 1"
+"alice: 1"
+"alice: 2"
+"bob: 0"
+"alice: 3"
+ +

Сброс счетчика "bob" изменил значение только этого счетчика. Значение счетчика "alice" осталось неизменно.

+ +

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

+ + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName("Console API", "#count", "console.countReset()")}}{{Spec2("Console API")}}Initial definition
+ +

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

+ + + +

{{Compat("api.Console.countReset")}}

diff --git a/files/ru/web/api/console/debug/index.html b/files/ru/web/api/console/debug/index.html new file mode 100644 index 0000000000..4bd3892b8d --- /dev/null +++ b/files/ru/web/api/console/debug/index.html @@ -0,0 +1,56 @@ +--- +title: Console.debug() +slug: Web/API/Console/debug +translation_of: Web/API/Console/debug +--- +
{{APIRef("Console API")}}
+ +

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

+ +

{{AvailableInWorkers}}

+ +

Синтаксис

+ +
console.debug(obj1 [, obj2, ..., objN]);
+console.debug(msg [, subst1, ..., substN]);
+
+ +

Параметры

+ +
+
obj1 ... objN
+
Список объектов JavaScript для вывода. Строковые представления каждого из этих объектов соединяются вместе в указанном порядке и выводятся. 
+
msg
+
Строка JavaScript, содержащая 0 и более подстановочных символов для замены (см. subst1 ... substN).
+
subst1 ... substN
+
JavaScript-объекты, с помощью которых произойдёт замена подстановочных символов в msg. Это даст вам дополнительный контроль над форматом вывода. (см. {{SectionOnPage("/ru/docs/Web/API/Console", "Преобразование строк с использованием масок")}}).
+
+ +

Читайте Вывод текста в консоль в документаци {{domxref("console")}} для получения дополнительной информации.

+ +

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

+ + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName("Console API", "#debug", "console.debug()")}}{{Spec2("Console API")}}Первоначальное определение
+ +

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

+ +
+ + +

{{Compat("api.Console.debug")}}

+
diff --git a/files/ru/web/api/console/dir/index.html b/files/ru/web/api/console/dir/index.html new file mode 100644 index 0000000000..e710d4cd72 --- /dev/null +++ b/files/ru/web/api/console/dir/index.html @@ -0,0 +1,91 @@ +--- +title: Console.dir() +slug: Web/API/Console/dir +tags: + - API + - DOM + - Веб-консоль +translation_of: Web/API/Console/dir +--- +

{{ APIRef("Console API") }}{{Non-standard_header}}

+ +

Описание

+ +

Отображает список свойств указанного JavaScript объекта. Вывод представлен в виде иерархического списка с  возможностью просмотра содержимого дочерних объектов.

+ +

Console.dir это способ посмотреть в консоли свойства заданного javascript объекта.

+ +

console-dir.png

+ +

Синтаксис

+ +
console.dir(object);
+
+ +

Параметры

+ +
+
object
+
JavaScript-объект свойства которого нужно вывести.
+
+ +

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

+ +

Console Object API

+ +

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

+ +

{{ CompatibilityTable() }}

+ +
+ + + + + + + + + + + + + + + + + + + +
ОсобенностьChromeFirefox (Gecko)Internet ExplorerOperaSafari
Поддержка{{ CompatVersionUnknown() }}{{ CompatGeckoDesktop("8.0") }}9{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}
+
+ +
+ + + + + + + + + + + + + + + + + + + +
ОсобенностьAndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Поддержка{{ CompatUnknown() }}{{ CompatGeckoMobile("8.0") }}{{ CompatUnknown() }}{{ CompatUnknown() }}{{ CompatUnknown() }}
+
+ +

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

+ + diff --git a/files/ru/web/api/console/dirxml/index.html b/files/ru/web/api/console/dirxml/index.html new file mode 100644 index 0000000000..02856c1dc8 --- /dev/null +++ b/files/ru/web/api/console/dirxml/index.html @@ -0,0 +1,57 @@ +--- +title: Console.dirxml() +slug: Web/API/Console/dirxml +translation_of: Web/API/Console/dirxml +--- +
{{APIRef("Console API")}}
+ +

Отображает интерактивное дерево из дочерних элементов указанного XML / HTML элемента. Если невозможно отобразить как элемент, то вместо этого отображается представление объекта JavaScript. Выходные данные представлены в виде иерархического списка расширяемых узлов, которые позволяют вам видеть содержимое дочерних узлов.

+ +

+ +

+ +

Синтакис

+ +
console.dirxml(object);
+
+ +

Параметры

+ +
+
object
+
+

Объект JavaScript свойства которого будут отображены.

+
+
+ +

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

+ + + + + + + + + + + + + + + + +
ХарактеристикаСтатусКомментарий
{{SpecName("Console API", "#dirxml", "console.dirxml()")}}{{Spec2("Console API")}}Первоначальное определение
+ +

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

+ + + +

{{Compat("api.Console.dirxml")}}

+ +

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

+ + diff --git a/files/ru/web/api/console/error/index.html b/files/ru/web/api/console/error/index.html new file mode 100644 index 0000000000..419e2637ba --- /dev/null +++ b/files/ru/web/api/console/error/index.html @@ -0,0 +1,170 @@ +--- +title: console.error() +slug: Web/API/Console/error +translation_of: Web/API/Console/error +--- +
{{APIRef("Console API")}}
+ +

Выводит сообщение об ошибке в веб-консоль.

+ +

{{AvailableInWorkers}}

+ +

Синтаксис

+ +
console.error(obj1 [, obj2, ..., objN]);
+console.error(msg [, subst1, ..., substN]);
+console.exception(obj1 [, obj2, ..., objN]);
+console.exception(msg [, subst1, ..., substN]);
+
+ +
+

Примечание: console.exception() -- это псевдоним для console.error(); они функционально идентичны.

+
+ +

Параметры

+ +
+
obj1 ... objN
+
Список объектов JavaScript для вывода. Строковое представление каждого из этих объектов объединяются в указанном порядке и выводятся.
+
msg
+
Строка JavaScript, содержащая 0 или более подстановочных символов для замены.
+
subst1 ... substN
+
Объекты JavaScript, с помощью которых произойдёт замена символов в msg. Это предоставляет дополнительный контроль над форматом вывода.
+
+ +

Смотрите раздел Вывод текста в консоль в документации {{domxref("console")}} для подробностей.

+ +

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

+ + + + + + + + + + + + + + + + +
СпецификацияСтатусКомментарий
{{SpecName("Console API", "#error", "console.error()")}}{{Spec2("Console API")}}Первоначальное определение
+ +

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

+ +
{{CompatibilityTable}}
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatGeckoDesktop("2.0")}}8{{CompatVersionUnknown}}{{CompatVersionUnknown}}
Маски подстановки{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatGeckoDesktop("9.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
Псевдоним console.exception{{CompatNo}}{{CompatVersionUnknown}}{{CompatGeckoDesktop("28.0")}}{{CompatNo}}{{CompatNo}}{{CompatNo}}
Доступно в Workers{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatGeckoDesktop("38.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidEdgeFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Базовая поодержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatGeckoMobile("2.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
Маски подстановки{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatGeckoMobile("9.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
Псевдоним console.exception{{CompatNo}}{{CompatVersionUnknown}}{{CompatGeckoMobile("28.0")}}{{CompatNo}}{{CompatNo}}{{CompatNo}}
Доступно в Workers{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatGeckoMobile("38.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +

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

+ + diff --git a/files/ru/web/api/console/group/index.html b/files/ru/web/api/console/group/index.html new file mode 100644 index 0000000000..91817d2671 --- /dev/null +++ b/files/ru/web/api/console/group/index.html @@ -0,0 +1,147 @@ +--- +title: Console.group() +slug: Web/API/Console/group +translation_of: Web/API/Console/group +--- +
{{APIRef("Console API")}}
+ +
Создает новую группу сообщений в веб-консоли. После вызова последующие сообщения, выводимые в консоль, будут иметь дополнительный уровень отступа, до тех пор пока не будет вызван метод {{domxref("console.groupEnd()")}}.
+ +

{{AvailableInWorkers}}

+ +

Синтаксис

+ +
console.group([label]);
+
+ +

Аргументы

+ +
+
label
+
Опциональный заголовок группы. (Протестировано в Chrome 59). Не работает с console.groupEnd().
+
+ +

{{h3_gecko_minversion("Использование в веб-консоли", "9.0")}}

+ +

Использование групп помогает упорядочить вывод в консоль благодаря визуальной группировке связанных сообщений. Чтобы начать новый блок нужно вызвать console.group(). Метод console.groupCollapsed() работает аналогичным образом, но выведенная группа будет свернута до тех пор, пока не будет развернута по клику.

+ +

Примечание:  Начиная с 9 по 51 версию Gecko, метод groupCollapsed() работал как метод group(). Свернутые группы поддерживаются с версии Gecko 52. См. {{bug("1088360")}}.

+ +

Чтобы прекратить вывод в группу, требуется вызвать console.groupEnd(). К примеру, следующий код:

+ +
console.log("This is the outer level");
+console.group();
+console.log("Level 2");
+console.group();
+console.log("Level 3");
+console.warn("More of level 3");
+console.groupEnd();
+console.log("Back to level 2");
+console.groupEnd();
+console.log("Back to the outer level");
+
+ +

выведет следующий результат:

+ +

A screenshot of messages nested in the console output.

+ +

Для дополнительной информации смотрите Использование групп в консоли.

+ +

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

+ + + + + + + + + + + + + + + + +
СпецификацияСтатусКомментарий
{{SpecName("Console API", "#group", "console.group()")}}{{Spec2("Console API")}}Первоначальное определение
+ +

Поддержка в браузерах

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ВозможностьChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari
Базовая поддержка2{{CompatVersionUnknown}}{{CompatGeckoDesktop("2.0")}}11{{CompatVersionUnknown}}4.0[1]
Доступно в Web Workers{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatGeckoDesktop("38.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ВозможностьAndroidEdgeFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Базовая поддержка{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatGeckoMobile("2.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
Доступно в Web Workers{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatGeckoMobile("38.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +

[1] Реализовано в http://trac.webkit.org/changeset/35421.

+ +

См. также

+ + diff --git a/files/ru/web/api/console/index.html b/files/ru/web/api/console/index.html new file mode 100644 index 0000000000..f2b4a069b7 --- /dev/null +++ b/files/ru/web/api/console/index.html @@ -0,0 +1,261 @@ +--- +title: Console +slug: Web/API/Console +tags: + - API + - DOM + - NeedsCompatTable + - Reference + - Référence(2) + - Веб-консоль + - Отладка + - Справочник по DOM Gecko +translation_of: Web/API/Console +--- +
{{APIRef("Console API")}}
+ +

Объект Сonsole служит для доступа к средствам отладки браузера (например, Web Console (Веб-консоль) в Firefox). Работа с ним отличается в разных браузерах, но эти методы и свойства по факту поддерживаются всеми браузерами.

+ +

Доступ к Сonsole можно получить через свойство глобального объекта, то есть: {{domxref("Window")}} в браузере (в JavaScript), {{domxref("WorkerGlobalScope")}} — в workers это специальный способ доступа через свойство console. Он известен как {{domxref("Window.console")}}, и на него ссылаются для простоты так: "console".

+ +
console.log("Failed to open the specified link")
+ +

Ниже описаны методы, доступные в объекте Console и приведены несколько примеров их использования.

+ +

{{AvailableInWorkers}}

+ +

Методы

+ +
+
{{domxref("Console.assert()")}}
+
Выводит в консоль (имеется ввиду веб-консоль) сообщение и стек вызова метода, если первый аргумент false.
+
{{domxref("Console.clear()")}}
+
Очистка консоли.
+
{{domxref("Console.count()")}}
+
Выводит количество вызовов метода с определенной меткой (передаётся в параметре метода)
+
+ +
+
{{domxref("Console.countReset()")}}
+
Обнуляет значение счетчика с заданным значением.
+
+ +
+
{{domxref("Console.debug()")}}
+
Синоним для log()
+
{{domxref("Console.dir()")}} {{Non-standard_inline}}
+
Отображает интерактивный список свойств указанного объекта JavaScript. Этот список позволит вам посмотреть дочерние объекты и их свойства.
+
{{domxref("Console.dirxml()")}} {{Non-standard_inline}}
+
+

Отображает представление указанного объекта в XML/HTML-виде, если это возможно. Если нет - в виде JavaScript-объекта (как в виде "console.dir()").

+
+
{{domxref("Console.error()")}}
+
Выводит сообщение об ошибке. Для форматирования вы можете использовать подстановочные символы (маски) с дополнительными параметрами.
+
{{domxref("Console._exception()")}} {{Non-standard_inline}} {{deprecated_inline}}
+
Синоним для error();
+
{{domxref("Console.group()")}}
+
Создаёт новую группировку сообщений, сдвигая все следующие выводимые строки вправо на один уровень. Для завершения группы вызовите groupEnd().
+
{{domxref("Console.groupCollapsed()")}}
+
Создаёт новую группировку сообщений, сдвигая все следующие сообщения вправо на один уровень; в отличие от group() вывод происходи в свёрнутую группу, требующую раскрыть её вручную по кнопке. Для завершения группы вызовите groupEnd().
+
{{domxref("Console.groupEnd()")}}
+
Выход из текущей группы.
+
{{domxref("Console.info()")}}
+
Информационное сообщение. Для форматирования вы можете использовать подстановочные символы (маски) с дополнительными параметрами.
+
{{domxref("Console.log()")}}
+
Общий метод вывода информации. Для форматирования вы можете использовать подстановочные символы (маски) с дополнительными параметрами.
+
{{domxref("Console.profile()")}} {{Non-standard_inline}}
+
Запускает профайлер, встроенный в браузер (например, Firefox performance tool). Вы можете указать метку профиля (по желанию).
+
{{domxref("Console.profileEnd()")}} {{Non-standard_inline}}
+
Останавливает профайлер.Вы можете посмотреть результат в инструментах анализа производительности браузера (например, Firefox performance tool).
+
{{domxref("Console.table()")}}
+
Отображает табличные данные в виде таблицы.
+
{{domxref("Console.time()")}}
+
Запускает таймер с именем из переданного параметра. Можно запустить одновременно до 10,000 таймеров на странице.
+
{{domxref("Console.timeEnd()")}}
+
Останавливает указанный таймер и записывает в лог, сколько прошло секунд от его старта.
+
{{domxref("Console.timeStamp()")}} {{Non-standard_inline}}
+
Ставит маркер в браузерном инструменте измерения производительности Timeline или Waterfall.
+
{{domxref("Console.trace()")}}
+
Вывод трассировки стека.
+
{{domxref("Console.warn()")}}
+
Выводит предупреждающее сообщение. Для форматирования вы можете использовать подстановочные символы (маски) с дополнительными параметрами.
+
+ + +

Использование

+ +

Вывод текста в консоль

+ +

Чаще всего Консоль используется для вывода строк текста и других типов данных. Существует четыре категории вывода, которые вы можете создавать, используя функции {{domxref("console.log()")}}, {{domxref("console.info()")}}, {{domxref("console.warn()")}}, {{domxref("console.error()")}}. Их вывод стилизован по-разному, и вы можете использовать фильтры, предоставляемые браузером, чтобы видеть только интересующие вас вещи.

+ +

Есть два пути использования функций вывода; можно просто передать список объектов, чьё строковое представление сольётся в одну строку, после чего выведется в консоль, или вы можете использовать строку с подстановочными символами и списком объектов-параметров для подстановки в них.

+ +

Вывод одного объекта

+ +

Простейший способ для вывода одного объекта:

+ +
var someObject = { str: "Some text", id: 5 };
+console.log(someObject);
+
+ +

Вывод будет таким:

+ +
[09:27:13.475] ({str:"Some text", id:5})
+ +

Вывод нескольких объектов

+ +

Вы можете выводить несколько объектов, просто перечисляя их в вызываемой функции:

+ +
var car = "Dodge Charger";
+var someObject = {str:"Some text", id:5};
+console.info("My first car was a", car, ". The object is: ", someObject);
+ +

Вывод будет таким:

+ +
[09:28:22.711] My first car was a Dodge Charger . The object is:  ({str:"Some text", id:5})
+
+ +

Преобразование строк с использованием масок

+ +

Gecko 9.0 {{geckoRelease("9.0")}} ввёл поддержку подстановочных символов (масок). При передаче строки одному из методов вы можете использовать следующие символы:

+ + + + + + + + + + + + + + + + + + + + + + + + +
Подстановочный символОписание
%o или %OВыводит ссылку на JavaScript-объект. Нажатие на ссылку приведёт к открытию инспектора кода.
%d или %iВыведет целое число. Поддерживается форматирование, например, console.log("АБВГД %.2d", 1.1) выведет число как две значащих цифры с лидирующим нулём: АБВГД 01
%sВыводит строку.
%fВыводит число с плавающей точкой. Поддерживается форматирование, например, console.log("АБВГД %.2f", 1.1) выведет число до двух знаков после запятой: АБВГД 1.10
+ +

Каждая из масок выбирает следующий аргумент из списка параметров. Пример:

+ +
for (var i=0; i<5; i++) {
+  console.log("Hello, %s. You've called me %d times.", "Bob", i+1);
+}
+
+ +

Вывод будет таким:

+ +
[13:14:13.481] Hello, Bob. You've called me 1 times.
+[13:14:13.483] Hello, Bob. You've called me 2 times.
+[13:14:13.485] Hello, Bob. You've called me 3 times.
+[13:14:13.487] Hello, Bob. You've called me 4 times.
+[13:14:13.488] Hello, Bob. You've called me 5 times.
+
+ +

Стилизация вывода консоли

+ +

Можно  использовать директиву "%c" для применения стилей CSS при выводе в консоль. Часть текста до директивы не затрагивается стилем, а часть после - будет стилизована:

+ +
console.log("This is %cMy stylish message", "color: yellow; font-style: italic; background-color: blue; padding: 2px;");
+ +
+ +
+

Note: Поддерживается довольно много свойств стилей CSS; но вам необходимо поэкспериментировать и посмотреть, что окажется более полезным.

+
+ +
{{h3_gecko_minversion("Using groups in the console", "9.0")}}
+ +

Вы можете использовать вложенные группы для организации вывода, визуально комбинируя связанный материал. Для создания вложенного блока вызовите console.group(). Метод console.groupCollapsed() похожий, но создаёт новый блок свёрнутым, что потребует нажать на кнопку, для своего раскрытия для чтения.

+ +
Note: Свёрнутые группы не поддерживаются пока в Gecko; в настоящее время метод groupCollapsed() работает так же как и group().
+ +

Для выхода из текущей группы просто вызовите console.groupEnd(). Пример:

+ +
console.log("This is the outer level");
+console.group();
+console.log("Level 2");
+console.group();
+console.log("Level 3");
+console.warn("More of level 3");
+console.groupEnd();
+console.log("Back to level 2");
+console.groupEnd();
+console.debug("Back to the outer level");
+
+ +

Вывод будет таким:

+ +

nesting.png

+ +

{{h3_gecko_minversion("Timers", "10.0")}}

+ +

Для расчета длительности определённых операций в Gecko 10 введена поддержка таймеров в объекте console. Для запуска таймера вызовите функцию console.time(), при этом в качестве параметра передайте название таймера. Для остановки таймера и для получения прошедшего времени в миллисекундах вызовите console.timeEnd(), передав в качестве параметра имя таймера. На странице можно запустить до 10000 таймеров одновременно.

+ +

Рассмотрим пример:

+ +
console.time("answer time");
+alert("Click to continue");
+console.timeEnd("answer time");
+
+ +

этот код запишет в веб-консоль время необходимое пользователю для того, чтобы закрыть окно alert:

+ +

timerresult.png

+ +

Заметьте, что имя таймера отображено и при старте таймера и при его остановке.

+ +
Заметьте: Это важно: если вы используете таймер для записи таймингов сетевого трафика, то таймер отобразит общее время для операции, в то время как время, отображаемое в панели "Сеть" это только время, требуемое для заголовка. Если у вас включено логирование времени тела ответа, то время ответа для заголовка и для тела должно соответствовать времени, которое вы у видите в консоли.
+ +

Трассировка стека вызова

+ +

Консоль также поддерживает вывод трассировки стека; она покажет вам весь путь вызовов функций, пройденный до момента, когда вы вызвали {{domxref("console.trace()")}}. Например, такой код:

+ +
foo();
+
+function foo() {
+  function bar() {
+    console.trace();
+  }
+  bar();
+}
+
+ +

Вывод в консоль будет похож на этот:

+ +

+ +

Замечания

+ + + +

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

+ + + +

Реализации в браузерах

+ + diff --git a/files/ru/web/api/console/info/index.html b/files/ru/web/api/console/info/index.html new file mode 100644 index 0000000000..177715ed03 --- /dev/null +++ b/files/ru/web/api/console/info/index.html @@ -0,0 +1,157 @@ +--- +title: Console.info() +slug: Web/API/Console/info +tags: + - Debugging + - Web Development +translation_of: Web/API/Console/info +--- +
{{APIRef("Console API")}}
+ +

Выводит сообщения, содержащие некоторую информацию, в Веб-консоль.  В Firefox и Chrome, рядом с этими элементами в консоли отображается маленькая иконка "i".

+ +

{{AvailableInWorkers}}

+ +

Синтаксис

+ +
console.info(obj1 [, obj2, ..., objN]);
+console.info(msg [, subst1, ..., substN]);
+
+ +

Параметры

+ +
+
obj1 ... objN
+
Список объектов JavaScript, для вывода. Строковое представление каждого из них добавляется в указанном порядке вывода.
+
msg
+
Строка, содержащая 0 или более масок для замены.
+
subst1 ... substN
+
Объекты JavaScript, которыми заменятся маски в строке msg. Так можно дополнительно контролировать формат вывода. Например, console.info('Output %f', 234); выведет в консоль: Output 234.000000
+
+ +

Смотрите Вывод текста в консоль в документации {{domxref("console")}} для получения подробностей.

+ +

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

+ + + + + + + + + + + + + + + + +
СпецификацияСтатусОписание
{{SpecName("Console API", "#consoleinfoobject--object-", "console.info()")}}{{Spec2("Console API")}}Первоначальное определение
+ +

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

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ВозможностьChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatGeckoDesktop("2.0")}}8{{CompatVersionUnknown}}{{CompatVersionUnknown}}
Заменяемые маски{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatGeckoDesktop("9.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
Информационная иконка{{CompatVersionUnknown}}{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatNo}}
Доступно в Workers{{CompatUnknown}}{{CompatUnknown}}{{CompatGeckoDesktop("38.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ВозможностьAndroidEdgeFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Базовая поддержка{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatGeckoMobile("2.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
Заменяемые маски{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatGeckoMobile("9.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
Доступно в Workers{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatGeckoMobile("38.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +

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

+ + diff --git a/files/ru/web/api/console/log/index.html b/files/ru/web/api/console/log/index.html new file mode 100644 index 0000000000..ba29cd2002 --- /dev/null +++ b/files/ru/web/api/console/log/index.html @@ -0,0 +1,92 @@ +--- +title: Console.log() +slug: Web/API/Console/log +tags: + - Debug + - Debugging + - console + - console.log() + - Отладка + - метод +translation_of: Web/API/Console/log +--- +
{{APIRef("Console API")}}
+ +

Выводит сообщение в веб-консоль.

+ +

{{AvailableInWorkers}}

+ +

Синтаксис

+ +
console.log(obj1 [, obj2, ..., objN]);
+console.log(msg [, subst1, ..., substN]);
+
+ +

Параметры

+ +
+
obj1 ... objN
+
Список объектов JavaScript для вывода. Строковые представления каждого из этих объектов соединяются вместе в указанном порядке и выводятся. Пожалуйста, обратите внимание, что если вы логируете объекты в последних версиях Chrome и Firefox, то что вы вывели в консоль, является ссылкой на объект, и не обязательно является его "значением" на момент вызова console.log(), это значение объекта в тот момент, когда вы кликаете по нему, чтобы открыть.
+
msg
+
Строка JavaScript, содержащая 0 и более подстановочных символов для замены (см. subst1 ... substN).
+
subst1 ... substN
+
JavaScript-объекты, с помощью которых произойдёт замена подстановочных символов в msg. Это даст вам дополнительный контроль над форматом вывода.
+
+ +

Больше подробностей смотрите в разделе Вывод текста в консоль документации {{domxref("console")}}.

+ +

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

+ + + + + + + + + + + + + + + + +
СпецификацияСтатусКомментарий
{{SpecName("Console API", "#log", "console.log()")}}{{Spec2("Console API")}}Первоначальное определение
+ +

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

+ +

{{Compat("api.Console.log")}}

+ +

Отличия от console.dir()

+ +

Вы можете спросить какая разница между console.dir() и console.log(). Это полезное отличие.

+ +

+ +

Заметка:

+ + + +

А именно, console.log даёт специальное обращение к DOM-элементам, тогда как console.dir - нет. Это особенно полезно, когда нужно видеть полное представление DOM JS-объетов.

+ +

Больше информации об этой и других функциях в Chrome Console API reference.

+ +

Логирование объектов

+ +

Не используйте console.log(obj);,
+ Используйте console.log(JSON.parse(JSON.stringify(obj)));.

+ +

Так вы можете быть уверены, что видите значение obj в момент, его логирования.

+ +

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

+ + diff --git a/files/ru/web/api/console/profile/index.html b/files/ru/web/api/console/profile/index.html new file mode 100644 index 0000000000..7474ed345c --- /dev/null +++ b/files/ru/web/api/console/profile/index.html @@ -0,0 +1,43 @@ +--- +title: Console.profile() +slug: Web/API/Console/profile +tags: + - АПИ + - Профайлер + - дебаггинг + - профилировщик +translation_of: Web/API/Console/profile +--- +

{{APIRef("Console API")}}{{Non-standard_header}}

+ +

Запускает профайлер, встроенный в браузер (например, Firefox performance tool).

+ +

Вы можете указать аргумент, чтобы назвать профиль, это позволит вам остановить только этот профиль, если записывается несколько профилей. Смотрите {{domxref("Console.profileEnd()")}} чтобы понять, как этот аргумент интерпретируется.

+ +

Останавливает профайлер {{domxref("Console.profileEnd()")}}.

+ +

{{AvailableInWorkers}}

+ +

Синтаксис

+ +
console.profile(profileName);
+
+ +

Параметры

+ +
+
profileName
+
Вы можете указать метку профиля (по желанию).
+
+ +

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

+ + + +

{{Compat("api.Console.profile")}}

+ +

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

+ + diff --git a/files/ru/web/api/console/table/index.html b/files/ru/web/api/console/table/index.html new file mode 100644 index 0000000000..f82a5e6858 --- /dev/null +++ b/files/ru/web/api/console/table/index.html @@ -0,0 +1,205 @@ +--- +title: Console.table() +slug: Web/API/Console/table +tags: + - API + - Дебаг + - консоль +translation_of: Web/API/Console/table +--- +
{{APIRef("Console API")}}{{Non-standard_header}}
+ +

Отображает наборы данных в виде таблицы.

+ +

Данная функция принимает один обязательный аргумент data, который должен быть представлен в виде массива или объекта, и один дополнительный параметр columns.

+ +

функция логгирует аргумент data в виде таблицы. Каждый элемент массива (или каждое свойство, если data - это объект) будет представлять строку таблицы.

+ +

Первая колонка таблицы будет озаглавлена как (index). Если data представлена массивом, тогда значения первой колонки будут представлять индексы массива. Если data - объект, тогда значения первой колонки будут представлять свойства объекта.

+ +

{{AvailableInWorkers}}

+ +

Простые наборы

+ +

Аргумент data может быть массивом или объектом.

+ +
// массив строк
+
+console.table(["apples", "oranges", "bananas"]);
+ +

+ +
// объект, чьи свойства содержат строки
+
+function Person(firstName, lastName) {
+  this.firstName = firstName;
+  this.lastName = lastName;
+}
+
+var me = new Person("John", "Smith");
+
+console.table(me);
+ +

+ +

Наборы смешанных типов

+ +

Если элементы массива, либо свойства объекта, в свою очередь сами являются массивами или объектами, тогда эти элементы или свойства перечисляются построчно, перечисляя вложенные элементы/свойства в колонках:

+ +
// массив массивов
+
+var people = [["John", "Smith"], ["Jane", "Doe"], ["Emily", "Jones"]]
+console.table(people);
+ +

Table displaying array of arrays

+ +
// массив объектов
+
+function Person(firstName, lastName) {
+  this.firstName = firstName;
+  this.lastName = lastName;
+}
+
+var john = new Person("John", "Smith");
+var jane = new Person("Jane", "Doe");
+var emily = new Person("Emily", "Jones");
+
+console.table([john, jane, emily]);
+ +

Обратите внимание,  что если массив состоит из объектов, колонки таблицы будут озаглавленны названиями свойств объекта.

+ +

Table displaying array of objects

+ +
// объект, свойства которого являются объектами
+
+var family = {};
+
+family.mother = new Person("Jane", "Smith");
+family.father = new Person("John", "Smith");
+family.daughter = new Person("Emily", "Smith");
+
+console.table(family);
+ +

Table displaying object of objects

+ +

Ограничение видимости колонок

+ +

По умолчанию, console.table() отображает все элементы в каждой строке. Вы можете использовать опциональный параметер columns чтобы указать набор отображаемых колонок:

+ +
// массив объектов, логгируется только свойство firstName
+
+function Person(firstName, lastName) {
+  this.firstName = firstName;
+  this.lastName = lastName;
+}
+
+var john = new Person("John", "Smith");
+var jane = new Person("Jane", "Doe");
+var emily = new Person("Emily", "Jones");
+
+console.table([john, jane, emily], ["firstName"]);
+ +

Table displaying array of objects with filtered output

+ +

Сортировка колонок

+ +

Вы можете отсортировать необходимую колонку, кликнув по её заголовку.

+ +

Синтаксис

+ +
console.table(data [, columns]);
+
+ +

Параметры

+ +
+
data
+
Данные для отображения. Могут быть представленны массивом или объектом.
+
columns
+
Массив названий колонок, которые следует отобразить.
+
+ +

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

+ + + + + + + + + + + + + + + + +
СпецификацияСтатусКомментарий
{{SpecName("Console API", "#consoletabledata-columns", "console.table()")}}{{Spec2("Console API")}}Initial definition
+ +

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

+ +
{{CompatibilityTable}}
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support{{CompatVersionUnknown}}{{CompatGeckoDesktop("34.0")}}{{CompatNo}}{{CompatVersionUnknown}}{{CompatNo}}
Available in workers{{CompatVersionUnknown}}{{CompatGeckoDesktop("38.0")}}{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatUnknown}}{{CompatGeckoMobile("34.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
Available in workers{{CompatUnknown}}{{CompatGeckoMobile("38.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
diff --git a/files/ru/web/api/console/time/index.html b/files/ru/web/api/console/time/index.html new file mode 100644 index 0000000000..bf32c8aff0 --- /dev/null +++ b/files/ru/web/api/console/time/index.html @@ -0,0 +1,62 @@ +--- +title: Console.time() +slug: Web/API/Console/time +tags: + - API + - DOM + - Method + - Reference + - console +translation_of: Web/API/Console/time +--- +
{{APIRef("Console API")}}
+ +

Запускает таймер, который вы можете использовать для определения, сколько времени занимает выполнение той или иной операции. Вы должны назначить каждому таймеру уникальное имя и таким образом можете запустить до 10000 таймеров на одной странице. Когда вы вызовете {{ domxref("console.timeEnd()") }} с именем, которое использовалось при запуске таймера, браузер отобразит в консоли время (в миллисекундах), прошедшее с момента запуска таймера.

+ +

Примеры и более детальная информация находятся в разделе Таймеры документации к {{ domxref("console") }}

+ +

{{AvailableInWorkers}}

+ +

Синтаксис

+ +
console.time(label);
+ +

Параметры

+ +
+
label
+
Название нового таймера. Оно однозначно идентифицирует таймер. Используйте то же самое название таймера, когда вызываете {{ domxref("console.timeEnd()") }} для остановки и отображения времени выполнения таймера.
+
+ +

Документация

+ + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName("Console API", "#time", "console.time()")}}{{Spec2("Console API")}}Первоначальное определение
+ +

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

+ + + +

{{Compat("api.Console.time")}}

+ +

См. также

+ + diff --git a/files/ru/web/api/console/timeend/index.html b/files/ru/web/api/console/timeend/index.html new file mode 100644 index 0000000000..fd23031ed5 --- /dev/null +++ b/files/ru/web/api/console/timeend/index.html @@ -0,0 +1,76 @@ +--- +title: Console.timeEnd +slug: Web/API/Console/timeEnd +tags: + - API + - Method + - Веб-разработка + - Отладка + - консоль +translation_of: Web/API/Console/timeEnd +--- +
{{APIRef("Console API")}}
+ +

Останавливает таймер, который был запущен до этого через функцию {{domxref("console.time()")}}.

+ +

Более подробная документация и примеры есть в разделе Таймеры документации к {{domxref("console")}}.

+ +

{{AvailableInWorkers}}

+ +

Синтаксис

+ +
console.timeEnd(label);
+
+ +

Параметры

+ +
+
label
+
Метка таймера, который будет остановлен. Останавливается один раз. После остановки время отображается в Веб-консоли.
+
+ +

Примеры

+ +
console.time("answer time");
+alert("Click to continue");
+console.timeLog("answer time");
+alert("Do a bunch of other stuff...");
+console.timeEnd("answer time");
+ +

В примере выше мы получим время, которое потребовалось пользователю, чтобы закрыть первое диалоговое окно, а затем время, которое потребовалось пользователю, чтобы закрыть второе диалоговое окно:

+ +

timerresult.png

+ +

Обратите внимение, что метка таймера отображается как при вызове timeLog(), так и завершении таймера. Кроме того, вызов timeEnd() выводит дополнительную информацию "timer ended", чтобы очевидно показать, что таймер больше не отслеживается.

+ +

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

+ + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName("Console API", "#timeend", "console.timeEnd()")}}{{Spec2("Console API")}}Первоначальное определение
+ +

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

+ +
{{Compat("api.Console.timeEnd")}}
+ +
+ +

См. также

+ + diff --git a/files/ru/web/api/console/timelog/index.html b/files/ru/web/api/console/timelog/index.html new file mode 100644 index 0000000000..9b87553a7f --- /dev/null +++ b/files/ru/web/api/console/timelog/index.html @@ -0,0 +1,92 @@ +--- +title: Console.timeLog() +slug: Web/API/Console/timeLog +translation_of: Web/API/Console/timeLog +--- +
{{APIRef("Console API")}}
+ +
Выводит в консоль текущее значение таймера, запущенного вызовом {{domxref("console.time()")}}.
+ +

Подробности и примеры смотрите в документации Timers.

+ +

{{AvailableInWorkers}}

+ +

Синтаксис

+ +
console.timeLog(label);
+
+ +

Параметры

+ +
+
label
+
Имя таймера для вывода в консоль.
+
+ +

Результат

+ +

Если параметр label опущен, выводит значение таймера по умолчанию:

+ +
default: 1042ms
+ +

Если в параметре label указано имя существующего таймера:

+ +
timer name: 1242ms
+ +

Исключения

+ +

При отсутствии запущенного таймера по умолчанию timeLog() выводит предупреждение:

+ +
Timer “default” doesn’t exist.
+ +

При указании имени несуществующего таймера:

+ +
 Timer “timer name” doesn’t exist. 
+ +

Примеры

+ +
console.time("answer time");
+alert("Нажмите для продолжения");
+console.timeLog("answer time");
+alert("Делаем кучу другой работы...");
+console.timeEnd("answer time");
+
+ +

Отчет таймера начинается с момента вызова console.time(). Сначала выводится время от начала отсчета до закрытия первого уведомления. Затем выводится время с начала отсчета до закрытия второго уведомления:

+ +

timerresult.png

+ +

Обратите внимание, имя таймера печатается как при вызовах timeLog() , так и при завершении таймера.

+ +

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

+ + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName("Console API", "#timelog", "console.timeLog()")}}{{Spec2("Console API")}}Первоначальное определение
+ +

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

+ +
+ + +

{{Compat("api.Console.timeLog")}}

+
+ +

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

+ + diff --git a/files/ru/web/api/console/timestamp/index.html b/files/ru/web/api/console/timestamp/index.html new file mode 100644 index 0000000000..9bd67bdc27 --- /dev/null +++ b/files/ru/web/api/console/timestamp/index.html @@ -0,0 +1,39 @@ +--- +title: Console.timeStamp() +slug: Web/API/Console/timeStamp +tags: + - API + - DOM +translation_of: Web/API/Console/timeStamp +--- +

{{APIRef("Console API")}}{{Non-standard_header}}

+ +

Добавляет маркер в браузерные инструменты Performance или Waterfall. Это помогает соотнести точку в вашем коде с другми записанными событиями.

+ + + +

{{AvailableInWorkers}}

+ +

Синтаксис

+ +
console.timeStamp(label);
+
+ +

Параметры

+ +
+
label
+
Название метки. Необязательный параметр.
+
+ +

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

+ +

{{Compat("api.Console.timestamp")}}

+ +

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

+ + diff --git a/files/ru/web/api/console/trace/index.html b/files/ru/web/api/console/trace/index.html new file mode 100644 index 0000000000..0d092339d5 --- /dev/null +++ b/files/ru/web/api/console/trace/index.html @@ -0,0 +1,66 @@ +--- +title: Console.trace() +slug: Web/API/Console/trace +translation_of: Web/API/Console/trace +--- +
{{APIRef("Console API")}}
+ +

Выводит стэк трэйс в  Веб Консоль.

+ +

{{AvailableInWorkers}}

+ +

Посмотрите Стэк трэйсы в документации {{domxref("console")}} с деталями и примерами.

+ +

Синтаксис

+ +
console.trace();
+
+ +

Пример

+ +
function foo() {
+  function bar() {
+    console.trace();
+  }
+  bar();
+}
+
+foo();
+
+ +

В консоли следующий трэйс будет отображен так:

+ +
bar
+foo
+<anonymous>
+ +

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

+ + + + + + + + + + + + + + + + +
СпецификацияСтатусКомментарий
{{SpecName("Console API", "#trace", "console.trace()")}}{{Spec2("Console API")}}Стандартное значение
+ +

Браузерная совместимость

+ + + +

{{Compat("api.Console.trace")}}

+ +

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

+ + diff --git a/files/ru/web/api/console/warn/index.html b/files/ru/web/api/console/warn/index.html new file mode 100644 index 0000000000..6b5d7c1359 --- /dev/null +++ b/files/ru/web/api/console/warn/index.html @@ -0,0 +1,67 @@ +--- +title: Console.warn() +slug: Web/API/Console/warn +translation_of: Web/API/Console/warn +--- +
+
+
{{APIRef("Console API")}}
+ +
Выводит предупреждение в веб-консоль.
+ +
+ + +

{{AvailableInWorkers}}{{Note("В Firefox, предупреждения имеют небольшое изображение восклицательного знака перед сообщением.")}}

+ +

Синтаксис

+ +
console.warn(obj1 [, obj2, ..., objN]);
+console.warn(msg [, subst1, ..., substN]);
+
+ +

Параметры

+ +
+
obj1 ... objN
+
Список объектов JavaScript для вывода. Строковые представления каждого из этих объектов соединяются вместе в указанном порядке и выводятся.
+
msg
+
Строка JavaScript, содержащая 0 и более подстановочных символов для замен.
+
subst1 ... substN
+
JavaScript-объекты, с помощью которых произойдёт замена подстановочных символов в msg. Это даст вам дополнительный контроль над форматом вывода.
+
+ +

Больше подробностей смотрите в разделе Вывод текста в консоль документации {{domxref("console")}}.

+ +

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

+ + + + + + + + + + + + + + + + +
СпецификацияСтатусКомментарий
Console API
+ Определение 'console.warn()' в спецификации.
Живой стандартПервоначальное определение
+ +

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

+ +
{{Compat("api.Console.warn")}}
+ +

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

+ + +
+
-- cgit v1.2.3-54-g00ecf