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

Свойства

<b>readonly boolean wasClean</b>

Если соединение

<b>WebSocket</b>
было закрыто управляемым способом, как определяется протоколом веб-сокетов, с подтверждением со стороны клиента и сервера, говорят, что закрытие было выполнено чисто, и это свойство имеет значение true. Если это свойство имеет значение false, веб-сокет мог быть закрыт в результате какой-либо сетевой ошибки.

Comment

HTML- или XML-комментарий (Node)

Узел

<b>Comment</b>
представляет комментарий в HTML- или XML-документе. Содержимое комментария (т. е. текст между <! -- и -->) доступно через свойство
<b>data</b>
или через свойство
<b>nodeValue</b>
, унаследованное от интерфейса
<b>Node</b>
. Создать объект
<b>Comment</b>
можно методом
<b>Document.createComment().</b>

Свойства

<b>string data</b>

Текст комментария.

<b>readonly unsigned long length</b>

Количество символов в комментарии.

Методы

<b>void appendData(string data)</b>

<b>void deleteData(unsigned long offset, unsigned long count)</b>

<b>void insertData(unsigned long offset, string data)</b>

<b>void replaceData(unsigned long offset, unsigned long count, string data)</b>

<b>string substringData(unsigned long offset, unsigned long count)</b>

Узлы

<b>Comment</b>
обладают большинством методов узла
<b>Text</b>
, и эти методы действуют так же, как в случае с узлами
<b>Text</b>
. Они перечислены здесь, но их описание приводится в справочной статье Text.

Console

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

Современные броузеры (и более ранние версии, с установленными расширениями-отладчиками, такими как Firebug) определяют глобальное свойство

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

В настоящее время не существует официального стандарта, определяющего API объекта

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

См. также ConsoleCommandLine.

Методы

<b>void assert(any expression, string message)</b>

Выводит сообщение об ошибке

<b>message</b>
в консоли, если выражение expression имеет значение false или любое ложное значение, такое как null, undefined, 0 или пустая строка.

<b>void count([string title])</b>

Выводит строку

<b>title</b>
вместе со счетчиком вызовов данного метода с этой же строкой.

<b>void debug(any message...)</b>

Действует подобно методу

<b>console.log(),</b>
но помечает вывод, как отладочную информацию,

<b>void dir(any object)</b>

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

<b>void dirxml(any node)</b>

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

<b>void error(any message...)</b>

Действует подобно методу

<b>console.log(),</b>
но помечает вывод как ошибку,

<b>void group(any message...)</b>

Выводит сообщение message подобно методу

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

<b>void groupCollapsed(any message...)</b>

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

<b>void groupEnd()</b>

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

<b>group()</b>
или
<b>groupCollapsed()</b>
.

<b>void info(any message...)</b>

Действует подобно методу console.

<b>log(),</b>
но помечает вывод как информационное сообщение.

<b>void log(string format, any message...)</b>

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

Для вывода более сложных сообщений данный метод поддерживает простейшие спецификаторы формата функции

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