представляет комментарий в HTML- или XML-документе. Содержимое комментария (т. е. текст между <! – - и -->) доступно через свойство
data
или через свойство
nodeValue
, унаследованное от интерфейса
Node
. Создать объект
Comment
можно методом
Document.createComment.
Свойства
string data
Текст
комментария.
readonly unsigned long length
Количество символов в комментарии.
Методы
void appendData(string data)
void deleteData(unsigned long offset, unsigned long count)
void insertData(unsigned long offset, string data)
void replaceData(unsigned long offset, unsigned long count, string data)
string substringData(unsigned long offset, unsigned long count)
Узлы
Comment
обладают большинством методов узла
Text
, и эти методы действуют так же, как в случае с узлами
Text
. Они перечислены здесь, но их описание приводится в справочной статье Text.
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» форматируются как вещественные числа, а соответствующие спецификатору «%о» - как объекты, доступные для щелчка мышью,