Книга: JavaScript. Подробное руководство, 6-е издание

Console

Console

вывод отладочной информации

Современные броузеры (и более ранние версии, с установленными расширениями-отладчиками, такими как Firebug) определяют глобальное свойство console, ссылающееся на объект Console. Методы этого объекта образуют API для выполнения простых отладочных операций, таких как вывод сообщений в окно консоли (консоль можно открыть выбором пункта меню, такого как Developer Tools (Средства разработчика) или Web Inspector (Веб-консоль).

В настоящее время не существует официального стандарта, определяющего API объекта Console, но расширение Firebug для Firefox установило стандарт де-факто и производители броузеров стремятся реализовать прикладной интерфейс Firebug, описанный здесь. Поддержка базовой функции console.log() реализована практически повсеместно, но реализация других функций может присутствовать не во всех броузерах. Имейте в виду, что в некоторых старых броузерах свойство console определено, только если открыто окно консоли, и сценарии, использующие объект Console, когда окно консоли не открыто, будут вызывать появление ошибок.

См. также ConsoleCommandLine.

Методы

void assert(any expression, string message)

Выводит сообщение об ошибке message в консоли, если выражение expression имеет значение false или любое ложное значение, такое как null, undefined, 0 или пустая строка.

void count([string title])

Выводит строку title вместе со счетчиком вызовов данного метода с этой же строкой.

void debug(any message...)

Действует подобно методу console.log(), но помечает вывод, как отладочную информацию,

void dir(any object)

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

void dirxml(any node)

Выводит в консоль разметку XML или HTML узла документа,

void error(any message...)

Действует подобно методу console.log(), но помечает вывод как ошибку,

void group(any message...)

Выводит сообщение message подобно методу log(), но отображает его как заголовок свертываемой группы отладочных сообщений. Все последующие операции вывода в консоль будут помещать сообщения в эту группу, пока не будет вызван соответствующий метод groupEnd().

void groupCollapsed(any message...)

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

void groupEnd()

Закрывает самую последнюю группу отладочных сообщений, созданную вызовом метода group() или groupCollapsed().

void info(any message...)

Действует подобно методу console. log(), но помечает вывод как информационное сообщение.

void log(string format, any message...)

Выводит свои аргументы в консоль. В простейшем случае, когда строка format не содержит спецификаторов, начинающихся с символа %, метод просто преобразует свои аргументы в строки и выводит их, отделяя друг от друга пробелами. Когда методу передается объект, строка, выведенная в консоль, будет доступна для щелчка мышью и позволит просматривать содержимое объекта.

Для вывода более сложных сообщений данный метод поддерживает простейшие спецификаторы формата функции printf() из языка С. Аргументы message будут интерполироваться в аргумент format, на место последовательностей символов «%s», «%d», «%і», «%f» и «%о», после чего в консоль будет выведена отформатированная строка (со следующими за ней аргументами message, для которых отсутствуют спецификаторы в аргументе format). Аргументы, соответствующие спецификатору «%s», форматируются как строки. Аргументы, соответствующие спецификаторам «%d» и «%і», форматируются как целые числа. Соответствующие спецификатору «%f» форматируются как вещественные числа, а соответствующие спецификатору «%о» - как объекты, доступные для щелчка мышью,

void profile([string title])

Запускает профилировщик JavaScript и в начале отчета отображает строку title.

void profileEnd()

Останавливает профилировщик и выводит отчет с результатами профилирования программного кода.

void time(string name)

Запускает таймер с именем name.

void timeEnd(string name)

Останавливает таймер с именем name и выводит имя и время, прошедшее с момента вызова соответствующего метода time().

void trace()

Выводит трассировку стека.

void warn(any message...)

Действует подобно методу console.log(), но помечает вывод как предупреждение.

Оглавление книги