Debugger Domain-DevTools Protocol версии 0,2 (EdgeHTML)

Домен отладчика предоставляет возможности отладки JavaScript. Он позволяет устанавливать и удалять точки останова, пошаговое выполнение, изменяя трассировку стека и т. д.

Методы включить, Отключить, getPossibleBreakpoints, setBreakpointsActive, setBreakpointByUrl, setBreakpoint, removeBreakpoint, stepOver, stepInto, steping, Pause, Resume, getScriptSource, setPauseOnExceptions , evaluateOnCallFrame, setVariableValue setVariableValue setBlackboxPatterns msSetDebuggerPropertyValue
Мероприятия scriptParsed, breakpointResolved, приостановлено, возобновлено
Типы BreakpointId, CallFrameId, Location, BreakLocation, CallFrame, область
Зависимости Время выполнения

Методы

"Включить"

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


"Отключить"

Отключает отладчик для данной страницы.


getPossibleBreakpoints

Возвращает возможные расположения для точки останова. scriptId в начальном и конечном диапазонах должны быть одинаковыми.

Параметры
start Location Начало диапазона для поиска возможных местоположений точки останова в.
завершить Location Конец диапазона для поиска возможных местоположений точки останова в (исключая). Если не указано, конец сценариев используется как конец диапазона.
Дает
ячейк BreakLocation Список возможных местоположений точки останова.


setBreakpointsActive

Активирует и деактивирует все точки останова на странице.

Параметры
active boolean Новое значение для точек останова в активном состоянии.


setBreakpointByUrl

Задает точку останова JavaScript в указанном расположении с помощью URL-адреса или регулярного URL-адреса. После того как вы выпустили эту команду, для всех существующих проанализированных сценариев будут заданы точки останова и они возвращаются в locations свойство. После синтаксического анализа сценария сопоставления будут breakpointResolved выданы последующие события. Эта логическая точка останова будет содержаться в повторной загрузке страницы.

Параметры
lineNumber integer Номер строки, в которой нужно установить точку останова.
url
необязательные
string URL-адрес ресурсов, для которых нужно установить точку останова.
urlRegex
необязательные
string Шаблон Regex для URL-адресов ресурсов, для которых нужно установить точки останова. Либо url urlRegex должен быть указан.
columnNumber
необязательные
integer Смещение в строке для задания точки останова в.
постусловия
необязательные
string Выражение, используемое в качестве условия для точки останова. Если указан, отладчик будет остановлен только в точке останова, если это выражение имеет значение true.
Дает
breakpointId BreakpointId Идентификатор созданной точки останова для дальнейшей ссылки.
ячейк Location[] Список местоположений, разрешенных этой точкой останова, на момент добавления.


setBreakpoint

Задает точку останова JavaScript в указанном месте.

Параметры
поиска Location Расположение, в котором нужно установить точку останова.
постусловия
необязательные
string Выражение, используемое в качестве условия для точки останова. Если указан, отладчик будет остановлен только в точке останова, если это выражение имеет значение true.
Дает
breakpointId BreakpointId Идентификатор созданной точки останова для дальнейшей ссылки.
actualLocation Location Расположение, в которое разрешена точка останова.


removeBreakpoint

Удаляет точку останова JavaScript.

Параметры
breakpointId BreakpointId


stepOver

Пошаговые инструкции.


stepInto

Пошаговые инструкции в вызов функции.


Пошаговое руководство

Пошаговые инструкции по вызову функции.


pause

Останавливается на следующей инструкции JavaScript.


resume

Возобновляет выполнение JavaScript.


getScriptSource

Возвращает источник для сценария с заданным идентификатором.

Параметры
scriptId Runtime.ScriptId Идентификатор сценария, для которого требуется получить источник.
Дает
scriptSource string Источник сценария.


setPauseOnExceptions

Определяет состояние Pause on Exceptions. Может быть настроено на остановку для всех исключений, неперехваченных исключений или исключений. Состояние начальной паузы в состоянии исключений none .

Параметры
состояни string
Разрешенные значения: нет, не перехвачено, все
Пауза в режиме исключений.


evaluateOnCallFrame

Вычисляет выражение для данного кадра вызова.

Параметры
callFrameId CallFrameId Идентификатор кадра звонка, который нужно вычислить.
выражение string Выражение для вычисления.
Дает
завершил Runtime.RemoteObject Обертка объекта для результата вычисления.


setVariableValue

Изменяет значение переменной в callframe. Области, основанные на объектах, не поддерживаются и должны изменяться вручную.

Параметры
scopeNumber integer число областей на основе 0, указанное в цепочке диапазонов. Разрешены только типы областей "локальный", "замыкание" и "Catch". Другие области можно манипулировать вручную.
variableName string Имя переменной.
newValue Runtime.CallArgument Новое значение переменной.
callFrameId CallFrameId Идентификатор callframe, который содержит переменную.


setBlackboxPatterns

