В настоящее время не существует официального стандарта, определяющего 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
, но помечает вывод как предупреждение.
ConsoleCommandLine
глобальные утилиты для работы с окном консоли
Большинство веб-броузеров поддерживают консоль JavaScript (которую вы, возможно, знаете как «Средства разработчика» («Developer Tools») или «Веб-консоль» («Web Inspector»), которая позволяет вводить одиночные строки программного кода на языке JavaScript. В дополнение к обычным глобальным переменным и функциям клиентского JavaScript командная строка консоли обычно поддерживает полезные свойства и функции, описываемые здесь.
См. также Console.
Свойства
readonly Element $0
Элемент документа, выбранный последним некоторыми средствами отладчика.
readonly Element $1
Элемент документа, выбранный перед элементом $0.
Методы
void cd(Window frame)
Когда документ включает вложенные фреймы, функция
cd
позволяет переключать глобальные объекты и выполнять последующие команды в области видимости фрейма frame.