Проб. Замена предыдущих шаблонов BlackBox на прошедшие. Заставляет сервер пропускать пошаговое выполнение или приостановку в сценариях с URL-адресом, совпадающим с одним из шаблонов. Отладчик попытается покинуть сценарий blackboxed, выполнив несколько раз подряд, и, наконец, перейдет к элементу "шаг с выходом", если неудачно.

Параметры
структуру string[] Массив regexps, который будет использоваться для проверки URL-адреса сценария для состояния BlackBox.


msSetDebuggerPropertyValue

Проб. Microsoft: задает для указанного свойства отладчика указанное значение.

Параметры
debuggerPropertyId string Microsoft: заданный идентификатор свойства (например, msDebuggerPropertyId).
newValue string


Мероприятия

scriptParsed

Возникает при синтаксическом анализе сценария. Это событие также срабатывает для всех известных и несобранных сценариев при включенном отладчике.

Параметры
scriptId Runtime.ScriptId Идентификатор синтаксического анализа сценария.
url string URL-адрес или имя синтаксического анализа сценария (если есть).
startLine integer Смещение строки сценария в ресурсе с указанным URL-адресом (для тегов сценария).
startColumn integer Смещение столбца сценария в ресурсе с указанным URL-адресом.
endLine integer Последняя строка сценария.
endColumn integer Длина последней строки сценария.
executionContextId Runtime.ExecutionContextId Задает контекст создания сценария.
sourceMapURL
необязательные
string URL-адрес карты источника, связанной со сценарием (если есть).
Длина
необязательные
integer Проб. Длина сценария.
msParentId
необязательные
string Проб. Это идентификатор родительского документа.
msMimeType
необязательные
string Проб. Это тип MIME.
msIsDynamicCode
необязательные
boolean Проб. Это указывает на то, является ли этот динамический код.
msLongDocumentId
необязательные
integer Проб. Это длинный идентификатор документа.


breakpointResolved

Срабатывает при разрешении точки останова для фактического сценария и местоположения.

Параметры
breakpointId BreakpointId Уникальный идентификатор точки останова.
поиска Location Место фактического местоположения точки останова.
msLength
необязательные
integer Проб. Microsoft: длина кода (например, число знаков) в месте точки останова.


пауза

Возникает, когда отладчикы прерываются для точки останова или исключения.

Параметры
callFrames CallFrame[] Стек вызовов, для которого остановлен отладчик.
оправдан string
Допустимые значения: точка останова, шаг, исключение, другое, EventListener
Причина приостановки.
data
необязательные
object Объект, содержащий специфичные для разрыва дополнительные свойства.
hitBreakpoints
необязательные
string[] Идентификаторы точек останова
asyncStackTrace
необязательные
StackTrace Асинхронная трассировка стека JavaScript.


возобновляется

Возникает, когда отладчик возобновляет выполнение.


Типы

BreakpointId string

Идентификатор точки останова.


CallFrameId string

Идентификатор кадра звонка.


Расположение object

Расположение в исходном коде.

Свойства
scriptId Runtime.ScriptId Идентификатор сценария, указанный в Debugger.scriptParsed .
lineNumber integer Номер строки в сценарии (от 0 до 1).
columnNumber
необязательные
integer Номер столбца в сценарии (от 0 до 1).
msLength integer Microsoft: длина кода (например, число символов) в этом кадре звонка.


BreakLocation object

Разрыв места в исходном коде.

Свойства
scriptId Runtime.ScriptId Идентификатор сценария, указанный в Debugger.scriptParsed .
lineNumber integer Номер строки в сценарии (от 0 до 1).
columnNumber
необязательные
integer Номер столбца в сценарии (от 0 до 1).
msLength integer Microsoft: длина кода (например, число символов) в этом кадре звонка.
Тип
необязательные
string Допустимые значения: debuggerStatement, Call, Return.


CallFrame object

Кадр звонка JavaScript. Массив кадров звонка, вызываемый из стека вызовов.

Свойства
callFrameId CallFrameId Идентификатор кадра звонка. Этот идентификатор действителен только в том случае, если отладчик приостановлен.
functionName string Имя функции JavaScript, вызываемой в этом кадре звонка.
functionLocation
необязательные
Location Проб. Расположение в исходном коде.
поиска Location Расположение в исходном коде.
url string Имя сценария JavaScript или URL-адрес.
scopeChain Scope[] Цепочка диапазонов для этого кадра звонка.
этой Runtime.RemoteObject this объект для этого кадра звонка.
Возвращен
необязательные
Runtime.RemoteObject Возвращаемое значение, если функция находится на точке возврата.


Область применения object

Описание области.

Свойства
Тип string
Допустимые значения: Global, Local, with, замыкание, catch, Block, Script, eval, Module, Return
Тип области.
объект Runtime.RemoteObject Объект, представляющий область. Для global и with областей представляет фактический объект; для остальных областей это искусственный несохраняемый объект, перечисление переменных области в качестве свойств.
name
необязательные
string
startLocation
необязательные
Location Место в исходном коде, с которого начинается область
endLocation
необязательные
Location Место в исходном коде, где заканчивается область


Зависимости

Время выполнения