1{ 2 "version": { "major": "1", "minor": "1" }, 3 "domains": [{ 4 "domain": "Inspector", 5 "hidden": true, 6 "types": [], 7 "commands": [ 8 { 9 "name": "enable", 10 "description": "Enables inspector domain notifications." 11 }, 12 { 13 "name": "disable", 14 "description": "Disables inspector domain notifications." 15 }, 16 { 17 "name": "reset", 18 "description": "Resets all domains." 19 } 20 ], 21 "events": [ 22 { 23 "name": "evaluateForTestInFrontend", 24 "parameters": [ 25 { "name": "testCallId", "type": "integer" }, 26 { "name": "script", "type": "string" } 27 ] 28 }, 29 { 30 "name": "inspect", 31 "parameters": [ 32 { "name": "object", "$ref": "Runtime.RemoteObject" }, 33 { "name": "hints", "type": "object" } 34 ] 35 }, 36 { 37 "name": "detached", 38 "description": "Fired when remote debugging connection is about to be terminated. Contains detach reason.", 39 "parameters": [ 40 { "name": "reason", "type": "string", "description": "The reason why connection has been terminated." } 41 ], 42 "handlers": ["browser"] 43 }, 44 { 45 "name": "targetCrashed", 46 "description": "Fired when debugging target has crashed", 47 "handlers": ["browser"] 48 } 49 ] 50 }, 51 { 52 "domain": "Memory", 53 "hidden": true, 54 "commands": [ 55 { 56 "name": "getDOMCounters", 57 "returns": [ 58 { "name": "documents", "type": "integer" }, 59 { "name": "nodes", "type": "integer" }, 60 { "name": "jsEventListeners", "type": "integer" } 61 ] 62 } 63 ] 64 }, 65 { 66 "domain": "Page", 67 "description": "Actions and events related to the inspected page belong to the page domain.", 68 "types": [ 69 { 70 "id": "ResourceType", 71 "type": "string", 72 "enum": ["Document", "Stylesheet", "Image", "Media", "Font", "Script", "TextTrack", "XHR", "WebSocket", "Other"], 73 "description": "Resource type as it was perceived by the rendering engine." 74 }, 75 { 76 "id": "FrameId", 77 "type": "string", 78 "description": "Unique frame identifier." 79 }, 80 { 81 "id": "Frame", 82 "type": "object", 83 "description": "Information about the Frame on the page.", 84 "properties": [ 85 { "name": "id", "type": "string", "description": "Frame unique identifier." }, 86 { "name": "parentId", "type": "string", "optional": true, "description": "Parent frame identifier." }, 87 { "name": "loaderId", "$ref": "Network.LoaderId", "description": "Identifier of the loader associated with this frame." }, 88 { "name": "name", "type": "string", "optional": true, "description": "Frame's name as specified in the tag." }, 89 { "name": "url", "type": "string", "description": "Frame document's URL." }, 90 { "name": "securityOrigin", "type": "string", "description": "Frame document's security origin." }, 91 { "name": "mimeType", "type": "string", "description": "Frame document's mimeType as determined by the browser." } 92 ] 93 }, 94 { 95 "id": "FrameResourceTree", 96 "type": "object", 97 "description": "Information about the Frame hierarchy along with their cached resources.", 98 "properties": [ 99 { "name": "frame", "$ref": "Frame", "description": "Frame information for this tree item." }, 100 { "name": "childFrames", "type": "array", "optional": true, "items": { "$ref": "FrameResourceTree" }, "description": "Child frames." }, 101 { "name": "resources", "type": "array", 102 "items": { 103 "type": "object", 104 "properties": [ 105 { "name": "url", "type": "string", "description": "Resource URL." }, 106 { "name": "type", "$ref": "ResourceType", "description": "Type of this resource." }, 107 { "name": "mimeType", "type": "string", "description": "Resource mimeType as determined by the browser." }, 108 { "name": "failed", "type": "boolean", "optional": true, "description": "True if the resource failed to load." }, 109 { "name": "canceled", "type": "boolean", "optional": true, "description": "True if the resource was canceled during loading." } 110 ] 111 }, 112 "description": "Information about frame resources." 113 } 114 ], 115 "hidden": true 116 }, 117 { 118 "id": "SearchMatch", 119 "type": "object", 120 "description": "Search match for resource.", 121 "properties": [ 122 { "name": "lineNumber", "type": "number", "description": "Line number in resource content." }, 123 { "name": "lineContent", "type": "string", "description": "Line with match content." } 124 ], 125 "hidden": true 126 }, 127 { 128 "id": "Cookie", 129 "type": "object", 130 "description": "Cookie object", 131 "properties": [ 132 { "name": "name", "type": "string", "description": "Cookie name." }, 133 { "name": "value", "type": "string", "description": "Cookie value." }, 134 { "name": "domain", "type": "string", "description": "Cookie domain." }, 135 { "name": "path", "type": "string", "description": "Cookie path." }, 136 { "name": "expires", "type": "number", "description": "Cookie expires." }, 137 { "name": "size", "type": "integer", "description": "Cookie size." }, 138 { "name": "httpOnly", "type": "boolean", "description": "True if cookie is http-only." }, 139 { "name": "secure", "type": "boolean", "description": "True if cookie is secure." }, 140 { "name": "session", "type": "boolean", "description": "True in case of session cookie." } 141 ], 142 "hidden": true 143 }, 144 { 145 "id": "ScriptIdentifier", 146 "type": "string", 147 "description": "Unique script identifier.", 148 "hidden": true 149 }, 150 { 151 "id": "NavigationEntry", 152 "type": "object", 153 "description": "Navigation history entry.", 154 "properties": [ 155 { "name": "id", "type": "integer", "description": "Unique id of the navigation history entry." }, 156 { "name": "url", "type": "string", "description": "URL of the navigation history entry." }, 157 { "name": "title", "type": "string", "description": "Title of the navigation history entry." } 158 ], 159 "hidden": true 160 }, 161 { 162 "id": "Quota", 163 "type": "object", 164 "description": "Quota information", 165 "properties": [ 166 { "name": "temporary", "type": "number", "description": "Quota for temporary storage shared among all security origins" }, 167 { "name": "persistent", "type": "number", "description": "Quota for persistent storage for the security origin." } 168 ], 169 "hidden": true 170 }, 171 { 172 "id": "Usage", 173 "type": "object", 174 "description": "Usage information", 175 "properties": [ 176 { "name": "temporary", "type": "array", "items": { "$ref": "Page.UsageItem" }, "description": "Temporary storage usage." }, 177 { "name": "persistent", "type": "array", "items": { "$ref": "Page.UsageItem" }, "description": "Persistent storage usage." }, 178 { "name": "syncable", "type": "array", "items": { "$ref": "Page.UsageItem" }, "description": "Syncable storage." } 179 ], 180 "hidden": true 181 }, 182 { 183 "id": "UsageItem", 184 "type": "object", 185 "description": "Usage information for a client and storage type", 186 "properties": [ 187 { "name": "id", "type": "string", "enum": ["filesystem", "database", "appcache", "indexeddatabase"], "description": "Item id." }, 188 { "name": "value", "type": "number", "description": "Item usage value." } 189 ], 190 "hidden": true 191 }, 192 { 193 "id": "Viewport", 194 "type": "object", 195 "description": "Visible page viewport", 196 "properties": [ 197 { "name": "scrollX", "type": "number", "description": "X scroll offset in CSS pixels." }, 198 { "name": "scrollY", "type": "number", "description": "Y scroll offset in CSS pixels." }, 199 { "name": "contentsWidth", "type": "number", "description": "Contents width in CSS pixels." }, 200 { "name": "contentsHeight", "type": "number", "description": "Contents height in CSS pixels." }, 201 { "name": "pageScaleFactor", "type": "number", "description": "Page scale factor." }, 202 { "name": "minimumPageScaleFactor", "type": "number", "description": "Minimum page scale factor." }, 203 { "name": "maximumPageScaleFactor", "type": "number", "description": "Maximum page scale factor." } 204 ], 205 "hidden": true 206 }, 207 { 208 "id": "ScreencastFrameMetadata", 209 "type": "object", 210 "description": "Screencast frame metadata", 211 "properties": [ 212 { "name": "deviceScaleFactor", "type": "number", "hidden": true, "description": "Device scale factor." }, 213 { "name": "viewport", "$ref": "DOM.Rect", "hidden": true, "description": "Viewport in CSS pixels." }, 214 { "name": "offsetTop", "type": "number", "hidden": true, "optional": true, "description": "Top offset in DIP." }, 215 { "name": "offsetBottom", "type": "number", "hidden": true, "optional": true, "description": "Bottom offset in DIP." }, 216 { "name": "pageScaleFactor", "type": "number", "hidden": true, "description": "Page scale factor." }, 217 { "name": "pageScaleFactorMin", "type": "number", "hidden": true, "description": "Page scale factor min." }, 218 { "name": "pageScaleFactorMax", "type": "number", "hidden": true, "description": "Page scale factor max." }, 219 { "name": "deviceWidth", "type": "number", "hidden": true, "description": "Device screen width in DIP." }, 220 { "name": "deviceHeight", "type": "number", "hidden": true, "description": "Device screen height in DIP." }, 221 { "name": "scrollOffsetX", "type": "number", "hidden": true, "description": "Position of horizontal scroll in CSS pixels." }, 222 { "name": "scrollOffsetY", "type": "number", "hidden": true, "description": "Position of vertical scroll in CSS pixels." } 223 ], 224 "hidden": true 225 } 226 ], 227 "commands": [ 228 { 229 "name": "enable", 230 "description": "Enables page domain notifications.", 231 "handlers": ["browser", "renderer"] 232 }, 233 { 234 "name": "disable", 235 "description": "Disables page domain notifications.", 236 "handlers": ["browser", "renderer"] 237 }, 238 { 239 "name": "addScriptToEvaluateOnLoad", 240 "parameters": [ 241 { "name": "scriptSource", "type": "string" } 242 ], 243 "returns": [ 244 { "name": "identifier", "$ref": "ScriptIdentifier", "description": "Identifier of the added script." } 245 ], 246 "hidden": true 247 }, 248 { 249 "name": "removeScriptToEvaluateOnLoad", 250 "parameters": [ 251 { "name": "identifier", "$ref": "ScriptIdentifier" } 252 ], 253 "hidden": true 254 }, 255 { 256 "name": "reload", 257 "parameters": [ 258 { "name": "ignoreCache", "type": "boolean", "optional": true, "description": "If true, browser cache is ignored (as if the user pressed Shift+refresh)." }, 259 { "name": "scriptToEvaluateOnLoad", "type": "string", "optional": true, "description": "If set, the script will be injected into all frames of the inspected page after reload." }, 260 { "name": "scriptPreprocessor", "type": "string", "optional": true, "description": "Script body that should evaluate to function that will preprocess all the scripts before their compilation.", "hidden": true } 261 ], 262 "description": "Reloads given page optionally ignoring the cache.", 263 "handlers": ["browser", "renderer"] 264 }, 265 { 266 "name": "navigate", 267 "parameters": [ 268 { "name": "url", "type": "string", "description": "URL to navigate the page to." } 269 ], 270 "returns": [ 271 { "name": "frameId", "$ref": "FrameId", "hidden": true, "description": "Frame id that will be navigated." } 272 ], 273 "description": "Navigates current page to the given URL.", 274 "handlers": ["browser", "renderer"] 275 }, 276 { 277 "name": "getNavigationHistory", 278 "parameters": [], 279 "returns": [ 280 { "name": "currentIndex", "type": "integer", "description": "Index of the current navigation history entry." }, 281 { "name": "entries", "type": "array", "items": { "$ref": "NavigationEntry" }, "description": "Array of navigation history entries." } 282 ], 283 "description": "Returns navigation history for the current page.", 284 "hidden": true, 285 "handlers": ["browser"] 286 }, 287 { 288 "name": "navigateToHistoryEntry", 289 "parameters": [ 290 { "name": "entryId", "type": "integer", "description": "Unique id of the entry to navigate to." } 291 ], 292 "description": "Navigates current page to the given history entry.", 293 "hidden": true, 294 "handlers": ["browser"] 295 }, 296 { 297 "name": "getCookies", 298 "returns": [ 299 { "name": "cookies", "type": "array", "items": { "$ref": "Cookie" }, "description": "Array of cookie objects." } 300 ], 301 "description": "Returns all browser cookies. Depending on the backend support, will return detailed cookie information in the <code>cookies</code> field.", 302 "hidden": true 303 }, 304 { 305 "name": "deleteCookie", 306 "parameters": [ 307 { "name": "cookieName", "type": "string", "description": "Name of the cookie to remove." }, 308 { "name": "url", "type": "string", "description": "URL to match cooke domain and path." } 309 ], 310 "description": "Deletes browser cookie with given name, domain and path.", 311 "hidden": true 312 }, 313 { 314 "name": "getResourceTree", 315 "description": "Returns present frame / resource tree structure.", 316 "returns": [ 317 { "name": "frameTree", "$ref": "FrameResourceTree", "description": "Present frame / resource tree structure." } 318 ], 319 "hidden": true 320 }, 321 { 322 "name": "getResourceContent", 323 "async": true, 324 "description": "Returns content of the given resource.", 325 "parameters": [ 326 { "name": "frameId", "$ref": "FrameId", "description": "Frame id to get resource for." }, 327 { "name": "url", "type": "string", "description": "URL of the resource to get content for." } 328 ], 329 "returns": [ 330 { "name": "content", "type": "string", "description": "Resource content." }, 331 { "name": "base64Encoded", "type": "boolean", "description": "True, if content was served as base64." } 332 ], 333 "hidden": true 334 }, 335 { 336 "name": "searchInResource", 337 "description": "Searches for given string in resource content.", 338 "parameters": [ 339 { "name": "frameId", "$ref": "FrameId", "description": "Frame id for resource to search in." }, 340 { "name": "url", "type": "string", "description": "URL of the resource to search in." }, 341 { "name": "query", "type": "string", "description": "String to search for." }, 342 { "name": "caseSensitive", "type": "boolean", "optional": true, "description": "If true, search is case sensitive." }, 343 { "name": "isRegex", "type": "boolean", "optional": true, "description": "If true, treats string parameter as regex." } 344 ], 345 "returns": [ 346 { "name": "result", "type": "array", "items": { "$ref": "SearchMatch" }, "description": "List of search matches." } 347 ], 348 "hidden": true 349 }, 350 { 351 "name": "setDocumentContent", 352 "description": "Sets given markup as the document's HTML.", 353 "parameters": [ 354 { "name": "frameId", "$ref": "FrameId", "description": "Frame id to set HTML for." }, 355 { "name": "html", "type": "string", "description": "HTML content to set." } 356 ], 357 "hidden": true 358 }, 359 { 360 "name": "setDeviceMetricsOverride", 361 "description": "Overrides the values of device screen dimensions (window.screen.width, window.screen.height, window.innerWidth, window.innerHeight, and \"device-width\"/\"device-height\"-related CSS media query results).", 362 "parameters": [ 363 { "name": "width", "type": "integer", "description": "Overriding width value in pixels (minimum 0, maximum 10000000). 0 disables the override." }, 364 { "name": "height", "type": "integer", "description": "Overriding height value in pixels (minimum 0, maximum 10000000). 0 disables the override." }, 365 { "name": "deviceScaleFactor", "type": "number", "description": "Overriding device scale factor value. 0 disables the override." }, 366 { "name": "mobile", "type": "boolean", "description": "Whether to emulate mobile device. This includes viewport meta tag, overlay scrollbars, text autosizing and more." }, 367 { "name": "fitWindow", "type": "boolean", "description": "Whether a view that exceeds the available browser window area should be scaled down to fit." }, 368 { "name": "scale", "type": "number", "optional": true, "description": "Scale to apply to resulting view image. Ignored in |fitWindow| mode." }, 369 { "name": "offsetX", "type": "number", "optional": true, "description": "X offset to shift resulting view image by. Ignored in |fitWindow| mode." }, 370 { "name": "offsetY", "type": "number", "optional": true, "description": "Y offset to shift resulting view image by. Ignored in |fitWindow| mode." } 371 ], 372 "hidden": true 373 }, 374 { 375 "name": "clearDeviceMetricsOverride", 376 "description": "Clears the overriden device metrics.", 377 "hidden": true 378 }, 379 { 380 "name": "resetScrollAndPageScaleFactor", 381 "description": "Requests that scroll offsets and page scale factor are reset to initial values.", 382 "hidden": true 383 }, 384 { 385 "name": "setPageScaleFactor", 386 "description": "Sets a specified page scale factor.", 387 "parameters": [ 388 { "name": "pageScaleFactor", "type": "number", "description": "Page scale factor." } 389 ], 390 "hidden": true 391 }, 392 { 393 "name": "setShowPaintRects", 394 "description": "Requests that backend shows paint rectangles", 395 "parameters": [ 396 { "name": "result", "type": "boolean", "description": "True for showing paint rectangles" } 397 ], 398 "hidden": true 399 }, 400 { 401 "name": "setShowDebugBorders", 402 "description": "Requests that backend shows debug borders on layers", 403 "parameters": [ 404 { "name": "show", "type": "boolean", "description": "True for showing debug borders" } 405 ], 406 "hidden": true 407 }, 408 { 409 "name": "setShowFPSCounter", 410 "description": "Requests that backend shows the FPS counter", 411 "parameters": [ 412 { "name": "show", "type": "boolean", "description": "True for showing the FPS counter" } 413 ], 414 "hidden": true 415 }, 416 { 417 "name": "setContinuousPaintingEnabled", 418 "description": "Requests that backend enables continuous painting", 419 "parameters": [ 420 { "name": "enabled", "type": "boolean", "description": "True for enabling cointinuous painting" } 421 ], 422 "hidden": true 423 }, 424 { 425 "name": "setShowScrollBottleneckRects", 426 "description": "Requests that backend shows scroll bottleneck rects", 427 "parameters": [ 428 { "name": "show", "type": "boolean", "description": "True for showing scroll bottleneck rects" } 429 ], 430 "hidden": true 431 }, 432 { 433 "name": "getScriptExecutionStatus", 434 "description": "Determines if scripts can be executed in the page.", 435 "returns": [ 436 { "name": "result", "type": "string", "enum": ["allowed", "disabled", "forbidden"], "description": "Script execution status: \"allowed\" if scripts can be executed, \"disabled\" if script execution has been disabled through page settings, \"forbidden\" if script execution for the given page is not possible for other reasons." } 437 ], 438 "hidden": true 439 }, 440 { 441 "name": "setScriptExecutionDisabled", 442 "description": "Switches script execution in the page.", 443 "parameters": [ 444 { "name": "value", "type": "boolean", "description": "Whether script execution should be disabled in the page." } 445 ], 446 "hidden": true 447 }, 448 { 449 "name": "setGeolocationOverride", 450 "description": "Overrides the Geolocation Position or Error.", 451 "parameters": [ 452 { "name": "latitude", "type": "number", "optional": true, "description": "Mock latitude"}, 453 { "name": "longitude", "type": "number", "optional": true, "description": "Mock longitude"}, 454 { "name": "accuracy", "type": "number", "optional": true, "description": "Mock accuracy"} 455 ], 456 "redirect": "Geolocation" 457 }, 458 { 459 "name": "clearGeolocationOverride", 460 "description": "Clears the overriden Geolocation Position and Error.", 461 "redirect": "Geolocation" 462 }, 463 { 464 "name": "setDeviceOrientationOverride", 465 "description": "Overrides the Device Orientation.", 466 "parameters": [ 467 { "name": "alpha", "type": "number", "description": "Mock alpha"}, 468 { "name": "beta", "type": "number", "description": "Mock beta"}, 469 { "name": "gamma", "type": "number", "description": "Mock gamma"} 470 ], 471 "redirect": "DeviceOrientation", 472 "hidden": true 473 }, 474 { 475 "name": "clearDeviceOrientationOverride", 476 "description": "Clears the overridden Device Orientation.", 477 "redirect": "DeviceOrientation", 478 "hidden": true 479 }, 480 { 481 "name": "setTouchEmulationEnabled", 482 "parameters": [ 483 { "name": "enabled", "type": "boolean", "description": "Whether the touch event emulation should be enabled." } 484 ], 485 "description": "Toggles mouse event-based touch event emulation.", 486 "hidden": true, 487 "handlers": ["browser", "renderer"] 488 }, 489 { 490 "name": "setEmulatedMedia", 491 "parameters": [ 492 { "name": "media", "type": "string", "description": "Media type to emulate. Empty string disables the override." } 493 ], 494 "description": "Emulates the given media for CSS media queries.", 495 "hidden": true 496 }, 497 { 498 "name": "captureScreenshot", 499 "async": true, 500 "description": "Capture page screenshot.", 501 "parameters": [], 502 "returns": [ 503 { "name": "data", "type": "string", "description": "Base64-encoded image data (PNG)." } 504 ], 505 "hidden": true, 506 "handlers": ["browser"] 507 }, 508 { 509 "name": "canScreencast", 510 "description": "Tells whether screencast is supported.", 511 "returns": [ 512 { "name": "result", "type": "boolean", "description": "True if screencast is supported." } 513 ], 514 "hidden": true, 515 "handlers": ["browser"] 516 }, 517 { 518 "name": "canEmulate", 519 "description": "Tells whether emulation is supported.", 520 "returns": [ 521 { "name": "result", "type": "boolean", "description": "True if emulation is supported." } 522 ], 523 "hidden": true, 524 "handlers": ["browser"] 525 }, 526 { 527 "name": "startScreencast", 528 "description": "Starts sending each frame using the <code>screencastFrame</code> event.", 529 "parameters": [ 530 { "name": "format", "type": "string", "optional": true, "enum": ["jpeg", "png"], "description": "Image compression format." }, 531 { "name": "quality", "type": "integer", "optional": true, "description": "Compression quality from range [0..100]." }, 532 { "name": "maxWidth", "type": "integer", "optional": true, "description": "Maximum screenshot width." }, 533 { "name": "maxHeight", "type": "integer", "optional": true, "description": "Maximum screenshot height." } 534 ], 535 "hidden": true, 536 "handlers": ["browser", "renderer"] 537 }, 538 { 539 "name": "stopScreencast", 540 "description": "Stops sending each frame in the <code>screencastFrame</code>.", 541 "hidden": true, 542 "handlers": ["browser", "renderer"] 543 }, 544 { 545 "name": "handleJavaScriptDialog", 546 "description": "Accepts or dismisses a JavaScript initiated dialog (alert, confirm, prompt, or onbeforeunload).", 547 "parameters": [ 548 { "name": "accept", "type": "boolean", "description": "Whether to accept or dismiss the dialog." }, 549 { "name": "promptText", "type": "string", "optional": true, "description": "The text to enter into the dialog prompt before accepting. Used only if this is a prompt dialog." } 550 ], 551 "hidden": true, 552 "handlers": ["browser"] 553 }, 554 { 555 "name": "setShowViewportSizeOnResize", 556 "description": "Paints viewport size upon main frame resize.", 557 "parameters": [ 558 { "name": "show", "type": "boolean", "description": "Whether to paint size or not." }, 559 { "name": "showGrid", "type": "boolean", "optional": true, "description": "Whether to paint grid as well." } 560 ], 561 "hidden": true 562 }, 563 { 564 "name": "queryUsageAndQuota", 565 "async": true, 566 "parameters": [ 567 { "name": "securityOrigin", "type": "string", "description": "Security origin quota and usage requested for" } 568 ], 569 "returns": [ 570 { "name": "quota", "$ref": "Quota", "description": "Quota for requested security origin." }, 571 { "name": "usage", "$ref": "Usage", "description": "Current usage for requested security origin." } 572 ], 573 "description": "Queries more detailed quota and usage data than Storage API provides.", 574 "hidden": true, 575 "handlers": ["browser"] 576 }, 577 { 578 "name": "setColorPickerEnabled", 579 "parameters": [ 580 { "name": "enabled", "type": "boolean", "description": "Shows / hides color picker" } 581 ], 582 "description": "Shows / hides color picker", 583 "hidden": true, 584 "handlers": ["browser"] 585 } 586 ], 587 "events": [ 588 { 589 "name": "domContentEventFired", 590 "parameters": [ 591 { "name": "timestamp", "type": "number" } 592 ] 593 }, 594 { 595 "name": "loadEventFired", 596 "parameters": [ 597 { "name": "timestamp", "type": "number" } 598 ] 599 }, 600 { 601 "name": "frameAttached", 602 "description": "Fired when frame has been attached to its parent.", 603 "parameters": [ 604 { "name": "frameId", "$ref": "FrameId", "description": "Id of the frame that has been attached." }, 605 { "name": "parentFrameId", "$ref": "FrameId", "description": "Parent frame identifier." } 606 ] 607 }, 608 { 609 "name": "frameNavigated", 610 "description": "Fired once navigation of the frame has completed. Frame is now associated with the new loader.", 611 "parameters": [ 612 { "name": "frame", "$ref": "Frame", "description": "Frame object." } 613 ] 614 }, 615 { 616 "name": "frameDetached", 617 "description": "Fired when frame has been detached from its parent.", 618 "parameters": [ 619 { "name": "frameId", "$ref": "FrameId", "description": "Id of the frame that has been detached." } 620 ] 621 }, 622 { 623 "name": "frameStartedLoading", 624 "description": "Fired when frame has started loading.", 625 "parameters": [ 626 { "name": "frameId", "$ref": "FrameId", "description": "Id of the frame that has started loading." } 627 ], 628 "hidden": true 629 }, 630 { 631 "name": "frameStoppedLoading", 632 "description": "Fired when frame has stopped loading.", 633 "parameters": [ 634 { "name": "frameId", "$ref": "FrameId", "description": "Id of the frame that has stopped loading." } 635 ], 636 "hidden": true 637 }, 638 { 639 "name": "frameScheduledNavigation", 640 "description": "Fired when frame schedules a potential navigation.", 641 "parameters": [ 642 { "name": "frameId", "$ref": "FrameId", "description": "Id of the frame that has scheduled a navigation." }, 643 { "name": "delay", "type": "number", "description": "Delay (in seconds) until the navigation is scheduled to begin. The navigation is not guaranteed to start." } 644 ], 645 "hidden": true 646 }, 647 { 648 "name": "frameClearedScheduledNavigation", 649 "description": "Fired when frame no longer has a scheduled navigation.", 650 "parameters": [ 651 { "name": "frameId", "$ref": "FrameId", "description": "Id of the frame that has cleared its scheduled navigation." } 652 ], 653 "hidden": true 654 }, 655 { 656 "name": "frameResized", 657 "hidden": true 658 }, 659 { 660 "name": "javascriptDialogOpening", 661 "description": "Fired when a JavaScript initiated dialog (alert, confirm, prompt, or onbeforeunload) is about to open.", 662 "parameters": [ 663 { "name": "message", "type": "string", "description": "Message that will be displayed by the dialog." } 664 ], 665 "hidden": true 666 }, 667 { 668 "name": "javascriptDialogClosed", 669 "description": "Fired when a JavaScript initiated dialog (alert, confirm, prompt, or onbeforeunload) has been closed.", 670 "hidden": true 671 }, 672 { 673 "name": "scriptsEnabled", 674 "description": "Fired when the JavaScript is enabled/disabled on the page", 675 "parameters": [ 676 { "name": "isEnabled", "type": "boolean", "description": "Whether script execution is enabled or disabled on the page." } 677 ], 678 "hidden": true 679 }, 680 { 681 "name": "screencastFrame", 682 "description": "Compressed image data requested by the <code>startScreencast</code>.", 683 "parameters": [ 684 { "name": "data", "type": "string", "description": "Base64-encoded compressed image." }, 685 { "name": "metadata", "$ref": "ScreencastFrameMetadata", "description": "Screencast frame metadata"} 686 ], 687 "hidden": true, 688 "handlers": ["browser"] 689 }, 690 { 691 "name": "screencastVisibilityChanged", 692 "description": "Fired when the page with currently enabled screencast was shown or hidden </code>.", 693 "parameters": [ 694 { "name": "visible", "type": "boolean", "description": "True if the page is visible." } 695 ], 696 "hidden": true, 697 "handlers": ["browser"] 698 }, 699 { 700 "name": "viewportChanged", 701 "description": "Fired when a visible page viewport has changed.", 702 "parameters": [ 703 { "name": "viewport", "$ref": "Viewport", "description": "Viewport description." } 704 ], 705 "hidden": true 706 }, 707 { 708 "name": "colorPicked", 709 "description": "Fired when a color has been picked.", 710 "parameters": [ 711 { "name": "color", "$ref": "DOM.RGBA", "description": "RGBA of the picked color." } 712 ], 713 "hidden": true, 714 "handlers": ["browser"] 715 }, 716 { 717 "name": "interstitialShown", 718 "description": "Fired when interstitial page was shown", 719 "hidden": true, 720 "handlers": ["browser"] 721 }, 722 { 723 "name": "interstitialHidden", 724 "description": "Fired when interstitial page was hidden", 725 "hidden": true, 726 "handlers": ["browser"] 727 } 728 ] 729 }, 730 { 731 "domain": "Runtime", 732 "description": "Runtime domain exposes JavaScript runtime by means of remote evaluation and mirror objects. Evaluation results are returned as mirror object that expose object type, string representation and unique identifier that can be used for further object reference. Original objects are maintained in memory unless they are either explicitly released or are released along with the other objects in their object group.", 733 "types": [ 734 { 735 "id": "RemoteObjectId", 736 "type": "string", 737 "description": "Unique object identifier." 738 }, 739 { 740 "id": "RemoteObject", 741 "type": "object", 742 "description": "Mirror object referencing original JavaScript object.", 743 "properties": [ 744 { "name": "type", "type": "string", "enum": ["object", "function", "undefined", "string", "number", "boolean", "symbol"], "description": "Object type." }, 745 { "name": "subtype", "type": "string", "optional": true, "enum": ["array", "null", "node", "regexp", "date", "map", "set"], "description": "Object subtype hint. Specified for <code>object</code> type values only." }, 746 { "name": "className", "type": "string", "optional": true, "description": "Object class (constructor) name. Specified for <code>object</code> type values only." }, 747 { "name": "value", "type": "any", "optional": true, "description": "Remote object value in case of primitive values or JSON values (if it was requested), or description string if the value can not be JSON-stringified (like NaN, Infinity, -Infinity, -0)." }, 748 { "name": "description", "type": "string", "optional": true, "description": "String representation of the object." }, 749 { "name": "objectId", "$ref": "RemoteObjectId", "optional": true, "description": "Unique object identifier (for non-primitive values)." }, 750 { "name": "preview", "$ref": "ObjectPreview", "optional": true, "description": "Preview containing abbreviated property values. Specified for <code>object</code> type values only.", "hidden": true } 751 ] 752 }, 753 { 754 "id": "ObjectPreview", 755 "type": "object", 756 "hidden": true, 757 "description": "Object containing abbreviated remote object value.", 758 "properties": [ 759 { "name": "type", "type": "string", "enum": ["object", "function", "undefined", "string", "number", "boolean", "symbol"], "description": "Object type." }, 760 { "name": "subtype", "type": "string", "optional": true, "enum": ["array", "null", "node", "regexp", "date", "map", "set"], "description": "Object subtype hint. Specified for <code>object</code> type values only." }, 761 { "name": "description", "type": "string", "optional": true, "description": "String representation of the object." }, 762 { "name": "lossless", "type": "boolean", "description": "Determines whether preview is lossless (contains all information of the original object)." }, 763 { "name": "overflow", "type": "boolean", "description": "True iff some of the properties or entries of the original object did not fit." }, 764 { "name": "properties", "type": "array", "items": { "$ref": "PropertyPreview" }, "description": "List of the properties." }, 765 { "name": "entries", "type": "array", "items": { "$ref": "EntryPreview" }, "optional": true, "description": "List of the entries. Specified for <code>map</code> and <code>set</code> subtype values only." } 766 ] 767 }, 768 { 769 "id": "PropertyPreview", 770 "type": "object", 771 "hidden": true, 772 "properties": [ 773 { "name": "name", "type": "string", "description": "Property name." }, 774 { "name": "type", "type": "string", "enum": ["object", "function", "undefined", "string", "number", "boolean", "symbol", "accessor"], "description": "Object type. Accessor means that the property itself is an accessor property." }, 775 { "name": "value", "type": "string", "optional": true, "description": "User-friendly property value string." }, 776 { "name": "valuePreview", "$ref": "ObjectPreview", "optional": true, "description": "Nested value preview." }, 777 { "name": "subtype", "type": "string", "optional": true, "enum": ["array", "null", "node", "regexp", "date", "map", "set"], "description": "Object subtype hint. Specified for <code>object</code> type values only." } 778 ] 779 }, 780 { 781 "id": "EntryPreview", 782 "type": "object", 783 "hidden": true, 784 "properties": [ 785 { "name": "key", "$ref": "ObjectPreview", "optional": true, "description": "Preview of the key. Specified for map-like collection entries." }, 786 { "name": "value", "$ref": "ObjectPreview", "description": "Preview of the value." } 787 ] 788 }, 789 { 790 "id": "PropertyDescriptor", 791 "type": "object", 792 "description": "Object property descriptor.", 793 "properties": [ 794 { "name": "name", "type": "string", "description": "Property name or symbol description." }, 795 { "name": "value", "$ref": "RemoteObject", "optional": true, "description": "The value associated with the property." }, 796 { "name": "writable", "type": "boolean", "optional": true, "description": "True if the value associated with the property may be changed (data descriptors only)." }, 797 { "name": "get", "$ref": "RemoteObject", "optional": true, "description": "A function which serves as a getter for the property, or <code>undefined</code> if there is no getter (accessor descriptors only)." }, 798 { "name": "set", "$ref": "RemoteObject", "optional": true, "description": "A function which serves as a setter for the property, or <code>undefined</code> if there is no setter (accessor descriptors only)." }, 799 { "name": "configurable", "type": "boolean", "description": "True if the type of this property descriptor may be changed and if the property may be deleted from the corresponding object." }, 800 { "name": "enumerable", "type": "boolean", "description": "True if this property shows up during enumeration of the properties on the corresponding object." }, 801 { "name": "wasThrown", "type": "boolean", "optional": true, "description": "True if the result was thrown during the evaluation." }, 802 { "name": "isOwn", "optional": true, "type": "boolean", "description": "True if the property is owned for the object.", "hidden": true }, 803 { "name": "symbol", "$ref": "RemoteObject", "optional": true, "description": "Property symbol object, if the property is of the <code>symbol</code> type.", "hidden": true } 804 ] 805 }, 806 { 807 "id": "InternalPropertyDescriptor", 808 "type": "object", 809 "description": "Object internal property descriptor. This property isn't normally visible in JavaScript code.", 810 "properties": [ 811 { "name": "name", "type": "string", "description": "Conventional property name." }, 812 { "name": "value", "$ref": "RemoteObject", "optional": true, "description": "The value associated with the property." } 813 ], 814 "hidden": true 815 }, 816 { 817 "id": "CallArgument", 818 "type": "object", 819 "description": "Represents function call argument. Either remote object id <code>objectId</code> or primitive <code>value</code> or neither of (for undefined) them should be specified.", 820 "properties": [ 821 { "name": "value", "type": "any", "optional": true, "description": "Primitive value, or description string if the value can not be JSON-stringified (like NaN, Infinity, -Infinity, -0)." }, 822 { "name": "objectId", "$ref": "RemoteObjectId", "optional": true, "description": "Remote object handle." }, 823 { "name": "type", "optional": true, "hidden": true, "type": "string", "enum": ["object", "function", "undefined", "string", "number", "boolean", "symbol"], "description": "Object type." } 824 ] 825 }, 826 { 827 "id": "ExecutionContextId", 828 "type": "integer", 829 "description": "Id of an execution context." 830 }, 831 { 832 "id": "ExecutionContextDescription", 833 "type": "object", 834 "description": "Description of an isolated world.", 835 "properties": [ 836 { "name": "id", "$ref": "ExecutionContextId", "description": "Unique id of the execution context. It can be used to specify in which execution context script evaluation should be performed." }, 837 { "name": "isPageContext", "type": "boolean", "description": "True if this is a context where inpspected web page scripts run. False if it is a content script isolated context.", "hidden": true }, 838 { "name": "origin", "type": "string", "description": "Execution context origin.", "hidden": true}, 839 { "name": "name", "type": "string", "description": "Human readable name describing given context.", "hidden": true}, 840 { "name": "frameId", "$ref": "Page.FrameId", "description": "Id of the owning frame." } 841 ] 842 } 843 844 ], 845 "commands": [ 846 { 847 "name": "evaluate", 848 "parameters": [ 849 { "name": "expression", "type": "string", "description": "Expression to evaluate." }, 850 { "name": "objectGroup", "type": "string", "optional": true, "description": "Symbolic group name that can be used to release multiple objects." }, 851 { "name": "includeCommandLineAPI", "type": "boolean", "optional": true, "description": "Determines whether Command Line API should be available during the evaluation.", "hidden": true }, 852 { "name": "doNotPauseOnExceptionsAndMuteConsole", "type": "boolean", "optional": true, "description": "Specifies whether evaluation should stop on exceptions and mute console. Overrides setPauseOnException state.", "hidden": true }, 853 { "name": "contextId", "$ref": "Runtime.ExecutionContextId", "optional": true, "description": "Specifies in which isolated context to perform evaluation. Each content script lives in an isolated context and this parameter may be used to specify one of those contexts. If the parameter is omitted or 0 the evaluation will be performed in the context of the inspected page." }, 854 { "name": "returnByValue", "type": "boolean", "optional": true, "description": "Whether the result is expected to be a JSON object that should be sent by value." }, 855 { "name": "generatePreview", "type": "boolean", "optional": true, "hidden": true, "description": "Whether preview should be generated for the result." } 856 ], 857 "returns": [ 858 { "name": "result", "$ref": "RemoteObject", "description": "Evaluation result." }, 859 { "name": "wasThrown", "type": "boolean", "optional": true, "description": "True if the result was thrown during the evaluation." }, 860 { "name": "exceptionDetails", "$ref": "Debugger.ExceptionDetails", "optional": true, "hidden": true, "description": "Exception details."} 861 ], 862 "description": "Evaluates expression on global object." 863 }, 864 { 865 "name": "callFunctionOn", 866 "parameters": [ 867 { "name": "objectId", "$ref": "RemoteObjectId", "description": "Identifier of the object to call function on." }, 868 { "name": "functionDeclaration", "type": "string", "description": "Declaration of the function to call." }, 869 { "name": "arguments", "type": "array", "items": { "$ref": "CallArgument", "description": "Call argument." }, "optional": true, "description": "Call arguments. All call arguments must belong to the same JavaScript world as the target object." }, 870 { "name": "doNotPauseOnExceptionsAndMuteConsole", "type": "boolean", "optional": true, "description": "Specifies whether function call should stop on exceptions and mute console. Overrides setPauseOnException state.", "hidden": true }, 871 { "name": "returnByValue", "type": "boolean", "optional": true, "description": "Whether the result is expected to be a JSON object which should be sent by value." }, 872 { "name": "generatePreview", "type": "boolean", "optional": true, "hidden": true, "description": "Whether preview should be generated for the result." } 873 ], 874 "returns": [ 875 { "name": "result", "$ref": "RemoteObject", "description": "Call result." }, 876 { "name": "wasThrown", "type": "boolean", "optional": true, "description": "True if the result was thrown during the evaluation." } 877 ], 878 "description": "Calls function with given declaration on the given object. Object group of the result is inherited from the target object." 879 }, 880 { 881 "name": "getProperties", 882 "parameters": [ 883 { "name": "objectId", "$ref": "RemoteObjectId", "description": "Identifier of the object to return properties for." }, 884 { "name": "ownProperties", "optional": true, "type": "boolean", "description": "If true, returns properties belonging only to the element itself, not to its prototype chain." }, 885 { "name": "accessorPropertiesOnly", "optional": true, "type": "boolean", "description": "If true, returns accessor properties (with getter/setter) only; internal properties are not returned either.", "hidden": true } 886 ], 887 "returns": [ 888 { "name": "result", "type": "array", "items": { "$ref": "PropertyDescriptor" }, "description": "Object properties." }, 889 { "name": "internalProperties", "optional": true, "type": "array", "items": { "$ref": "InternalPropertyDescriptor" }, "description": "Internal object properties (only of the element itself).", "hidden": true } 890 ], 891 "description": "Returns properties of a given object. Object group of the result is inherited from the target object." 892 }, 893 { 894 "name": "releaseObject", 895 "parameters": [ 896 { "name": "objectId", "$ref": "RemoteObjectId", "description": "Identifier of the object to release." } 897 ], 898 "description": "Releases remote object with given id." 899 }, 900 { 901 "name": "releaseObjectGroup", 902 "parameters": [ 903 { "name": "objectGroup", "type": "string", "description": "Symbolic object group name." } 904 ], 905 "description": "Releases all remote objects that belong to a given group." 906 }, 907 { 908 "name": "run", 909 "hidden": true, 910 "description": "Tells inspected instance(worker or page) that it can run in case it was started paused." 911 }, 912 { 913 "name": "enable", 914 "description": "Enables reporting of execution contexts creation by means of <code>executionContextCreated</code> event. When the reporting gets enabled the event will be sent immediately for each existing execution context." 915 }, 916 { 917 "name": "disable", 918 "hidden": true, 919 "description": "Disables reporting of execution contexts creation." 920 }, 921 { 922 "name": "isRunRequired", 923 "returns": [ 924 { "name": "result", "type": "boolean", "description": "True if the Runtime is in paused on start state." } 925 ], 926 "hidden": true 927 } 928 ], 929 "events": [ 930 { 931 "name": "executionContextCreated", 932 "parameters": [ 933 { "name": "context", "$ref": "ExecutionContextDescription", "description": "A newly created execution contex." } 934 ], 935 "description": "Issued when new execution context is created." 936 }, 937 { 938 "name": "executionContextDestroyed", 939 "parameters": [ 940 { "name": "executionContextId", "$ref": "ExecutionContextId", "description": "Id of the destroyed context" } 941 ], 942 "description": "Issued when execution context is destroyed." 943 }, 944 { 945 "name": "executionContextsCleared", 946 "description": "Issued when all executionContexts were cleared in browser" 947 } 948 ] 949 }, 950 { 951 "domain": "Console", 952 "description": "Console domain defines methods and events for interaction with the JavaScript console. Console collects messages created by means of the <a href='http://getfirebug.com/wiki/index.php/Console_API'>JavaScript Console API</a>. One needs to enable this domain using <code>enable</code> command in order to start receiving the console messages. Browser collects messages issued while console domain is not enabled as well and reports them using <code>messageAdded</code> notification upon enabling.", 953 "types": [ 954 { 955 "id": "Timestamp", 956 "type": "number", 957 "description": "Number of seconds since epoch.", 958 "hidden": true 959 }, 960 { 961 "id": "ConsoleMessage", 962 "type": "object", 963 "description": "Console message.", 964 "properties": [ 965 { "name": "source", "type": "string", "enum": ["xml", "javascript", "network", "console-api", "storage", "appcache", "rendering", "css", "security", "other", "deprecation"], "description": "Message source." }, 966 { "name": "level", "type": "string", "enum": ["log", "warning", "error", "debug", "info"], "description": "Message severity." }, 967 { "name": "text", "type": "string", "description": "Message text." }, 968 { "name": "type", "type": "string", "optional": true, "enum": ["log", "dir", "dirxml", "table", "trace", "clear", "startGroup", "startGroupCollapsed", "endGroup", "assert", "profile", "profileEnd"], "description": "Console message type." }, 969 { "name": "scriptId", "type": "string", "optional": true, "description": "Script ID of the message origin." }, 970 { "name": "url", "type": "string", "optional": true, "description": "URL of the message origin." }, 971 { "name": "line", "type": "integer", "optional": true, "description": "Line number in the resource that generated this message." }, 972 { "name": "column", "type": "integer", "optional": true, "description": "Column number in the resource that generated this message." }, 973 { "name": "repeatCount", "type": "integer", "optional": true, "description": "Repeat count for repeated messages." }, 974 { "name": "parameters", "type": "array", "items": { "$ref": "Runtime.RemoteObject" }, "optional": true, "description": "Message parameters in case of the formatted message." }, 975 { "name": "stackTrace", "$ref": "StackTrace", "optional": true, "description": "JavaScript stack trace for assertions and error messages." }, 976 { "name": "asyncStackTrace", "$ref": "AsyncStackTrace", "optional": true, "description": "Asynchronous JavaScript stack trace that preceded this message, if available.", "hidden": true }, 977 { "name": "networkRequestId", "$ref": "Network.RequestId", "optional": true, "description": "Identifier of the network request associated with this message." }, 978 { "name": "timestamp", "$ref": "Timestamp", "description": "Timestamp, when this message was fired.", "hidden": true }, 979 { "name": "executionContextId", "$ref": "Runtime.ExecutionContextId", "optional": true, "description": "Identifier of the context where this message was created", "hidden": true } 980 ] 981 }, 982 { 983 "id": "CallFrame", 984 "type": "object", 985 "description": "Stack entry for console errors and assertions.", 986 "properties": [ 987 { "name": "functionName", "type": "string", "description": "JavaScript function name." }, 988 { "name": "scriptId", "type": "string", "description": "JavaScript script id." }, 989 { "name": "url", "type": "string", "description": "JavaScript script name or url." }, 990 { "name": "lineNumber", "type": "integer", "description": "JavaScript script line number." }, 991 { "name": "columnNumber", "type": "integer", "description": "JavaScript script column number." } 992 ] 993 }, 994 { 995 "id": "StackTrace", 996 "type": "array", 997 "items": { "$ref": "CallFrame" }, 998 "description": "Call frames for assertions or error messages." 999 }, 1000 { 1001 "id": "AsyncStackTrace", 1002 "type": "object", 1003 "properties": [ 1004 { "name": "callFrames", "type": "array", "items": { "$ref": "CallFrame" }, "description": "Call frames of the stack trace." }, 1005 { "name": "description", "type": "string", "optional": true, "description": "String label of this stack trace. For async traces this may be a name of the function that initiated the async call." }, 1006 { "name": "asyncStackTrace", "$ref": "AsyncStackTrace", "optional": true, "description": "Next asynchronous stack trace, if any." } 1007 ], 1008 "description": "Asynchronous JavaScript call stack.", 1009 "hidden": true 1010 } 1011 ], 1012 "commands": [ 1013 { 1014 "name": "enable", 1015 "description": "Enables console domain, sends the messages collected so far to the client by means of the <code>messageAdded</code> notification." 1016 }, 1017 { 1018 "name": "disable", 1019 "description": "Disables console domain, prevents further console messages from being reported to the client." 1020 }, 1021 { 1022 "name": "clearMessages", 1023 "description": "Clears console messages collected in the browser." 1024 }, 1025 { 1026 "name": "setMonitoringXHREnabled", 1027 "parameters": [ 1028 { "name": "enabled", "type": "boolean", "description": "Monitoring enabled state." } 1029 ], 1030 "description": "Toggles monitoring of XMLHttpRequest. If <code>true</code>, console will receive messages upon each XHR issued.", 1031 "hidden": true 1032 }, 1033 { 1034 "name": "addInspectedNode", 1035 "parameters": [ 1036 { "name": "nodeId", "$ref": "DOM.NodeId", "description": "DOM node id to be accessible by means of $x command line API." } 1037 ], 1038 "description": "Enables console to refer to the node with given id via $x (see Command Line API for more details $x functions).", 1039 "hidden": true 1040 }, 1041 { 1042 "name": "addInspectedHeapObject", 1043 "parameters": [ 1044 { "name": "heapObjectId", "type": "integer" } 1045 ], 1046 "hidden": true 1047 }, 1048 { 1049 "name": "setTracingBasedTimeline", 1050 "parameters": [ 1051 { "name": "enabled", "type": "boolean", "description": "Switch console.timeline to tracing based." } 1052 ], 1053 "hidden": true 1054 } 1055 ], 1056 "events": [ 1057 { 1058 "name": "messageAdded", 1059 "parameters": [ 1060 { "name": "message", "$ref": "ConsoleMessage", "description": "Console message that has been added." } 1061 ], 1062 "description": "Issued when new console message is added." 1063 }, 1064 { 1065 "name": "messageRepeatCountUpdated", 1066 "parameters": [ 1067 { "name": "count", "type": "integer", "description": "New repeat count value." }, 1068 { "name": "timestamp", "$ref": "Timestamp", "description": "Timestamp of most recent message in batch.", "hidden": true } 1069 ], 1070 "description": "Is not issued. Will be gone in the future versions of the protocol.", 1071 "deprecated": true 1072 }, 1073 { 1074 "name": "messagesCleared", 1075 "description": "Issued when console is cleared. This happens either upon <code>clearMessages</code> command or after page navigation." 1076 } 1077 ] 1078 }, 1079 { 1080 "domain": "Network", 1081 "description": "Network domain allows tracking network activities of the page. It exposes information about http, file, data and other requests and responses, their headers, bodies, timing, etc.", 1082 "types": [ 1083 { 1084 "id": "LoaderId", 1085 "type": "string", 1086 "description": "Unique loader identifier." 1087 }, 1088 { 1089 "id": "RequestId", 1090 "type": "string", 1091 "description": "Unique request identifier." 1092 }, 1093 { 1094 "id": "Timestamp", 1095 "type": "number", 1096 "description": "Number of seconds since epoch." 1097 }, 1098 { 1099 "id": "Headers", 1100 "type": "object", 1101 "description": "Request / response headers as keys / values of JSON object." 1102 }, 1103 { 1104 "id": "ResourceTiming", 1105 "type": "object", 1106 "description": "Timing information for the request.", 1107 "properties": [ 1108 { "name": "requestTime", "type": "number", "description": "Timing's requestTime is a baseline in seconds, while the other numbers are ticks in milliseconds relatively to this requestTime." }, 1109 { "name": "proxyStart", "type": "number", "description": "Started resolving proxy." }, 1110 { "name": "proxyEnd", "type": "number", "description": "Finished resolving proxy." }, 1111 { "name": "dnsStart", "type": "number", "description": "Started DNS address resolve." }, 1112 { "name": "dnsEnd", "type": "number", "description": "Finished DNS address resolve." }, 1113 { "name": "connectStart", "type": "number", "description": "Started connecting to the remote host." }, 1114 { "name": "connectEnd", "type": "number", "description": "Connected to the remote host." }, 1115 { "name": "sslStart", "type": "number", "description": "Started SSL handshake." }, 1116 { "name": "sslEnd", "type": "number", "description": "Finished SSL handshake." }, 1117 { "name": "serviceWorkerFetchStart", "type": "number", "description": "Started fetching via ServiceWorker.", "hidden": true }, 1118 { "name": "serviceWorkerFetchReady", "type": "number", "description": "Prepared a ServiceWorker.", "hidden": true }, 1119 { "name": "serviceWorkerFetchEnd", "type": "number", "description": "Finished fetching via ServiceWorker.", "hidden": true }, 1120 { "name": "sendStart", "type": "number", "description": "Started sending request." }, 1121 { "name": "sendEnd", "type": "number", "description": "Finished sending request." }, 1122 { "name": "receiveHeadersEnd", "type": "number", "description": "Finished receiving response headers." } 1123 ] 1124 }, 1125 { 1126 "id": "Request", 1127 "type": "object", 1128 "description": "HTTP request data.", 1129 "properties": [ 1130 { "name": "url", "type": "string", "description": "Request URL." }, 1131 { "name": "method", "type": "string", "description": "HTTP request method." }, 1132 { "name": "headers", "$ref": "Headers", "description": "HTTP request headers." }, 1133 { "name": "postData", "type": "string", "optional": true, "description": "HTTP POST request data." } 1134 ] 1135 }, 1136 { 1137 "id": "Response", 1138 "type": "object", 1139 "description": "HTTP response data.", 1140 "properties": [ 1141 { "name": "url", "type": "string", "description": "Response URL. This URL can be different from CachedResource.url in case of redirect." }, 1142 { "name": "status", "type": "number", "description": "HTTP response status code." }, 1143 { "name": "statusText", "type": "string", "description": "HTTP response status text." }, 1144 { "name": "headers", "$ref": "Headers", "description": "HTTP response headers." }, 1145 { "name": "headersText", "type": "string", "optional": true, "description": "HTTP response headers text." }, 1146 { "name": "mimeType", "type": "string", "description": "Resource mimeType as determined by the browser." }, 1147 { "name": "requestHeaders", "$ref": "Headers", "optional": true, "description": "Refined HTTP request headers that were actually transmitted over the network." }, 1148 { "name": "requestHeadersText", "type": "string", "optional": true, "description": "HTTP request headers text." }, 1149 { "name": "connectionReused", "type": "boolean", "description": "Specifies whether physical connection was actually reused for this request." }, 1150 { "name": "connectionId", "type": "number", "description": "Physical connection id that was actually used for this request." }, 1151 { "name": "remoteIPAddress", "type": "string", "optional": true, "hidden": true, "description": "Remote IP address." }, 1152 { "name": "remotePort", "type": "integer", "optional": true, "hidden": true, "description": "Remote port."}, 1153 { "name": "fromDiskCache", "type": "boolean", "optional": true, "description": "Specifies that the request was served from the disk cache." }, 1154 { "name": "fromServiceWorker", "type": "boolean", "optional": true, "description": "Specifies that the request was served from the ServiceWorker." }, 1155 { "name": "encodedDataLength", "type": "number", "optional": false, "description": "Total number of bytes received for this request so far." }, 1156 { "name": "timing", "$ref": "ResourceTiming", "optional": true, "description": "Timing information for the given request." } 1157 ] 1158 }, 1159 { 1160 "id": "WebSocketRequest", 1161 "type": "object", 1162 "description": "WebSocket request data.", 1163 "hidden": true, 1164 "properties": [ 1165 { "name": "headers", "$ref": "Headers", "description": "HTTP request headers." } 1166 ] 1167 }, 1168 { 1169 "id": "WebSocketResponse", 1170 "type": "object", 1171 "description": "WebSocket response data.", 1172 "hidden": true, 1173 "properties": [ 1174 { "name": "status", "type": "number", "description": "HTTP response status code." }, 1175 { "name": "statusText", "type": "string", "description": "HTTP response status text." }, 1176 { "name": "headers", "$ref": "Headers", "description": "HTTP response headers." }, 1177 { "name": "headersText", "type": "string", "optional": true, "description": "HTTP response headers text." }, 1178 { "name": "requestHeaders", "$ref": "Headers", "optional": true, "description": "HTTP request headers." }, 1179 { "name": "requestHeadersText", "type": "string", "optional": true, "description": "HTTP request headers text." } 1180 ] 1181 }, 1182 { 1183 "id": "WebSocketFrame", 1184 "type": "object", 1185 "description": "WebSocket frame data.", 1186 "hidden": true, 1187 "properties": [ 1188 { "name": "opcode", "type": "number", "description": "WebSocket frame opcode." }, 1189 { "name": "mask", "type": "boolean", "description": "WebSocke frame mask." }, 1190 { "name": "payloadData", "type": "string", "description": "WebSocke frame payload data." } 1191 ] 1192 }, 1193 { 1194 "id": "CachedResource", 1195 "type": "object", 1196 "description": "Information about the cached resource.", 1197 "properties": [ 1198 { "name": "url", "type": "string", "description": "Resource URL. This is the url of the original network request." }, 1199 { "name": "type", "$ref": "Page.ResourceType", "description": "Type of this resource." }, 1200 { "name": "response", "$ref": "Response", "optional": true, "description": "Cached response data." }, 1201 { "name": "bodySize", "type": "number", "description": "Cached response body size." } 1202 ] 1203 }, 1204 { 1205 "id": "Initiator", 1206 "type": "object", 1207 "description": "Information about the request initiator.", 1208 "properties": [ 1209 { "name": "type", "type": "string", "enum": ["parser", "script", "other"], "description": "Type of this initiator." }, 1210 { "name": "stackTrace", "$ref": "Console.StackTrace", "optional": true, "description": "Initiator JavaScript stack trace, set for Script only." }, 1211 { "name": "url", "type": "string", "optional": true, "description": "Initiator URL, set for Parser type only." }, 1212 { "name": "lineNumber", "type": "number", "optional": true, "description": "Initiator line number, set for Parser type only." }, 1213 { "name": "asyncStackTrace", "$ref": "Console.AsyncStackTrace", "optional": true, "description": "Initiator asynchronous JavaScript stack trace, if available.", "hidden": true } 1214 ] 1215 } 1216 ], 1217 "commands": [ 1218 { 1219 "name": "enable", 1220 "description": "Enables network tracking, network events will now be delivered to the client." 1221 }, 1222 { 1223 "name": "disable", 1224 "description": "Disables network tracking, prevents network events from being sent to the client." 1225 }, 1226 { 1227 "name": "setUserAgentOverride", 1228 "description": "Allows overriding user agent with the given string.", 1229 "parameters": [ 1230 { "name": "userAgent", "type": "string", "description": "User agent to use." } 1231 ] 1232 }, 1233 { 1234 "name": "setExtraHTTPHeaders", 1235 "description": "Specifies whether to always send extra HTTP headers with the requests from this page.", 1236 "parameters": [ 1237 { "name": "headers", "$ref": "Headers", "description": "Map with extra HTTP headers." } 1238 ] 1239 }, 1240 { 1241 "name": "getResponseBody", 1242 "description": "Returns content served for the given request.", 1243 "parameters": [ 1244 { "name": "requestId", "$ref": "RequestId", "description": "Identifier of the network request to get content for." } 1245 ], 1246 "returns": [ 1247 { "name": "body", "type": "string", "description": "Response body." }, 1248 { "name": "base64Encoded", "type": "boolean", "description": "True, if content was sent as base64." } 1249 ] 1250 }, 1251 { 1252 "name": "replayXHR", 1253 "description": "This method sends a new XMLHttpRequest which is identical to the original one. The following parameters should be identical: method, url, async, request body, extra headers, withCredentials attribute, user, password.", 1254 "parameters": [ 1255 { "name": "requestId", "$ref": "RequestId", "description": "Identifier of XHR to replay." } 1256 ], 1257 "hidden": true 1258 }, 1259 { 1260 "name": "canClearBrowserCache", 1261 "description": "Tells whether clearing browser cache is supported.", 1262 "returns": [ 1263 { "name": "result", "type": "boolean", "description": "True if browser cache can be cleared." } 1264 ] 1265 }, 1266 { 1267 "name": "clearBrowserCache", 1268 "description": "Clears browser cache.", 1269 "handlers": ["browser"] 1270 }, 1271 { 1272 "name": "canClearBrowserCookies", 1273 "description": "Tells whether clearing browser cookies is supported.", 1274 "returns": [ 1275 { "name": "result", "type": "boolean", "description": "True if browser cookies can be cleared." } 1276 ] 1277 }, 1278 { 1279 "name": "clearBrowserCookies", 1280 "description": "Clears browser cookies.", 1281 "handlers": ["browser"] 1282 }, 1283 { 1284 "name": "canEmulateNetworkConditions", 1285 "description": "Tells whether emulation of network conditions is supported.", 1286 "returns": [ 1287 { "name": "result", "type": "boolean", "description": "True if emulation of network conditions is supported." } 1288 ], 1289 "hidden": true, 1290 "handlers": ["browser"] 1291 }, 1292 { 1293 "name": "emulateNetworkConditions", 1294 "description": "Activates emulation of network conditions.", 1295 "parameters": [ 1296 { "name": "offline", "type": "boolean", "description": "True to emulate internet disconnection." }, 1297 { "name": "latency", "type": "number", "description": "Additional latency (ms)." }, 1298 { "name": "downloadThroughput", "type": "number", "description": "Maximal aggregated download throughput." }, 1299 { "name": "uploadThroughput", "type": "number", "description": "Maximal aggregated upload throughput." } 1300 ], 1301 "hidden": true, 1302 "handlers": ["browser", "renderer"] 1303 }, 1304 { 1305 "name": "setCacheDisabled", 1306 "parameters": [ 1307 { "name": "cacheDisabled", "type": "boolean", "description": "Cache disabled state." } 1308 ], 1309 "description": "Toggles ignoring cache for each request. If <code>true</code>, cache will not be used." 1310 }, 1311 { 1312 "name": "loadResourceForFrontend", 1313 "async": true, 1314 "parameters": [ 1315 { "name": "frameId", "$ref": "Page.FrameId", "description": "Frame to load the resource from." }, 1316 { "name": "url", "type": "string", "description": "URL of the resource to load." }, 1317 { "name": "requestHeaders", "$ref": "Network.Headers", "optional": true, "description": "Request headers." } 1318 ], 1319 "returns": [ 1320 { "name": "statusCode", "type": "number", "description": "HTTP status code." }, 1321 { "name": "responseHeaders", "$ref": "Network.Headers", "description": "Response headers." }, 1322 { "name": "content", "type": "string", "description": "Resource content." } 1323 ], 1324 "description": "Loads a resource in the context of a frame on the inspected page without cross origin checks.", 1325 "hidden": true 1326 } 1327 ], 1328 "events": [ 1329 { 1330 "name": "requestWillBeSent", 1331 "description": "Fired when page is about to send HTTP request.", 1332 "parameters": [ 1333 { "name": "requestId", "$ref": "RequestId", "description": "Request identifier." }, 1334 { "name": "frameId", "$ref": "Page.FrameId", "description": "Frame identifier.", "hidden": true }, 1335 { "name": "loaderId", "$ref": "LoaderId", "description": "Loader identifier." }, 1336 { "name": "documentURL", "type": "string", "description": "URL of the document this request is loaded for." }, 1337 { "name": "request", "$ref": "Request", "description": "Request data." }, 1338 { "name": "timestamp", "$ref": "Timestamp", "description": "Timestamp." }, 1339 { "name": "initiator", "$ref": "Initiator", "description": "Request initiator." }, 1340 { "name": "redirectResponse", "optional": true, "$ref": "Response", "description": "Redirect response data." } 1341 ] 1342 }, 1343 { 1344 "name": "requestServedFromCache", 1345 "description": "Fired if request ended up loading from cache.", 1346 "parameters": [ 1347 { "name": "requestId", "$ref": "RequestId", "description": "Request identifier." } 1348 ] 1349 }, 1350 { 1351 "name": "responseReceived", 1352 "description": "Fired when HTTP response is available.", 1353 "parameters": [ 1354 { "name": "requestId", "$ref": "RequestId", "description": "Request identifier." }, 1355 { "name": "frameId", "$ref": "Page.FrameId", "description": "Frame identifier.", "hidden": true }, 1356 { "name": "loaderId", "$ref": "LoaderId", "description": "Loader identifier." }, 1357 { "name": "timestamp", "$ref": "Timestamp", "description": "Timestamp." }, 1358 { "name": "type", "$ref": "Page.ResourceType", "description": "Resource type." }, 1359 { "name": "response", "$ref": "Response", "description": "Response data." } 1360 ] 1361 }, 1362 { 1363 "name": "dataReceived", 1364 "description": "Fired when data chunk was received over the network.", 1365 "parameters": [ 1366 { "name": "requestId", "$ref": "RequestId", "description": "Request identifier." }, 1367 { "name": "timestamp", "$ref": "Timestamp", "description": "Timestamp." }, 1368 { "name": "dataLength", "type": "integer", "description": "Data chunk length." }, 1369 { "name": "encodedDataLength", "type": "integer", "description": "Actual bytes received (might be less than dataLength for compressed encodings)." } 1370 ] 1371 }, 1372 { 1373 "name": "loadingFinished", 1374 "description": "Fired when HTTP request has finished loading.", 1375 "parameters": [ 1376 { "name": "requestId", "$ref": "RequestId", "description": "Request identifier." }, 1377 { "name": "timestamp", "$ref": "Timestamp", "description": "Timestamp." }, 1378 { "name": "encodedDataLength", "type": "number", "description": "Total number of bytes received for this request." } 1379 ] 1380 }, 1381 { 1382 "name": "loadingFailed", 1383 "description": "Fired when HTTP request has failed to load.", 1384 "parameters": [ 1385 { "name": "requestId", "$ref": "RequestId", "description": "Request identifier." }, 1386 { "name": "timestamp", "$ref": "Timestamp", "description": "Timestamp." }, 1387 { "name": "type", "$ref": "Page.ResourceType", "description": "Resource type." }, 1388 { "name": "errorText", "type": "string", "description": "User friendly error message." }, 1389 { "name": "canceled", "type": "boolean", "optional": true, "description": "True if loading was canceled." } 1390 ] 1391 }, 1392 { 1393 "name": "webSocketWillSendHandshakeRequest", 1394 "description": "Fired when WebSocket is about to initiate handshake.", 1395 "parameters": [ 1396 { "name": "requestId", "$ref": "RequestId", "description": "Request identifier." }, 1397 { "name": "timestamp", "$ref": "Timestamp", "description": "Timestamp." }, 1398 { "name": "request", "$ref": "WebSocketRequest", "description": "WebSocket request data." } 1399 ], 1400 "hidden": true 1401 }, 1402 { 1403 "name": "webSocketHandshakeResponseReceived", 1404 "description": "Fired when WebSocket handshake response becomes available.", 1405 "parameters": [ 1406 { "name": "requestId", "$ref": "RequestId", "description": "Request identifier." }, 1407 { "name": "timestamp", "$ref": "Timestamp", "description": "Timestamp." }, 1408 { "name": "response", "$ref": "WebSocketResponse", "description": "WebSocket response data." } 1409 ], 1410 "hidden": true 1411 }, 1412 { 1413 "name": "webSocketCreated", 1414 "description": "Fired upon WebSocket creation.", 1415 "parameters": [ 1416 { "name": "requestId", "$ref": "RequestId", "description": "Request identifier." }, 1417 { "name": "url", "type": "string", "description": "WebSocket request URL." } 1418 ], 1419 "hidden": true 1420 }, 1421 { 1422 "name": "webSocketClosed", 1423 "description": "Fired when WebSocket is closed.", 1424 "parameters": [ 1425 { "name": "requestId", "$ref": "RequestId", "description": "Request identifier." }, 1426 { "name": "timestamp", "$ref": "Timestamp", "description": "Timestamp." } 1427 ], 1428 "hidden": true 1429 }, 1430 { 1431 "name": "webSocketFrameReceived", 1432 "description": "Fired when WebSocket frame is received.", 1433 "parameters": [ 1434 { "name": "requestId", "$ref": "RequestId", "description": "Request identifier." }, 1435 { "name": "timestamp", "$ref": "Timestamp", "description": "Timestamp." }, 1436 { "name": "response", "$ref": "WebSocketFrame", "description": "WebSocket response data." } 1437 ], 1438 "hidden": true 1439 }, 1440 { 1441 "name": "webSocketFrameError", 1442 "description": "Fired when WebSocket frame error occurs.", 1443 "parameters": [ 1444 { "name": "requestId", "$ref": "RequestId", "description": "Request identifier." }, 1445 { "name": "timestamp", "$ref": "Timestamp", "description": "Timestamp." }, 1446 { "name": "errorMessage", "type": "string", "description": "WebSocket frame error message." } 1447 ], 1448 "hidden": true 1449 }, 1450 { 1451 "name": "webSocketFrameSent", 1452 "description": "Fired when WebSocket frame is sent.", 1453 "parameters": [ 1454 { "name": "requestId", "$ref": "RequestId", "description": "Request identifier." }, 1455 { "name": "timestamp", "$ref": "Timestamp", "description": "Timestamp." }, 1456 { "name": "response", "$ref": "WebSocketFrame", "description": "WebSocket response data." } 1457 ], 1458 "hidden": true 1459 } 1460 ] 1461 }, 1462 { 1463 "domain": "Database", 1464 "hidden": true, 1465 "types": [ 1466 { 1467 "id": "DatabaseId", 1468 "type": "string", 1469 "description": "Unique identifier of Database object.", 1470 "hidden": true 1471 }, 1472 { 1473 "id": "Database", 1474 "type": "object", 1475 "description": "Database object.", 1476 "hidden": true, 1477 "properties": [ 1478 { "name": "id", "$ref": "DatabaseId", "description": "Database ID." }, 1479 { "name": "domain", "type": "string", "description": "Database domain." }, 1480 { "name": "name", "type": "string", "description": "Database name." }, 1481 { "name": "version", "type": "string", "description": "Database version." } 1482 ] 1483 }, 1484 { 1485 "id": "Error", 1486 "type": "object", 1487 "description": "Database error.", 1488 "properties": [ 1489 { "name": "message", "type": "string", "description": "Error message." }, 1490 { "name": "code", "type": "integer", "description": "Error code." } 1491 ] 1492 } 1493 ], 1494 "commands": [ 1495 { 1496 "name": "enable", 1497 "description": "Enables database tracking, database events will now be delivered to the client." 1498 }, 1499 { 1500 "name": "disable", 1501 "description": "Disables database tracking, prevents database events from being sent to the client." 1502 }, 1503 { 1504 "name": "getDatabaseTableNames", 1505 "parameters": [ 1506 { "name": "databaseId", "$ref": "DatabaseId" } 1507 ], 1508 "returns": [ 1509 { "name": "tableNames", "type": "array", "items": { "type": "string" } } 1510 ] 1511 }, 1512 { 1513 "name": "executeSQL", 1514 "async": true, 1515 "parameters": [ 1516 { "name": "databaseId", "$ref": "DatabaseId" }, 1517 { "name": "query", "type": "string" } 1518 ], 1519 "returns": [ 1520 { "name": "columnNames", "type": "array", "optional": true, "items": { "type": "string" } }, 1521 { "name": "values", "type": "array", "optional": true, "items": { "type": "any" }}, 1522 { "name": "sqlError", "$ref": "Error", "optional": true } 1523 ] 1524 } 1525 ], 1526 "events": [ 1527 { 1528 "name": "addDatabase", 1529 "parameters": [ 1530 { "name": "database", "$ref": "Database" } 1531 ] 1532 } 1533 ] 1534 }, 1535 { 1536 "domain": "IndexedDB", 1537 "hidden": true, 1538 "types": [ 1539 { 1540 "id": "DatabaseWithObjectStores", 1541 "type": "object", 1542 "description": "Database with an array of object stores.", 1543 "properties": [ 1544 { "name": "name", "type": "string", "description": "Database name." }, 1545 { "name": "version", "type": "string", "description": "Deprecated string database version." }, 1546 { "name": "intVersion", "type": "integer", "description": "Integer database version." }, 1547 { "name": "objectStores", "type": "array", "items": { "$ref": "ObjectStore" }, "description": "Object stores in this database." } 1548 ] 1549 }, 1550 { 1551 "id": "ObjectStore", 1552 "type": "object", 1553 "description": "Object store.", 1554 "properties": [ 1555 { "name": "name", "type": "string", "description": "Object store name." }, 1556 { "name": "keyPath", "$ref": "KeyPath", "description": "Object store key path." }, 1557 { "name": "autoIncrement", "type": "boolean", "description": "If true, object store has auto increment flag set." }, 1558 { "name": "indexes", "type": "array", "items": { "$ref": "ObjectStoreIndex" }, "description": "Indexes in this object store." } 1559 ] 1560 }, 1561 { 1562 "id": "ObjectStoreIndex", 1563 "type": "object", 1564 "description": "Object store index.", 1565 "properties": [ 1566 { "name": "name", "type": "string", "description": "Index name." }, 1567 { "name": "keyPath", "$ref": "KeyPath", "description": "Index key path." }, 1568 { "name": "unique", "type": "boolean", "description": "If true, index is unique." }, 1569 { "name": "multiEntry", "type": "boolean", "description": "If true, index allows multiple entries for a key." } 1570 ] 1571 }, 1572 { 1573 "id": "Key", 1574 "type": "object", 1575 "description": "Key.", 1576 "properties": [ 1577 { "name": "type", "type": "string", "enum": ["number", "string", "date", "array"], "description": "Key type." }, 1578 { "name": "number", "type": "number", "optional": true, "description": "Number value." }, 1579 { "name": "string", "type": "string", "optional": true, "description": "String value." }, 1580 { "name": "date", "type": "number", "optional": true, "description": "Date value." }, 1581 { "name": "array", "type": "array", "optional": true, "items": { "$ref": "Key" }, "description": "Array value." } 1582 ] 1583 }, 1584 { 1585 "id": "KeyRange", 1586 "type": "object", 1587 "description": "Key range.", 1588 "properties": [ 1589 { "name": "lower", "$ref": "Key", "optional": true, "description": "Lower bound." }, 1590 { "name": "upper", "$ref": "Key", "optional": true, "description": "Upper bound." }, 1591 { "name": "lowerOpen", "type": "boolean", "description": "If true lower bound is open." }, 1592 { "name": "upperOpen", "type": "boolean", "description": "If true upper bound is open." } 1593 ] 1594 }, 1595 { 1596 "id": "DataEntry", 1597 "type": "object", 1598 "description": "Data entry.", 1599 "properties": [ 1600 { "name": "key", "type": "string", "description": "JSON-stringified key object." }, 1601 { "name": "primaryKey", "type": "string", "description": "JSON-stringified primary key object." }, 1602 { "name": "value", "type": "string", "description": "JSON-stringified value object." } 1603 ] 1604 }, 1605 { 1606 "id": "KeyPath", 1607 "type": "object", 1608 "description": "Key path.", 1609 "properties": [ 1610 { "name": "type", "type": "string", "enum": ["null", "string", "array"], "description": "Key path type." }, 1611 { "name": "string", "type": "string", "optional": true, "description": "String value." }, 1612 { "name": "array", "type": "array", "optional": true, "items": { "type": "string" }, "description": "Array value." } 1613 ] 1614 } 1615 ], 1616 "commands": [ 1617 { 1618 "name": "enable", 1619 "description": "Enables events from backend." 1620 }, 1621 { 1622 "name": "disable", 1623 "description": "Disables events from backend." 1624 }, 1625 { 1626 "name": "requestDatabaseNames", 1627 "async": true, 1628 "parameters": [ 1629 { "name": "securityOrigin", "type": "string", "description": "Security origin." } 1630 ], 1631 "returns": [ 1632 { "name": "databaseNames", "type": "array", "items": { "type": "string" }, "description": "Database names for origin." } 1633 ], 1634 "description": "Requests database names for given security origin." 1635 }, 1636 { 1637 "name": "requestDatabase", 1638 "async": true, 1639 "parameters": [ 1640 { "name": "securityOrigin", "type": "string", "description": "Security origin." }, 1641 { "name": "databaseName", "type": "string", "description": "Database name." } 1642 ], 1643 "returns": [ 1644 { "name": "databaseWithObjectStores", "$ref": "DatabaseWithObjectStores", "description": "Database with an array of object stores." } 1645 ], 1646 "description": "Requests database with given name in given frame." 1647 }, 1648 { 1649 "name": "requestData", 1650 "async": true, 1651 "parameters": [ 1652 { "name": "securityOrigin", "type": "string", "description": "Security origin." }, 1653 { "name": "databaseName", "type": "string", "description": "Database name." }, 1654 { "name": "objectStoreName", "type": "string", "description": "Object store name." }, 1655 { "name": "indexName", "type": "string", "description": "Index name, empty string for object store data requests." }, 1656 { "name": "skipCount", "type": "integer", "description": "Number of records to skip." }, 1657 { "name": "pageSize", "type": "integer", "description": "Number of records to fetch." }, 1658 { "name": "keyRange", "$ref": "KeyRange", "optional": true, "description": "Key range." } 1659 ], 1660 "returns": [ 1661 { "name": "objectStoreDataEntries", "type": "array", "items": { "$ref": "DataEntry" }, "description": "Array of object store data entries." }, 1662 { "name": "hasMore", "type": "boolean", "description": "If true, there are more entries to fetch in the given range." } 1663 ], 1664 "description": "Requests data from object store or index." 1665 }, 1666 { 1667 "name": "clearObjectStore", 1668 "async": true, 1669 "parameters": [ 1670 { "name": "securityOrigin", "type": "string", "description": "Security origin." }, 1671 { "name": "databaseName", "type": "string", "description": "Database name." }, 1672 { "name": "objectStoreName", "type": "string", "description": "Object store name." } 1673 ], 1674 "returns": [ 1675 ], 1676 "description": "Clears all entries from an object store." 1677 } 1678 ] 1679 }, 1680 { 1681 "domain": "DOMStorage", 1682 "hidden": true, 1683 "description": "Query and modify DOM storage.", 1684 "types": [ 1685 { 1686 "id": "StorageId", 1687 "type": "object", 1688 "description": "DOM Storage identifier.", 1689 "hidden": true, 1690 "properties": [ 1691 { "name": "securityOrigin", "type": "string", "description": "Security origin for the storage." }, 1692 { "name": "isLocalStorage", "type": "boolean", "description": "Whether the storage is local storage (not session storage)." } 1693 ] 1694 }, 1695 { 1696 "id": "Item", 1697 "type": "array", 1698 "description": "DOM Storage item.", 1699 "hidden": true, 1700 "items": { "type": "string" } 1701 } 1702 ], 1703 "commands": [ 1704 { 1705 "name": "enable", 1706 "description": "Enables storage tracking, storage events will now be delivered to the client." 1707 }, 1708 { 1709 "name": "disable", 1710 "description": "Disables storage tracking, prevents storage events from being sent to the client." 1711 }, 1712 { 1713 "name": "getDOMStorageItems", 1714 "parameters": [ 1715 { "name": "storageId", "$ref": "StorageId" } 1716 ], 1717 "returns": [ 1718 { "name": "entries", "type": "array", "items": { "$ref": "Item" } } 1719 ] 1720 }, 1721 { 1722 "name": "setDOMStorageItem", 1723 "parameters": [ 1724 { "name": "storageId", "$ref": "StorageId" }, 1725 { "name": "key", "type": "string" }, 1726 { "name": "value", "type": "string" } 1727 ] 1728 }, 1729 { 1730 "name": "removeDOMStorageItem", 1731 "parameters": [ 1732 { "name": "storageId", "$ref": "StorageId" }, 1733 { "name": "key", "type": "string" } 1734 ] 1735 } 1736 ], 1737 "events": [ 1738 { 1739 "name": "domStorageItemsCleared", 1740 "parameters": [ 1741 { "name": "storageId", "$ref": "StorageId" } 1742 ] 1743 }, 1744 { 1745 "name": "domStorageItemRemoved", 1746 "parameters": [ 1747 { "name": "storageId", "$ref": "StorageId" }, 1748 { "name": "key", "type": "string" } 1749 ] 1750 }, 1751 { 1752 "name": "domStorageItemAdded", 1753 "parameters": [ 1754 { "name": "storageId", "$ref": "StorageId" }, 1755 { "name": "key", "type": "string" }, 1756 { "name": "newValue", "type": "string" } 1757 ] 1758 }, 1759 { 1760 "name": "domStorageItemUpdated", 1761 "parameters": [ 1762 { "name": "storageId", "$ref": "StorageId" }, 1763 { "name": "key", "type": "string" }, 1764 { "name": "oldValue", "type": "string" }, 1765 { "name": "newValue", "type": "string" } 1766 ] 1767 } 1768 ] 1769 }, 1770 { 1771 "domain": "ApplicationCache", 1772 "hidden": true, 1773 "types": [ 1774 { 1775 "id": "ApplicationCacheResource", 1776 "type": "object", 1777 "description": "Detailed application cache resource information.", 1778 "properties": [ 1779 { "name": "url", "type": "string", "description": "Resource url." }, 1780 { "name": "size", "type": "integer", "description": "Resource size." }, 1781 { "name": "type", "type": "string", "description": "Resource type." } 1782 ] 1783 }, 1784 { 1785 "id": "ApplicationCache", 1786 "type": "object", 1787 "description": "Detailed application cache information.", 1788 "properties": [ 1789 { "name": "manifestURL", "type": "string", "description": "Manifest URL." }, 1790 { "name": "size", "type": "number", "description": "Application cache size." }, 1791 { "name": "creationTime", "type": "number", "description": "Application cache creation time." }, 1792 { "name": "updateTime", "type": "number", "description": "Application cache update time." }, 1793 { "name": "resources", "type": "array", "items": { "$ref": "ApplicationCacheResource" }, "description": "Application cache resources." } 1794 ] 1795 }, 1796 { 1797 "id": "FrameWithManifest", 1798 "type": "object", 1799 "description": "Frame identifier - manifest URL pair.", 1800 "properties": [ 1801 { "name": "frameId", "$ref": "Page.FrameId", "description": "Frame identifier." }, 1802 { "name": "manifestURL", "type": "string", "description": "Manifest URL." }, 1803 { "name": "status", "type": "integer", "description": "Application cache status." } 1804 ] 1805 } 1806 ], 1807 "commands": [ 1808 { 1809 "name": "getFramesWithManifests", 1810 "returns": [ 1811 { "name": "frameIds", "type": "array", "items": { "$ref": "FrameWithManifest" }, "description": "Array of frame identifiers with manifest urls for each frame containing a document associated with some application cache." } 1812 ], 1813 "description": "Returns array of frame identifiers with manifest urls for each frame containing a document associated with some application cache." 1814 }, 1815 { 1816 "name": "enable", 1817 "description": "Enables application cache domain notifications." 1818 }, 1819 { 1820 "name": "getManifestForFrame", 1821 "parameters": [ 1822 { "name": "frameId", "$ref": "Page.FrameId", "description": "Identifier of the frame containing document whose manifest is retrieved." } 1823 ], 1824 "returns": [ 1825 { "name": "manifestURL", "type": "string", "description": "Manifest URL for document in the given frame." } 1826 ], 1827 "description": "Returns manifest URL for document in the given frame." 1828 }, 1829 { 1830 "name": "getApplicationCacheForFrame", 1831 "parameters": [ 1832 { "name": "frameId", "$ref": "Page.FrameId", "description": "Identifier of the frame containing document whose application cache is retrieved." } 1833 ], 1834 "returns": [ 1835 { "name": "applicationCache", "$ref": "ApplicationCache", "description": "Relevant application cache data for the document in given frame." } 1836 ], 1837 "description": "Returns relevant application cache data for the document in given frame." 1838 } 1839 ], 1840 "events": [ 1841 { 1842 "name": "applicationCacheStatusUpdated", 1843 "parameters": [ 1844 { "name": "frameId", "$ref": "Page.FrameId", "description": "Identifier of the frame containing document whose application cache updated status." }, 1845 { "name": "manifestURL", "type": "string", "description": "Manifest URL." }, 1846 { "name": "status", "type": "integer", "description": "Updated application cache status." } 1847 ] 1848 }, 1849 { 1850 "name": "networkStateUpdated", 1851 "parameters": [ 1852 { "name": "isNowOnline", "type": "boolean" } 1853 ] 1854 } 1855 ] 1856 }, 1857 { 1858 "domain": "FileSystem", 1859 "hidden": true, 1860 "types": [ 1861 { 1862 "id": "Entry", 1863 "type": "object", 1864 "properties": [ 1865 { "name": "url", "type": "string", "description": "filesystem: URL for the entry." }, 1866 { "name": "name", "type": "string", "description": "The name of the file or directory." }, 1867 { "name": "isDirectory", "type": "boolean", "description": "True if the entry is a directory." }, 1868 { "name": "mimeType", "type": "string", "optional": true, "description": "MIME type of the entry, available for a file only." }, 1869 { "name": "resourceType", "$ref": "Page.ResourceType", "optional": true, "description": "ResourceType of the entry, available for a file only." }, 1870 { "name": "isTextFile", "type": "boolean", "optional": true, "description": "True if the entry is a text file." } 1871 ], 1872 "description": "Represents a browser side file or directory." 1873 }, 1874 { 1875 "id": "Metadata", 1876 "type": "object", 1877 "properties": [ 1878 { "name": "modificationTime", "type": "number", "description": "Modification time." }, 1879 { "name": "size", "type": "number", "description": "File size. This field is always zero for directories." } 1880 ], 1881 "description": "Represents metadata of a file or entry." 1882 } 1883 ], 1884 "commands": [ 1885 { 1886 "name": "enable", 1887 "description": "Enables events from backend." 1888 }, 1889 { 1890 "name": "disable", 1891 "description": "Disables events from backend." 1892 }, 1893 { 1894 "name": "requestFileSystemRoot", 1895 "async": true, 1896 "parameters": [ 1897 { "name": "origin", "type": "string", "description": "Security origin of requesting FileSystem. One of frames in current page needs to have this security origin." }, 1898 { "name": "type", "type": "string", "enum": ["temporary", "persistent"], "description": "FileSystem type of requesting FileSystem." } 1899 ], 1900 "returns": [ 1901 { "name": "errorCode", "type": "integer", "description": "0, if no error. Otherwise, errorCode is set to FileError::ErrorCode value." }, 1902 { "name": "root", "$ref": "Entry", "optional": true, "description": "Contains root of the requested FileSystem if the command completed successfully." } 1903 ], 1904 "description": "Returns root directory of the FileSystem, if exists." 1905 }, 1906 { 1907 "name": "requestDirectoryContent", 1908 "async": true, 1909 "parameters": [ 1910 { "name": "url", "type": "string", "description": "URL of the directory that the frontend is requesting to read from." } 1911 ], 1912 "returns": [ 1913 { "name": "errorCode", "type": "integer", "description": "0, if no error. Otherwise, errorCode is set to FileError::ErrorCode value." }, 1914 { "name": "entries", "type": "array", "items": { "$ref": "Entry" }, "optional": true, "description": "Contains all entries on directory if the command completed successfully." } 1915 ], 1916 "description": "Returns content of the directory." 1917 }, 1918 { 1919 "name": "requestMetadata", 1920 "async": true, 1921 "parameters": [ 1922 { "name": "url", "type": "string", "description": "URL of the entry that the frontend is requesting to get metadata from." } 1923 ], 1924 "returns": [ 1925 { "name": "errorCode", "type": "integer", "description": "0, if no error. Otherwise, errorCode is set to FileError::ErrorCode value." }, 1926 { "name": "metadata", "$ref": "Metadata", "optional": true, "description": "Contains metadata of the entry if the command completed successfully." } 1927 ], 1928 "description": "Returns metadata of the entry." 1929 }, 1930 { 1931 "name": "requestFileContent", 1932 "async": true, 1933 "parameters": [ 1934 { "name": "url", "type": "string", "description": "URL of the file that the frontend is requesting to read from." }, 1935 { "name": "readAsText", "type": "boolean", "description": "True if the content should be read as text, otherwise the result will be returned as base64 encoded text." }, 1936 { "name": "start", "type": "integer", "optional": true, "description": "Specifies the start of range to read." }, 1937 { "name": "end", "type": "integer", "optional": true, "description": "Specifies the end of range to read exclusively." }, 1938 { "name": "charset", "type": "string", "optional": true, "description": "Overrides charset of the content when content is served as text." } 1939 ], 1940 "returns": [ 1941 { "name": "errorCode", "type": "integer", "description": "0, if no error. Otherwise, errorCode is set to FileError::ErrorCode value." }, 1942 { "name": "content", "type": "string", "optional": true, "description": "Content of the file." }, 1943 { "name": "charset", "type": "string", "optional": true, "description": "Charset of the content if it is served as text." } 1944 ], 1945 "description": "Returns content of the file. Result should be sliced into [start, end)." 1946 }, 1947 { 1948 "name": "deleteEntry", 1949 "async": true, 1950 "parameters": [ 1951 { "name": "url", "type": "string", "description": "URL of the entry to delete." } 1952 ], 1953 "returns": [ 1954 { "name": "errorCode", "type": "integer", "description": "0, if no error. Otherwise errorCode is set to FileError::ErrorCode value." } 1955 ], 1956 "description": "Deletes specified entry. If the entry is a directory, the agent deletes children recursively." 1957 } 1958 ] 1959 }, 1960 { 1961 "domain": "DOM", 1962 "description": "This domain exposes DOM read/write operations. Each DOM Node is represented with its mirror object that has an <code>id</code>. This <code>id</code> can be used to get additional information on the Node, resolve it into the JavaScript object wrapper, etc. It is important that client receives DOM events only for the nodes that are known to the client. Backend keeps track of the nodes that were sent to the client and never sends the same node twice. It is client's responsibility to collect information about the nodes that were sent to the client.<p>Note that <code>iframe</code> owner elements will return corresponding document elements as their child nodes.</p>", 1963 "types": [ 1964 { 1965 "id": "NodeId", 1966 "type": "integer", 1967 "description": "Unique DOM node identifier." 1968 }, 1969 { 1970 "id": "BackendNodeId", 1971 "type": "integer", 1972 "description": "Unique DOM node identifier used to reference a node that may not have been pushed to the front-end.", 1973 "hidden": true 1974 }, 1975 { 1976 "id": "PseudoType", 1977 "type": "string", 1978 "enum": ["before", "after"], 1979 "description": "Pseudo element type." 1980 }, 1981 { 1982 "id": "ShadowRootType", 1983 "type": "string", 1984 "enum": ["user-agent", "author"], 1985 "description": "Shadow root type." 1986 }, 1987 { 1988 "id": "Node", 1989 "type": "object", 1990 "properties": [ 1991 { "name": "nodeId", "$ref": "NodeId", "description": "Node identifier that is passed into the rest of the DOM messages as the <code>nodeId</code>. Backend will only push node with given <code>id</code> once. It is aware of all requested nodes and will only fire DOM events for nodes known to the client." }, 1992 { "name": "nodeType", "type": "integer", "description": "<code>Node</code>'s nodeType." }, 1993 { "name": "nodeName", "type": "string", "description": "<code>Node</code>'s nodeName." }, 1994 { "name": "localName", "type": "string", "description": "<code>Node</code>'s localName." }, 1995 { "name": "nodeValue", "type": "string", "description": "<code>Node</code>'s nodeValue." }, 1996 { "name": "childNodeCount", "type": "integer", "optional": true, "description": "Child count for <code>Container</code> nodes." }, 1997 { "name": "children", "type": "array", "optional": true, "items": { "$ref": "Node" }, "description": "Child nodes of this node when requested with children." }, 1998 { "name": "attributes", "type": "array", "optional": true, "items": { "type": "string" }, "description": "Attributes of the <code>Element</code> node in the form of flat array <code>[name1, value1, name2, value2]</code>." }, 1999 { "name": "documentURL", "type": "string", "optional": true, "description": "Document URL that <code>Document</code> or <code>FrameOwner</code> node points to." }, 2000 { "name": "baseURL", "type": "string", "optional": true, "description": "Base URL that <code>Document</code> or <code>FrameOwner</code> node uses for URL completion.", "hidden": true }, 2001 { "name": "publicId", "type": "string", "optional": true, "description": "<code>DocumentType</code>'s publicId." }, 2002 { "name": "systemId", "type": "string", "optional": true, "description": "<code>DocumentType</code>'s systemId." }, 2003 { "name": "internalSubset", "type": "string", "optional": true, "description": "<code>DocumentType</code>'s internalSubset." }, 2004 { "name": "xmlVersion", "type": "string", "optional": true, "description": "<code>Document</code>'s XML version in case of XML documents." }, 2005 { "name": "name", "type": "string", "optional": true, "description": "<code>Attr</code>'s name." }, 2006 { "name": "value", "type": "string", "optional": true, "description": "<code>Attr</code>'s value." }, 2007 { "name": "pseudoType", "$ref": "PseudoType", "optional": true, "description": "Pseudo element type for this node." }, 2008 { "name": "shadowRootType", "$ref": "ShadowRootType", "optional": true, "description": "Shadow root type." }, 2009 { "name": "frameId", "$ref": "Page.FrameId", "optional": true, "description": "Frame ID for frame owner elements.", "hidden": true }, 2010 { "name": "contentDocument", "$ref": "Node", "optional": true, "description": "Content document for frame owner elements." }, 2011 { "name": "shadowRoots", "type": "array", "optional": true, "items": { "$ref": "Node" }, "description": "Shadow root list for given element host.", "hidden": true }, 2012 { "name": "templateContent", "$ref": "Node", "optional": true, "description": "Content document fragment for template elements.", "hidden": true }, 2013 { "name": "pseudoElements", "type": "array", "items": { "$ref": "Node" }, "optional": true, "description": "Pseudo elements associated with this node.", "hidden": true }, 2014 { "name": "importedDocument", "$ref": "Node", "optional": true, "description": "Import document for the HTMLImport links." } 2015 ], 2016 "description": "DOM interaction is implemented in terms of mirror objects that represent the actual DOM nodes. DOMNode is a base node mirror type." 2017 }, 2018 { 2019 "id": "EventListener", 2020 "type": "object", 2021 "hidden": true, 2022 "properties": [ 2023 { "name": "type", "type": "string", "description": "<code>EventListener</code>'s type." }, 2024 { "name": "useCapture", "type": "boolean", "description": "<code>EventListener</code>'s useCapture." }, 2025 { "name": "isAttribute", "type": "boolean", "description": "<code>EventListener</code>'s isAttribute." }, 2026 { "name": "nodeId", "$ref": "NodeId", "description": "Target <code>DOMNode</code> id." }, 2027 { "name": "handlerBody", "type": "string", "description": "Event handler function body." }, 2028 { "name": "location", "$ref": "Debugger.Location", "description": "Handler code location." }, 2029 { "name": "sourceName", "type": "string", "optional": true, "description": "Source script URL." }, 2030 { "name": "handler", "$ref": "Runtime.RemoteObject", "optional": true, "description": "Event handler function value." } 2031 ], 2032 "description": "DOM interaction is implemented in terms of mirror objects that represent the actual DOM nodes. DOMNode is a base node mirror type." 2033 }, 2034 { 2035 "id": "RGBA", 2036 "type": "object", 2037 "properties": [ 2038 { "name": "r", "type": "integer", "description": "The red component, in the [0-255] range." }, 2039 { "name": "g", "type": "integer", "description": "The green component, in the [0-255] range." }, 2040 { "name": "b", "type": "integer", "description": "The blue component, in the [0-255] range." }, 2041 { "name": "a", "type": "number", "optional": true, "description": "The alpha component, in the [0-1] range (default: 1)." } 2042 ], 2043 "description": "A structure holding an RGBA color." 2044 }, 2045 { 2046 "id": "Quad", 2047 "type": "array", 2048 "items": { "type": "number" }, 2049 "minItems": 8, 2050 "maxItems": 8, 2051 "description": "An array of quad vertices, x immediately followed by y for each point, points clock-wise.", 2052 "hidden": true 2053 }, 2054 { 2055 "id": "BoxModel", 2056 "type": "object", 2057 "hidden": true, 2058 "properties": [ 2059 { "name": "content", "$ref": "Quad", "description": "Content box" }, 2060 { "name": "padding", "$ref": "Quad", "description": "Padding box" }, 2061 { "name": "border", "$ref": "Quad", "description": "Border box" }, 2062 { "name": "margin", "$ref": "Quad", "description": "Margin box" }, 2063 { "name": "width", "type": "integer", "description": "Node width" }, 2064 { "name": "height", "type": "integer", "description": "Node height" }, 2065 { "name": "shapeOutside", "$ref": "ShapeOutsideInfo", "optional": true, "description": "Shape outside coordinates" } 2066 ], 2067 "description": "Box model." 2068 }, 2069 { 2070 "id": "ShapeOutsideInfo", 2071 "type": "object", 2072 "hidden": true, 2073 "properties": [ 2074 { "name": "bounds", "$ref": "Quad", "description": "Shape bounds" }, 2075 { "name": "shape", "type": "array", "items": { "type": "any"}, "description": "Shape coordinate details" }, 2076 { "name": "marginShape", "type": "array", "items": { "type": "any"}, "description": "Margin shape bounds" } 2077 ], 2078 "description": "CSS Shape Outside details." 2079 }, 2080 { 2081 "id": "Rect", 2082 "type": "object", 2083 "hidden": true, 2084 "properties": [ 2085 { "name": "x", "type": "number", "description": "X coordinate" }, 2086 { "name": "y", "type": "number", "description": "Y coordinate" }, 2087 { "name": "width", "type": "number", "description": "Rectangle width" }, 2088 { "name": "height", "type": "number", "description": "Rectangle height" } 2089 ], 2090 "description": "Rectangle." 2091 }, 2092 { 2093 "id": "HighlightConfig", 2094 "type": "object", 2095 "properties": [ 2096 { "name": "showInfo", "type": "boolean", "optional": true, "description": "Whether the node info tooltip should be shown (default: false)." }, 2097 { "name": "showRulers", "type": "boolean", "optional": true, "description": "Whether the rulers should be shown (default: false)." }, 2098 { "name": "showExtensionLines", "type": "boolean", "optional": true, "description": "Whether the extension lines from node to the rulers should be shown (default: false)." }, 2099 { "name": "contentColor", "$ref": "RGBA", "optional": true, "description": "The content box highlight fill color (default: transparent)." }, 2100 { "name": "paddingColor", "$ref": "RGBA", "optional": true, "description": "The padding highlight fill color (default: transparent)." }, 2101 { "name": "borderColor", "$ref": "RGBA", "optional": true, "description": "The border highlight fill color (default: transparent)." }, 2102 { "name": "marginColor", "$ref": "RGBA", "optional": true, "description": "The margin highlight fill color (default: transparent)." }, 2103 { "name": "eventTargetColor", "$ref": "RGBA", "optional": true, "hidden": true, "description": "The event target element highlight fill color (default: transparent)." }, 2104 { "name": "shapeColor", "$ref": "RGBA", "optional": true, "hidden": true, "description": "The shape outside fill color (default: transparent)." }, 2105 { "name": "shapeMarginColor", "$ref": "RGBA", "optional": true, "hidden": true, "description": "The shape margin fill color (default: transparent)." } 2106 ], 2107 "description": "Configuration data for the highlighting of page elements." 2108 } 2109 ], 2110 "commands": [ 2111 { 2112 "name": "enable", 2113 "description": "Enables DOM agent for the given page." 2114 }, 2115 { 2116 "name": "disable", 2117 "description": "Disables DOM agent for the given page." 2118 }, 2119 { 2120 "name": "getDocument", 2121 "returns": [ 2122 { "name": "root", "$ref": "Node", "description": "Resulting node." } 2123 ], 2124 "description": "Returns the root DOM node to the caller." 2125 }, 2126 { 2127 "name": "requestChildNodes", 2128 "parameters": [ 2129 { "name": "nodeId", "$ref": "NodeId", "description": "Id of the node to get children for." }, 2130 { "name": "depth", "type": "integer", "optional": true, "description": "The maximum depth at which children should be retrieved, defaults to 1. Use -1 for the entire subtree or provide an integer larger than 0.", "hidden": true } 2131 ], 2132 "description": "Requests that children of the node with given id are returned to the caller in form of <code>setChildNodes</code> events where not only immediate children are retrieved, but all children down to the specified depth." 2133 }, 2134 { 2135 "name": "querySelector", 2136 "parameters": [ 2137 { "name": "nodeId", "$ref": "NodeId", "description": "Id of the node to query upon." }, 2138 { "name": "selector", "type": "string", "description": "Selector string." } 2139 ], 2140 "returns": [ 2141 { "name": "nodeId", "$ref": "NodeId", "description": "Query selector result." } 2142 ], 2143 "description": "Executes <code>querySelector</code> on a given node." 2144 }, 2145 { 2146 "name": "querySelectorAll", 2147 "parameters": [ 2148 { "name": "nodeId", "$ref": "NodeId", "description": "Id of the node to query upon." }, 2149 { "name": "selector", "type": "string", "description": "Selector string." } 2150 ], 2151 "returns": [ 2152 { "name": "nodeIds", "type": "array", "items": { "$ref": "NodeId" }, "description": "Query selector result." } 2153 ], 2154 "description": "Executes <code>querySelectorAll</code> on a given node." 2155 }, 2156 { 2157 "name": "setNodeName", 2158 "parameters": [ 2159 { "name": "nodeId", "$ref": "NodeId", "description": "Id of the node to set name for." }, 2160 { "name": "name", "type": "string", "description": "New node's name." } 2161 ], 2162 "returns": [ 2163 { "name": "nodeId", "$ref": "NodeId", "description": "New node's id." } 2164 ], 2165 "description": "Sets node name for a node with given id." 2166 }, 2167 { 2168 "name": "setNodeValue", 2169 "parameters": [ 2170 { "name": "nodeId", "$ref": "NodeId", "description": "Id of the node to set value for." }, 2171 { "name": "value", "type": "string", "description": "New node's value." } 2172 ], 2173 "description": "Sets node value for a node with given id." 2174 }, 2175 { 2176 "name": "removeNode", 2177 "parameters": [ 2178 { "name": "nodeId", "$ref": "NodeId", "description": "Id of the node to remove." } 2179 ], 2180 "description": "Removes node with given id." 2181 }, 2182 { 2183 "name": "setAttributeValue", 2184 "parameters": [ 2185 { "name": "nodeId", "$ref": "NodeId", "description": "Id of the element to set attribute for." }, 2186 { "name": "name", "type": "string", "description": "Attribute name." }, 2187 { "name": "value", "type": "string", "description": "Attribute value." } 2188 ], 2189 "description": "Sets attribute for an element with given id." 2190 }, 2191 { 2192 "name": "setAttributesAsText", 2193 "parameters": [ 2194 { "name": "nodeId", "$ref": "NodeId", "description": "Id of the element to set attributes for." }, 2195 { "name": "text", "type": "string", "description": "Text with a number of attributes. Will parse this text using HTML parser." }, 2196 { "name": "name", "type": "string", "optional": true, "description": "Attribute name to replace with new attributes derived from text in case text parsed successfully." } 2197 ], 2198 "description": "Sets attributes on element with given id. This method is useful when user edits some existing attribute value and types in several attribute name/value pairs." 2199 }, 2200 { 2201 "name": "removeAttribute", 2202 "parameters": [ 2203 { "name": "nodeId", "$ref": "NodeId", "description": "Id of the element to remove attribute from." }, 2204 { "name": "name", "type": "string", "description": "Name of the attribute to remove." } 2205 ], 2206 "description": "Removes attribute with given name from an element with given id." 2207 }, 2208 { 2209 "name": "getEventListenersForNode", 2210 "parameters": [ 2211 { "name": "nodeId", "$ref": "NodeId", "description": "Id of the node to get listeners for." }, 2212 { "name": "objectGroup", "type": "string", "optional": true, "description": "Symbolic group name for handler value. Handler value is not returned without this parameter specified." } 2213 ], 2214 "returns": [ 2215 { "name": "listeners", "type": "array", "items": { "$ref": "EventListener" }, "description": "Array of relevant listeners." } 2216 ], 2217 "description": "Returns event listeners relevant to the node.", 2218 "hidden": true 2219 }, 2220 { 2221 "name": "getOuterHTML", 2222 "parameters": [ 2223 { "name": "nodeId", "$ref": "NodeId", "description": "Id of the node to get markup for." } 2224 ], 2225 "returns": [ 2226 { "name": "outerHTML", "type": "string", "description": "Outer HTML markup." } 2227 ], 2228 "description": "Returns node's HTML markup." 2229 }, 2230 { 2231 "name": "setOuterHTML", 2232 "parameters": [ 2233 { "name": "nodeId", "$ref": "NodeId", "description": "Id of the node to set markup for." }, 2234 { "name": "outerHTML", "type": "string", "description": "Outer HTML markup to set." } 2235 ], 2236 "description": "Sets node HTML markup, returns new node id." 2237 }, 2238 { 2239 "name": "performSearch", 2240 "parameters": [ 2241 { "name": "query", "type": "string", "description": "Plain text or query selector or XPath search query." }, 2242 { "name": "includeUserAgentShadowDOM", "type": "boolean", "optional": true, "description": "True to search in user agent shadow DOM.", "hidden": true } 2243 ], 2244 "returns": [ 2245 { "name": "searchId", "type": "string", "description": "Unique search session identifier." }, 2246 { "name": "resultCount", "type": "integer", "description": "Number of search results." } 2247 ], 2248 "description": "Searches for a given string in the DOM tree. Use <code>getSearchResults</code> to access search results or <code>cancelSearch</code> to end this search session.", 2249 "hidden": true 2250 }, 2251 { 2252 "name": "getSearchResults", 2253 "parameters": [ 2254 { "name": "searchId", "type": "string", "description": "Unique search session identifier." }, 2255 { "name": "fromIndex", "type": "integer", "description": "Start index of the search result to be returned." }, 2256 { "name": "toIndex", "type": "integer", "description": "End index of the search result to be returned." } 2257 ], 2258 "returns": [ 2259 { "name": "nodeIds", "type": "array", "items": { "$ref": "NodeId" }, "description": "Ids of the search result nodes." } 2260 ], 2261 "description": "Returns search results from given <code>fromIndex</code> to given <code>toIndex</code> from the sarch with the given identifier.", 2262 "hidden": true 2263 }, 2264 { 2265 "name": "discardSearchResults", 2266 "parameters": [ 2267 { "name": "searchId", "type": "string", "description": "Unique search session identifier." } 2268 ], 2269 "description": "Discards search results from the session with the given id. <code>getSearchResults</code> should no longer be called for that search.", 2270 "hidden": true 2271 }, 2272 { 2273 "name": "requestNode", 2274 "parameters": [ 2275 { "name": "objectId", "$ref": "Runtime.RemoteObjectId", "description": "JavaScript object id to convert into node." } 2276 ], 2277 "returns": [ 2278 { "name": "nodeId", "$ref": "NodeId", "description": "Node id for given object." } 2279 ], 2280 "description": "Requests that the node is sent to the caller given the JavaScript node object reference. All nodes that form the path from the node to the root are also sent to the client as a series of <code>setChildNodes</code> notifications." 2281 }, 2282 { 2283 "name": "setInspectModeEnabled", 2284 "hidden": true, 2285 "parameters": [ 2286 { "name": "enabled", "type": "boolean", "description": "True to enable inspection mode, false to disable it." }, 2287 { "name": "inspectUAShadowDOM", "type": "boolean", "optional": true, "description": "True to enable inspection mode for user agent shadow DOM." }, 2288 { "name": "highlightConfig", "$ref": "HighlightConfig", "optional": true, "description": "A descriptor for the highlight appearance of hovered-over nodes. May be omitted if <code>enabled == false</code>." } 2289 ], 2290 "description": "Enters the 'inspect' mode. In this mode, elements that user is hovering over are highlighted. Backend then generates 'inspectNodeRequested' event upon element selection." 2291 }, 2292 { 2293 "name": "highlightRect", 2294 "parameters": [ 2295 { "name": "x", "type": "integer", "description": "X coordinate" }, 2296 { "name": "y", "type": "integer", "description": "Y coordinate" }, 2297 { "name": "width", "type": "integer", "description": "Rectangle width" }, 2298 { "name": "height", "type": "integer", "description": "Rectangle height" }, 2299 { "name": "color", "$ref": "RGBA", "optional": true, "description": "The highlight fill color (default: transparent)." }, 2300 { "name": "outlineColor", "$ref": "RGBA", "optional": true, "description": "The highlight outline color (default: transparent)." } 2301 ], 2302 "description": "Highlights given rectangle. Coordinates are absolute with respect to the main frame viewport." 2303 }, 2304 { 2305 "name": "highlightQuad", 2306 "parameters": [ 2307 { "name": "quad", "$ref": "Quad", "description": "Quad to highlight" }, 2308 { "name": "color", "$ref": "RGBA", "optional": true, "description": "The highlight fill color (default: transparent)." }, 2309 { "name": "outlineColor", "$ref": "RGBA", "optional": true, "description": "The highlight outline color (default: transparent)." } 2310 ], 2311 "description": "Highlights given quad. Coordinates are absolute with respect to the main frame viewport.", 2312 "hidden": true 2313 }, 2314 { 2315 "name": "highlightNode", 2316 "parameters": [ 2317 { "name": "highlightConfig", "$ref": "HighlightConfig", "description": "A descriptor for the highlight appearance." }, 2318 { "name": "nodeId", "$ref": "NodeId", "optional": true, "description": "Identifier of the node to highlight." }, 2319 { "name": "objectId", "$ref": "Runtime.RemoteObjectId", "optional": true, "description": "JavaScript object id of the node to be highlighted.", "hidden": true } 2320 ], 2321 "description": "Highlights DOM node with given id or with the given JavaScript object wrapper. Either nodeId or objectId must be specified." 2322 }, 2323 { 2324 "name": "hideHighlight", 2325 "description": "Hides DOM node highlight." 2326 }, 2327 { 2328 "name": "highlightFrame", 2329 "parameters": [ 2330 { "name": "frameId", "$ref": "Page.FrameId", "description": "Identifier of the frame to highlight." }, 2331 { "name": "contentColor", "$ref": "RGBA", "optional": true, "description": "The content box highlight fill color (default: transparent)." }, 2332 { "name": "contentOutlineColor", "$ref": "RGBA", "optional": true, "description": "The content box highlight outline color (default: transparent)." } 2333 ], 2334 "description": "Highlights owner element of the frame with given id.", 2335 "hidden": true 2336 }, 2337 { 2338 "name": "pushNodeByPathToFrontend", 2339 "parameters": [ 2340 { "name": "path", "type": "string", "description": "Path to node in the proprietary format." } 2341 ], 2342 "returns": [ 2343 { "name": "nodeId", "$ref": "NodeId", "description": "Id of the node for given path." } 2344 ], 2345 "description": "Requests that the node is sent to the caller given its path. // FIXME, use XPath", 2346 "hidden": true 2347 }, 2348 { 2349 "name": "pushNodesByBackendIdsToFrontend", 2350 "parameters": [ 2351 { "name": "backendNodeIds", "type": "array", "items": {"$ref": "BackendNodeId"}, "description": "The array of backend node ids." } 2352 ], 2353 "returns": [ 2354 { "name": "nodeIds", "type": "array", "items": {"$ref": "NodeId"}, "description": "The array of ids of pushed nodes that correspond to the backend ids specified in backendNodeIds." } 2355 ], 2356 "description": "Requests that a batch of nodes is sent to the caller given their backend node ids.", 2357 "hidden": true 2358 }, 2359 { 2360 "name": "resolveNode", 2361 "parameters": [ 2362 { "name": "nodeId", "$ref": "NodeId", "description": "Id of the node to resolve." }, 2363 { "name": "objectGroup", "type": "string", "optional": true, "description": "Symbolic group name that can be used to release multiple objects." } 2364 ], 2365 "returns": [ 2366 { "name": "object", "$ref": "Runtime.RemoteObject", "description": "JavaScript object wrapper for given node." } 2367 ], 2368 "description": "Resolves JavaScript node object for given node id." 2369 }, 2370 { 2371 "name": "getAttributes", 2372 "parameters": [ 2373 { "name": "nodeId", "$ref": "NodeId", "description": "Id of the node to retrieve attibutes for." } 2374 ], 2375 "returns": [ 2376 { "name": "attributes", "type": "array", "items": { "type": "string" }, "description": "An interleaved array of node attribute names and values." } 2377 ], 2378 "description": "Returns attributes for the specified node." 2379 }, 2380 { 2381 "name": "copyTo", 2382 "parameters": [ 2383 { "name": "nodeId", "$ref": "NodeId", "description": "Id of the node to copy." }, 2384 { "name": "targetNodeId", "$ref": "NodeId", "description": "Id of the element to drop the copy into." }, 2385 { "name": "insertBeforeNodeId", "$ref": "NodeId", "optional": true, "description": "Drop the copy before this node (if absent, the copy becomes the last child of <code>targetNodeId</code>)." } 2386 ], 2387 "returns": [ 2388 { "name": "nodeId", "$ref": "NodeId", "description": "Id of the node clone." } 2389 ], 2390 "description": "Creates a deep copy of the specified node and places it into the target container before the given anchor.", 2391 "hidden": true 2392 }, 2393 { 2394 "name": "moveTo", 2395 "parameters": [ 2396 { "name": "nodeId", "$ref": "NodeId", "description": "Id of the node to move." }, 2397 { "name": "targetNodeId", "$ref": "NodeId", "description": "Id of the element to drop the moved node into." }, 2398 { "name": "insertBeforeNodeId", "$ref": "NodeId", "optional": true, "description": "Drop node before this one (if absent, the moved node becomes the last child of <code>targetNodeId</code>)." } 2399 ], 2400 "returns": [ 2401 { "name": "nodeId", "$ref": "NodeId", "description": "New id of the moved node." } 2402 ], 2403 "description": "Moves node into the new container, places it before the given anchor." 2404 }, 2405 { 2406 "name": "undo", 2407 "description": "Undoes the last performed action.", 2408 "hidden": true 2409 }, 2410 { 2411 "name": "redo", 2412 "description": "Re-does the last undone action.", 2413 "hidden": true 2414 }, 2415 { 2416 "name": "markUndoableState", 2417 "description": "Marks last undoable state.", 2418 "hidden": true 2419 }, 2420 { 2421 "name": "focus", 2422 "parameters": [ 2423 { "name": "nodeId", "$ref": "NodeId", "description": "Id of the node to focus." } 2424 ], 2425 "description": "Focuses the given element.", 2426 "hidden": true 2427 }, 2428 { 2429 "name": "setFileInputFiles", 2430 "parameters": [ 2431 { "name": "nodeId", "$ref": "NodeId", "description": "Id of the file input node to set files for." }, 2432 { "name": "files", "type": "array", "items": { "type": "string" }, "description": "Array of file paths to set." } 2433 ], 2434 "description": "Sets files for the given file input element.", 2435 "hidden": true, 2436 "handlers": ["browser", "renderer"] 2437 }, 2438 { 2439 "name": "getBoxModel", 2440 "parameters": [ 2441 { "name": "nodeId", "$ref": "NodeId", "description": "Id of the node to get box model for." } 2442 ], 2443 "returns": [ 2444 { "name": "model", "$ref": "BoxModel", "description": "Box model for the node." } 2445 ], 2446 "description": "Returns boxes for the currently selected nodes.", 2447 "hidden": true 2448 }, 2449 { 2450 "name": "getNodeForLocation", 2451 "parameters": [ 2452 { "name": "x", "type": "integer", "description": "X coordinate." }, 2453 { "name": "y", "type": "integer", "description": "Y coordinate." } 2454 ], 2455 "returns": [ 2456 { "name": "nodeId", "$ref": "NodeId", "description": "Id of the node at given coordinates." } 2457 ], 2458 "description": "Returns node id at given location.", 2459 "hidden": true 2460 }, 2461 { 2462 "name": "getRelayoutBoundary", 2463 "parameters": [ 2464 { "name": "nodeId", "$ref": "NodeId", "description": "Id of the node." } 2465 ], 2466 "returns": [ 2467 { "name": "nodeId", "$ref": "NodeId", "description": "Relayout boundary node id for the given node." } 2468 ], 2469 "description": "Returns the id of the nearest ancestor that is a relayout boundary.", 2470 "hidden": true 2471 } 2472 ], 2473 "events": [ 2474 { 2475 "name": "documentUpdated", 2476 "description": "Fired when <code>Document</code> has been totally updated. Node ids are no longer valid." 2477 }, 2478 { 2479 "name": "inspectNodeRequested", 2480 "parameters": [ 2481 { "name": "nodeId", "$ref": "NodeId", "description": "Id of the node to inspect." } 2482 ], 2483 "description": "Fired when the node should be inspected. This happens after call to <code>setInspectModeEnabled</code>.", 2484 "hidden" : true 2485 }, 2486 { 2487 "name": "setChildNodes", 2488 "parameters": [ 2489 { "name": "parentId", "$ref": "NodeId", "description": "Parent node id to populate with children." }, 2490 { "name": "nodes", "type": "array", "items": { "$ref": "Node" }, "description": "Child nodes array." } 2491 ], 2492 "description": "Fired when backend wants to provide client with the missing DOM structure. This happens upon most of the calls requesting node ids." 2493 }, 2494 { 2495 "name": "attributeModified", 2496 "parameters": [ 2497 { "name": "nodeId", "$ref": "NodeId", "description": "Id of the node that has changed." }, 2498 { "name": "name", "type": "string", "description": "Attribute name." }, 2499 { "name": "value", "type": "string", "description": "Attribute value." } 2500 ], 2501 "description": "Fired when <code>Element</code>'s attribute is modified." 2502 }, 2503 { 2504 "name": "attributeRemoved", 2505 "parameters": [ 2506 { "name": "nodeId", "$ref": "NodeId", "description": "Id of the node that has changed." }, 2507 { "name": "name", "type": "string", "description": "A ttribute name." } 2508 ], 2509 "description": "Fired when <code>Element</code>'s attribute is removed." 2510 }, 2511 { 2512 "name": "inlineStyleInvalidated", 2513 "parameters": [ 2514 { "name": "nodeIds", "type": "array", "items": { "$ref": "NodeId" }, "description": "Ids of the nodes for which the inline styles have been invalidated." } 2515 ], 2516 "description": "Fired when <code>Element</code>'s inline style is modified via a CSS property modification.", 2517 "hidden": true 2518 }, 2519 { 2520 "name": "characterDataModified", 2521 "parameters": [ 2522 { "name": "nodeId", "$ref": "NodeId", "description": "Id of the node that has changed." }, 2523 { "name": "characterData", "type": "string", "description": "New text value." } 2524 ], 2525 "description": "Mirrors <code>DOMCharacterDataModified</code> event." 2526 }, 2527 { 2528 "name": "childNodeCountUpdated", 2529 "parameters": [ 2530 { "name": "nodeId", "$ref": "NodeId", "description": "Id of the node that has changed." }, 2531 { "name": "childNodeCount", "type": "integer", "description": "New node count." } 2532 ], 2533 "description": "Fired when <code>Container</code>'s child node count has changed." 2534 }, 2535 { 2536 "name": "childNodeInserted", 2537 "parameters": [ 2538 { "name": "parentNodeId", "$ref": "NodeId", "description": "Id of the node that has changed." }, 2539 { "name": "previousNodeId", "$ref": "NodeId", "description": "If of the previous siblint." }, 2540 { "name": "node", "$ref": "Node", "description": "Inserted node data." } 2541 ], 2542 "description": "Mirrors <code>DOMNodeInserted</code> event." 2543 }, 2544 { 2545 "name": "childNodeRemoved", 2546 "parameters": [ 2547 { "name": "parentNodeId", "$ref": "NodeId", "description": "Parent id." }, 2548 { "name": "nodeId", "$ref": "NodeId", "description": "Id of the node that has been removed." } 2549 ], 2550 "description": "Mirrors <code>DOMNodeRemoved</code> event." 2551 }, 2552 { 2553 "name": "shadowRootPushed", 2554 "parameters": [ 2555 { "name": "hostId", "$ref": "NodeId", "description": "Host element id." }, 2556 { "name": "root", "$ref": "Node", "description": "Shadow root." } 2557 ], 2558 "description": "Called when shadow root is pushed into the element.", 2559 "hidden": true 2560 }, 2561 { 2562 "name": "shadowRootPopped", 2563 "parameters": [ 2564 { "name": "hostId", "$ref": "NodeId", "description": "Host element id." }, 2565 { "name": "rootId", "$ref": "NodeId", "description": "Shadow root id." } 2566 ], 2567 "description": "Called when shadow root is popped from the element.", 2568 "hidden": true 2569 }, 2570 { 2571 "name": "pseudoElementAdded", 2572 "parameters": [ 2573 { "name": "parentId", "$ref": "NodeId", "description": "Pseudo element's parent element id." }, 2574 { "name": "pseudoElement", "$ref": "Node", "description": "The added pseudo element." } 2575 ], 2576 "description": "Called when a pseudo element is added to an element.", 2577 "hidden": true 2578 }, 2579 { 2580 "name": "pseudoElementRemoved", 2581 "parameters": [ 2582 { "name": "parentId", "$ref": "NodeId", "description": "Pseudo element's parent element id." }, 2583 { "name": "pseudoElementId", "$ref": "NodeId", "description": "The removed pseudo element id." } 2584 ], 2585 "description": "Called when a pseudo element is removed from an element.", 2586 "hidden": true 2587 } 2588 ] 2589 }, 2590 { 2591 "domain": "CSS", 2592 "hidden": true, 2593 "description": "This domain exposes CSS read/write operations. All CSS objects (stylesheets, rules, and styles) have an associated <code>id</code> used in subsequent operations on the related object. Each object type has a specific <code>id</code> structure, and those are not interchangeable between objects of different kinds. CSS objects can be loaded using the <code>get*ForNode()</code> calls (which accept a DOM node id). A client can also discover all the existing stylesheets with the <code>getAllStyleSheets()</code> method (or keeping track of the <code>styleSheetAdded</code>/<code>styleSheetRemoved</code> events) and subsequently load the required stylesheet contents using the <code>getStyleSheet[Text]()</code> methods.", 2594 "types": [ 2595 { 2596 "id": "StyleSheetId", 2597 "type": "string" 2598 }, 2599 { 2600 "id": "StyleSheetOrigin", 2601 "type": "string", 2602 "enum": ["user", "user-agent", "inspector", "regular"], 2603 "description": "Stylesheet type: \"user\" for user stylesheets, \"user-agent\" for user-agent stylesheets, \"inspector\" for stylesheets created by the inspector (i.e. those holding the \"via inspector\" rules), \"regular\" for regular stylesheets." 2604 }, 2605 { 2606 "id": "PseudoIdMatches", 2607 "type": "object", 2608 "properties": [ 2609 { "name": "pseudoId", "type": "integer", "description": "Pseudo style identifier (see <code>enum PseudoId</code> in <code>RenderStyleConstants.h</code>)."}, 2610 { "name": "matches", "type": "array", "items": { "$ref": "RuleMatch" }, "description": "Matches of CSS rules applicable to the pseudo style."} 2611 ], 2612 "description": "CSS rule collection for a single pseudo style." 2613 }, 2614 { 2615 "id": "InheritedStyleEntry", 2616 "type": "object", 2617 "properties": [ 2618 { "name": "inlineStyle", "$ref": "CSSStyle", "optional": true, "description": "The ancestor node's inline style, if any, in the style inheritance chain." }, 2619 { "name": "matchedCSSRules", "type": "array", "items": { "$ref": "RuleMatch" }, "description": "Matches of CSS rules matching the ancestor node in the style inheritance chain." } 2620 ], 2621 "description": "Inherited CSS rule collection from ancestor node." 2622 }, 2623 { 2624 "id": "RuleMatch", 2625 "type": "object", 2626 "properties": [ 2627 { "name": "rule", "$ref": "CSSRule", "description": "CSS rule in the match." }, 2628 { "name": "matchingSelectors", "type": "array", "items": { "type": "integer" }, "description": "Matching selector indices in the rule's selectorList selectors (0-based)." } 2629 ], 2630 "description": "Match data for a CSS rule." 2631 }, 2632 { 2633 "id": "Selector", 2634 "type": "object", 2635 "properties": [ 2636 { "name": "value", "type": "string", "description": "Selector text." }, 2637 { "name": "range", "$ref": "SourceRange", "optional": true, "description": "Selector range in the underlying resource (if available)." } 2638 ], 2639 "description": "Data for a simple selector (these are delimited by commas in a selector list)." 2640 }, 2641 { 2642 "id": "SelectorList", 2643 "type": "object", 2644 "properties": [ 2645 { "name": "selectors", "type": "array", "items": { "$ref": "Selector" }, "description": "Selectors in the list." }, 2646 { "name": "text", "type": "string", "description": "Rule selector text." } 2647 ], 2648 "description": "Selector list data." 2649 }, 2650 { 2651 "id": "CSSStyleSheetHeader", 2652 "type": "object", 2653 "properties": [ 2654 { "name": "styleSheetId", "$ref": "StyleSheetId", "description": "The stylesheet identifier."}, 2655 { "name": "frameId", "$ref": "Page.FrameId", "description": "Owner frame identifier."}, 2656 { "name": "sourceURL", "type": "string", "description": "Stylesheet resource URL."}, 2657 { "name": "sourceMapURL", "type": "string", "optional": true, "description": "URL of source map associated with the stylesheet (if any)." }, 2658 { "name": "origin", "$ref": "StyleSheetOrigin", "description": "Stylesheet origin."}, 2659 { "name": "title", "type": "string", "description": "Stylesheet title."}, 2660 { "name": "disabled", "type": "boolean", "description": "Denotes whether the stylesheet is disabled."}, 2661 { "name": "hasSourceURL", "type": "boolean", "optional": true, "description": "Whether the sourceURL field value comes from the sourceURL comment." }, 2662 { "name": "isInline", "type": "boolean", "description": "Whether this stylesheet is created for STYLE tag by parser. This flag is not set for document.written STYLE tags." }, 2663 { "name": "startLine", "type": "number", "description": "Line offset of the stylesheet within the resource (zero based)." }, 2664 { "name": "startColumn", "type": "number", "description": "Column offset of the stylesheet within the resource (zero based)." } 2665 ], 2666 "description": "CSS stylesheet metainformation." 2667 }, 2668 { 2669 "id": "CSSRule", 2670 "type": "object", 2671 "properties": [ 2672 { "name": "styleSheetId", "$ref": "StyleSheetId", "optional": true, "description": "The css style sheet identifier (absent for user agent stylesheet and user-specified stylesheet rules) this rule came from." }, 2673 { "name": "selectorList", "$ref": "SelectorList", "description": "Rule selector data." }, 2674 { "name": "origin", "$ref": "StyleSheetOrigin", "description": "Parent stylesheet's origin."}, 2675 { "name": "style", "$ref": "CSSStyle", "description": "Associated style declaration." }, 2676 { "name": "media", "type": "array", "items": { "$ref": "CSSMedia" }, "optional": true, "description": "Media list array (for rules involving media queries). The array enumerates media queries starting with the innermost one, going outwards." } 2677 ], 2678 "description": "CSS rule representation." 2679 }, 2680 { 2681 "id": "SourceRange", 2682 "type": "object", 2683 "properties": [ 2684 { "name": "startLine", "type": "integer", "description": "Start line of range." }, 2685 { "name": "startColumn", "type": "integer", "description": "Start column of range (inclusive)." }, 2686 { "name": "endLine", "type": "integer", "description": "End line of range" }, 2687 { "name": "endColumn", "type": "integer", "description": "End column of range (exclusive)." } 2688 ], 2689 "description": "Text range within a resource. All numbers are zero-based." 2690 }, 2691 { 2692 "id": "ShorthandEntry", 2693 "type": "object", 2694 "properties": [ 2695 { "name": "name", "type": "string", "description": "Shorthand name." }, 2696 { "name": "value", "type": "string", "description": "Shorthand value." } 2697 ] 2698 }, 2699 { 2700 "id": "CSSComputedStyleProperty", 2701 "type": "object", 2702 "properties": [ 2703 { "name": "name", "type": "string", "description": "Computed style property name." }, 2704 { "name": "value", "type": "string", "description": "Computed style property value." } 2705 ] 2706 }, 2707 { 2708 "id": "CSSStyle", 2709 "type": "object", 2710 "properties": [ 2711 { "name": "styleSheetId", "$ref": "StyleSheetId", "optional": true, "description": "The css style sheet identifier (absent for user agent stylesheet and user-specified stylesheet rules) this rule came from." }, 2712 { "name": "cssProperties", "type": "array", "items": { "$ref": "CSSProperty" }, "description": "CSS properties in the style." }, 2713 { "name": "shorthandEntries", "type": "array", "items": { "$ref": "ShorthandEntry" }, "description": "Computed values for all shorthands found in the style." }, 2714 { "name": "cssText", "type": "string", "optional": true, "description": "Style declaration text (if available)." }, 2715 { "name": "range", "$ref": "SourceRange", "optional": true, "description": "Style declaration range in the enclosing stylesheet (if available)." } 2716 ], 2717 "description": "CSS style representation." 2718 }, 2719 { 2720 "id": "CSSProperty", 2721 "type": "object", 2722 "properties": [ 2723 { "name": "name", "type": "string", "description": "The property name." }, 2724 { "name": "value", "type": "string", "description": "The property value." }, 2725 { "name": "important", "type": "boolean", "optional": true, "description": "Whether the property has \"!important\" annotation (implies <code>false</code> if absent)." }, 2726 { "name": "implicit", "type": "boolean", "optional": true, "description": "Whether the property is implicit (implies <code>false</code> if absent)." }, 2727 { "name": "text", "type": "string", "optional": true, "description": "The full property text as specified in the style." }, 2728 { "name": "parsedOk", "type": "boolean", "optional": true, "description": "Whether the property is understood by the browser (implies <code>true</code> if absent)." }, 2729 { "name": "disabled", "type": "boolean", "optional": true, "description": "Whether the property is disabled by the user (present for source-based properties only)." }, 2730 { "name": "range", "$ref": "SourceRange", "optional": true, "description": "The entire property range in the enclosing style declaration (if available)." } 2731 ], 2732 "description": "CSS property declaration data." 2733 }, 2734 { 2735 "id": "CSSMedia", 2736 "type": "object", 2737 "properties": [ 2738 { "name": "text", "type": "string", "description": "Media query text." }, 2739 { "name": "source", "type": "string", "enum": ["mediaRule", "importRule", "linkedSheet", "inlineSheet"], "description": "Source of the media query: \"mediaRule\" if specified by a @media rule, \"importRule\" if specified by an @import rule, \"linkedSheet\" if specified by a \"media\" attribute in a linked stylesheet's LINK tag, \"inlineSheet\" if specified by a \"media\" attribute in an inline stylesheet's STYLE tag." }, 2740 { "name": "sourceURL", "type": "string", "optional": true, "description": "URL of the document containing the media query description." }, 2741 { "name": "range", "$ref": "SourceRange", "optional": true, "description": "The associated rule (@media or @import) header range in the enclosing stylesheet (if available)." }, 2742 { "name": "parentStyleSheetId", "$ref": "StyleSheetId", "optional": true, "description": "Identifier of the stylesheet containing this object (if exists)." }, 2743 { "name": "mediaList", "type": "array", "items": { "$ref": "MediaQuery" }, "optional": true, "hidden": true, "description": "Array of media queries." } 2744 ], 2745 "description": "CSS media rule descriptor." 2746 }, 2747 { 2748 "id": "MediaQuery", 2749 "type": "object", 2750 "properties": [ 2751 { "name": "expressions", "type": "array", "items": { "$ref": "MediaQueryExpression" }, "description": "Array of media query expressions." }, 2752 { "name": "active", "type": "boolean", "description": "Whether the media query condition is satisfied." } 2753 ], 2754 "description": "Media query descriptor.", 2755 "hidden": true 2756 }, 2757 { 2758 "id": "MediaQueryExpression", 2759 "type": "object", 2760 "properties": [ 2761 { "name": "value", "type": "number", "description": "Media query expression value."}, 2762 { "name": "unit", "type": "string", "description": "Media query expression units."}, 2763 { "name": "feature", "type": "string", "description": "Media query expression feature."}, 2764 { "name": "computedLength", "type": "number", "optional": true, "description": "Computed length of media query expression (if applicable)."} 2765 ], 2766 "description": "Media query expression descriptor.", 2767 "hidden": true 2768 }, 2769 { 2770 "id": "PlatformFontUsage", 2771 "type": "object", 2772 "properties": [ 2773 { "name": "familyName", "type": "string", "description": "Font's family name reported by platform."}, 2774 { "name": "glyphCount", "type": "number", "description": "Amount of glyphs that were rendered with this font."} 2775 ], 2776 "description": "Information about amount of glyphs that were rendered with given font.", 2777 "hidden": true 2778 } 2779 ], 2780 "commands": [ 2781 { 2782 "name": "enable", 2783 "async": true, 2784 "description": "Enables the CSS agent for the given page. Clients should not assume that the CSS agent has been enabled until the result of this command is received." 2785 }, 2786 { 2787 "name": "disable", 2788 "description": "Disables the CSS agent for the given page." 2789 }, 2790 { 2791 "name": "getMatchedStylesForNode", 2792 "parameters": [ 2793 { "name": "nodeId", "$ref": "DOM.NodeId" }, 2794 { "name": "excludePseudo", "type": "boolean", "optional": true, "description": "Whether to exclude pseudo styles (default: false)." }, 2795 { "name": "excludeInherited", "type": "boolean", "optional": true, "description": "Whether to exclude inherited styles (default: false)." } 2796 ], 2797 "returns": [ 2798 { "name": "matchedCSSRules", "type": "array", "items": { "$ref": "RuleMatch" }, "optional": true, "description": "CSS rules matching this node, from all applicable stylesheets." }, 2799 { "name": "pseudoElements", "type": "array", "items": { "$ref": "PseudoIdMatches" }, "optional": true, "description": "Pseudo style matches for this node." }, 2800 { "name": "inherited", "type": "array", "items": { "$ref": "InheritedStyleEntry" }, "optional": true, "description": "A chain of inherited styles (from the immediate node parent up to the DOM tree root)." } 2801 ], 2802 "description": "Returns requested styles for a DOM node identified by <code>nodeId</code>." 2803 }, 2804 { 2805 "name": "getInlineStylesForNode", 2806 "parameters": [ 2807 { "name": "nodeId", "$ref": "DOM.NodeId" } 2808 ], 2809 "returns": [ 2810 { "name": "inlineStyle", "$ref": "CSSStyle", "optional": true, "description": "Inline style for the specified DOM node." }, 2811 { "name": "attributesStyle", "$ref": "CSSStyle", "optional": true, "description": "Attribute-defined element style (e.g. resulting from \"width=20 height=100%\")."} 2812 ], 2813 "description": "Returns the styles defined inline (explicitly in the \"style\" attribute and implicitly, using DOM attributes) for a DOM node identified by <code>nodeId</code>." 2814 }, 2815 { 2816 "name": "getComputedStyleForNode", 2817 "parameters": [ 2818 { "name": "nodeId", "$ref": "DOM.NodeId" } 2819 ], 2820 "returns": [ 2821 { "name": "computedStyle", "type": "array", "items": { "$ref": "CSSComputedStyleProperty" }, "description": "Computed style for the specified DOM node." } 2822 ], 2823 "description": "Returns the computed style for a DOM node identified by <code>nodeId</code>." 2824 }, 2825 { 2826 "name": "getPlatformFontsForNode", 2827 "parameters": [ 2828 { "name": "nodeId", "$ref": "DOM.NodeId" } 2829 ], 2830 "returns": [ 2831 { "name": "cssFamilyName", "type": "string", "description": "Font family name which is determined by computed style." }, 2832 { "name": "fonts", "type": "array", "items": { "$ref": "PlatformFontUsage" }, "description": "Usage statistics for every employed platform font." } 2833 ], 2834 "description": "Requests information about platform fonts which we used to render child TextNodes in the given node.", 2835 "hidden": true 2836 }, 2837 { 2838 "name": "getStyleSheetText", 2839 "parameters": [ 2840 { "name": "styleSheetId", "$ref": "StyleSheetId" } 2841 ], 2842 "returns": [ 2843 { "name": "text", "type": "string", "description": "The stylesheet text." } 2844 ], 2845 "description": "Returns the current textual content and the URL for a stylesheet." 2846 }, 2847 { 2848 "name": "setStyleSheetText", 2849 "parameters": [ 2850 { "name": "styleSheetId", "$ref": "StyleSheetId" }, 2851 { "name": "text", "type": "string" } 2852 ], 2853 "description": "Sets the new stylesheet text." 2854 }, 2855 { 2856 "name": "setPropertyText", 2857 "parameters": [ 2858 { "name": "styleSheetId", "$ref": "StyleSheetId" }, 2859 { "name": "range", "$ref": "SourceRange", "description": "Either a source range of the property to be edited or an empty range representing a position for the property insertion." }, 2860 { "name": "text", "type": "string" } 2861 ], 2862 "returns": [ 2863 { "name": "style", "$ref": "CSSStyle", "description": "The resulting style after the property text modification." } 2864 ], 2865 "description": "Either replaces a property identified by <code>styleSheetId</code> and <code>range</code> with <code>text</code> or inserts a new property <code>text</code> at the position identified by an empty <code>range</code>." 2866 }, 2867 { 2868 "name": "setRuleSelector", 2869 "parameters": [ 2870 { "name": "styleSheetId", "$ref": "StyleSheetId" }, 2871 { "name": "range", "$ref": "SourceRange" }, 2872 { "name": "selector", "type": "string" } 2873 ], 2874 "returns": [ 2875 { "name": "rule", "$ref": "CSSRule", "description": "The resulting rule after the selector modification." } 2876 ], 2877 "description": "Modifies the rule selector." 2878 }, 2879 { 2880 "name": "createStyleSheet", 2881 "parameters": [ 2882 { "name": "frameId", "$ref": "Page.FrameId", "description": "Identifier of the frame where \"via-inspector\" stylesheet should be created."} 2883 ], 2884 "returns": [ 2885 { "name": "styleSheetId", "$ref": "StyleSheetId", "description": "Identifier of the created \"via-inspector\" stylesheet." } 2886 ], 2887 "description": "Creates a new special \"via-inspector\" stylesheet in the frame with given <code>frameId</code>." 2888 }, 2889 { 2890 "name": "addRule", 2891 "parameters": [ 2892 { "name": "styleSheetId", "$ref": "StyleSheetId", "description": "The css style sheet identifier where a new rule should be inserted." }, 2893 { "name": "ruleText", "type": "string", "description": "The text of a new rule." }, 2894 { "name": "location", "$ref": "SourceRange", "description": "Text position of a new rule in the target style sheet." } 2895 ], 2896 "returns": [ 2897 { "name": "rule", "$ref": "CSSRule", "description": "The newly created rule." } 2898 ], 2899 "description": "Inserts a new rule with the given <code>ruleText</code> in a stylesheet with given <code>styleSheetId</code>, at the position specified by <code>location</code>." 2900 }, 2901 { 2902 "name": "forcePseudoState", 2903 "parameters": [ 2904 { "name": "nodeId", "$ref": "DOM.NodeId", "description": "The element id for which to force the pseudo state." }, 2905 { "name": "forcedPseudoClasses", "type": "array", "items": { "type": "string", "enum": ["active", "focus", "hover", "visited"] }, "description": "Element pseudo classes to force when computing the element's style." } 2906 ], 2907 "description": "Ensures that the given node will have specified pseudo-classes whenever its style is computed by the browser." 2908 }, 2909 { 2910 "name": "getMediaQueries", 2911 "returns": [ 2912 { "name": "medias", "type": "array", "items": { "$ref": "CSSMedia" } } 2913 ], 2914 "description": "Returns all media queries parsed by the rendering engine.", 2915 "hidden": true 2916 } 2917 ], 2918 "events": [ 2919 { 2920 "name": "mediaQueryResultChanged", 2921 "description": "Fires whenever a MediaQuery result changes (for example, after a browser window has been resized.) The current implementation considers only viewport-dependent media features." 2922 }, 2923 { 2924 "name": "styleSheetChanged", 2925 "parameters": [ 2926 { "name": "styleSheetId", "$ref": "StyleSheetId" } 2927 ], 2928 "description": "Fired whenever a stylesheet is changed as a result of the client operation." 2929 }, 2930 { 2931 "name": "styleSheetAdded", 2932 "parameters": [ 2933 { "name": "header", "$ref": "CSSStyleSheetHeader", "description": "Added stylesheet metainfo." } 2934 ], 2935 "description": "Fired whenever an active document stylesheet is added." 2936 }, 2937 { 2938 "name": "styleSheetRemoved", 2939 "parameters": [ 2940 { "name": "styleSheetId", "$ref": "StyleSheetId", "description": "Identifier of the removed stylesheet." } 2941 ], 2942 "description": "Fired whenever an active document stylesheet is removed." 2943 } 2944 ] 2945 }, 2946 { 2947 "domain": "Timeline", 2948 "description": "Timeline provides its clients with instrumentation records that are generated during the page runtime. Timeline instrumentation can be started and stopped using corresponding commands. While timeline is started, it is generating timeline event records.", 2949 "types": [ 2950 { 2951 "id": "Counters", 2952 "type": "object", 2953 "properties": [ 2954 { "name": "documents", "type": "integer", "optional": true }, 2955 { "name": "nodes", "type": "integer", "optional": true }, 2956 { "name": "jsEventListeners", "type": "integer", "optional": true }, 2957 { "name": "jsHeapSizeUsed", "type": "number", "optional": true, "description": "Currently used size of JS heap." }, 2958 { "name": "gpuMemoryUsedKB", "type": "number", "optional": true, "description": "Current GPU memory usage in kilobytes." }, 2959 { "name": "gpuMemoryLimitKB", "type": "number", "optional": true, "description": "Current GPU memory limit in kilobytes." } 2960 ], 2961 "description": "Current values of counters.", 2962 "hidden": true 2963 }, 2964 { 2965 "id": "TimelineEvent", 2966 "type": "object", 2967 "properties": [ 2968 { "name": "type", "type": "string", "description": "Event type." }, 2969 { "name": "data", "type": "object", "description": "Event data." }, 2970 { "name": "startTime", "type": "number", "description": "Start time." }, 2971 { "name": "endTime", "type": "number", "optional": true, "description": "End time." }, 2972 { "name": "children", "type": "array", "optional": true, "items": { "$ref": "TimelineEvent" }, "description": "Nested records." }, 2973 { "name": "thread", "type": "string", "optional": true, "hidden": true, "description": "If present, identifies the thread that produced the event." }, 2974 { "name": "stackTrace", "$ref": "Console.StackTrace", "optional": true, "hidden": true, "description": "Stack trace." }, 2975 { "name": "frameId", "type": "string", "optional": true, "hidden": true, "description": "Unique identifier of the frame within the page that the event relates to." } 2976 ], 2977 "description": "Timeline record contains information about the recorded activity." 2978 } 2979 ], 2980 "commands": [ 2981 { 2982 "name": "enable", 2983 "description": "Enables timeline. After this call, timeline can be started from within the page (for example upon console.timeline)." 2984 }, 2985 { 2986 "name": "disable", 2987 "description": "Disables timeline." 2988 }, 2989 { 2990 "name": "start", 2991 "parameters": [ 2992 { "name": "maxCallStackDepth", "optional": true, "type": "integer", "description": "Samples JavaScript stack traces up to <code>maxCallStackDepth</code>, defaults to 5." }, 2993 { "name": "bufferEvents", "optional": true, "type": "boolean", "hidden": true, "description": "Whether instrumentation events should be buffered and returned upon <code>stop</code> call." }, 2994 { "name": "liveEvents", "optional": true, "type": "string", "hidden": true, "description": "Coma separated event types to issue although bufferEvents is set."}, 2995 { "name": "includeCounters", "optional": true, "type": "boolean", "hidden": true, "description": "Whether counters data should be included into timeline events." }, 2996 { "name": "includeGPUEvents", "optional": true, "type": "boolean", "hidden": true, "description": "Whether events from GPU process should be collected." } 2997 ], 2998 "description": "Starts capturing instrumentation events." 2999 }, 3000 { 3001 "name": "stop", 3002 "description": "Stops capturing instrumentation events." 3003 } 3004 ], 3005 "events": [ 3006 { 3007 "name": "eventRecorded", 3008 "parameters": [ 3009 { "name": "record", "$ref": "TimelineEvent", "description": "Timeline event record data." } 3010 ], 3011 "description": "Fired for every instrumentation event while timeline is started." 3012 }, 3013 { 3014 "name": "progress", 3015 "parameters": [ 3016 { "name": "count", "type": "number" } 3017 ], 3018 "hidden": true 3019 }, 3020 { 3021 "name": "started", 3022 "parameters": [ 3023 { "name": "consoleTimeline", "type": "boolean", "optional": true, "description": "If specified, identifies that timeline was started using console.timeline() call." } 3024 ], 3025 "description": "Fired when timeline is started.", 3026 "hidden": true 3027 }, 3028 { 3029 "name": "stopped", 3030 "parameters": [ 3031 { "name": "consoleTimeline", "type": "boolean", "optional": true, "description": "If specified, identifies that timeline was started using console.timeline() call." }, 3032 { "name": "events", "type": "array", "items": { "$ref": "TimelineEvent" }, "optional": true, "hidden": true, "description": "Timeline event record data." } 3033 ], 3034 "description": "Fired when timeline is stopped.", 3035 "hidden": true 3036 } 3037 ] 3038 }, 3039 { 3040 "domain": "Debugger", 3041 "description": "Debugger domain exposes JavaScript debugging capabilities. It allows setting and removing breakpoints, stepping through execution, exploring stack traces, etc.", 3042 "types": [ 3043 { 3044 "id": "BreakpointId", 3045 "type": "string", 3046 "description": "Breakpoint identifier." 3047 }, 3048 { 3049 "id": "ScriptId", 3050 "type": "string", 3051 "description": "Unique script identifier." 3052 }, 3053 { 3054 "id": "CallFrameId", 3055 "type": "string", 3056 "description": "Call frame identifier." 3057 }, 3058 { 3059 "id": "Location", 3060 "type": "object", 3061 "properties": [ 3062 { "name": "scriptId", "$ref": "ScriptId", "description": "Script identifier as reported in the <code>Debugger.scriptParsed</code>." }, 3063 { "name": "lineNumber", "type": "integer", "description": "Line number in the script (0-based)." }, 3064 { "name": "columnNumber", "type": "integer", "optional": true, "description": "Column number in the script (0-based)." } 3065 ], 3066 "description": "Location in the source code." 3067 }, 3068 { 3069 "id": "FunctionDetails", 3070 "hidden": true, 3071 "type": "object", 3072 "properties": [ 3073 { "name": "location", "$ref": "Location", "description": "Location of the function." }, 3074 { "name": "functionName", "type": "string", "description": "Name of the function." }, 3075 { "name": "scopeChain", "type": "array", "optional": true, "items": { "$ref": "Scope" }, "description": "Scope chain for this closure." } 3076 ], 3077 "description": "Information about the function." 3078 }, 3079 { 3080 "id": "CollectionEntry", 3081 "hidden": true, 3082 "type": "object", 3083 "properties": [ 3084 { "name": "key", "$ref": "Runtime.RemoteObject", "optional": true, "description": "Entry key of a map-like collection, otherwise not provided." }, 3085 { "name": "value", "$ref": "Runtime.RemoteObject", "description": "Entry value." } 3086 ], 3087 "description": "Collection entry." 3088 }, 3089 { 3090 "id": "CallFrame", 3091 "type": "object", 3092 "properties": [ 3093 { "name": "callFrameId", "$ref": "CallFrameId", "description": "Call frame identifier. This identifier is only valid while the virtual machine is paused." }, 3094 { "name": "functionName", "type": "string", "description": "Name of the JavaScript function called on this call frame." }, 3095 { "name": "location", "$ref": "Location", "description": "Location in the source code." }, 3096 { "name": "scopeChain", "type": "array", "items": { "$ref": "Scope" }, "description": "Scope chain for this call frame." }, 3097 { "name": "this", "$ref": "Runtime.RemoteObject", "description": "<code>this</code> object for this call frame." }, 3098 { "name": "returnValue", "$ref": "Runtime.RemoteObject", "optional": true, "hidden": true, "description": "The value being returned, if the function is at return point." } 3099 ], 3100 "description": "JavaScript call frame. Array of call frames form the call stack." 3101 }, 3102 { 3103 "id": "StackTrace", 3104 "type": "object", 3105 "properties": [ 3106 { "name": "callFrames", "type": "array", "items": { "$ref": "CallFrame" }, "description": "Call frames of the stack trace." }, 3107 { "name": "description", "type": "string", "optional": true, "description": "String label of this stack trace. For async traces this may be a name of the function that initiated the async call." }, 3108 { "name": "asyncStackTrace", "$ref": "StackTrace", "optional": true, "description": "Async stack trace, if any." } 3109 ], 3110 "description": "JavaScript call stack, including async stack traces.", 3111 "hidden": true 3112 }, 3113 { 3114 "id": "Scope", 3115 "type": "object", 3116 "properties": [ 3117 { "name": "type", "type": "string", "enum": ["global", "local", "with", "closure", "catch"], "description": "Scope type." }, 3118 { "name": "object", "$ref": "Runtime.RemoteObject", "description": "Object representing the scope. For <code>global</code> and <code>with</code> scopes it represents the actual object; for the rest of the scopes, it is artificial transient object enumerating scope variables as its properties." } 3119 ], 3120 "description": "Scope description." 3121 }, 3122 { 3123 "id": "ExceptionDetails", 3124 "type": "object", 3125 "description": "Detailed information on exception (or error) that was thrown during script compilation or execution.", 3126 "properties": [ 3127 { "name": "text", "type": "string", "description": "Exception text." }, 3128 { "name": "url", "type": "string", "optional": true, "description": "URL of the message origin." }, 3129 { "name": "line", "type": "integer", "optional": true, "description": "Line number in the resource that generated this message." }, 3130 { "name": "column", "type": "integer", "optional": true, "description": "Column number in the resource that generated this message." }, 3131 { "name": "stackTrace", "$ref": "Console.StackTrace", "optional": true, "description": "JavaScript stack trace for assertions and error messages." } 3132 ] 3133 }, 3134 { 3135 "id": "SetScriptSourceError", 3136 "type": "object", 3137 "properties": [ 3138 { "name": "compileError", "optional": true, "type": "object", "properties": 3139 [ 3140 { "name": "message", "type": "string", "description": "Compiler error message" }, 3141 { "name": "lineNumber", "type": "integer", "description": "Compile error line number (1-based)" }, 3142 { "name": "columnNumber", "type": "integer", "description": "Compile error column number (1-based)" } 3143 ] 3144 } 3145 ], 3146 "description": "Error data for setScriptSource command. compileError is a case type for uncompilable script source error.", 3147 "hidden": true 3148 }, 3149 { 3150 "id": "PromiseDetails", 3151 "type": "object", 3152 "description": "Information about the promise.", 3153 "properties": [ 3154 { "name": "id", "type": "integer", "description": "Unique id of the promise." }, 3155 { "name": "status", "type": "string", "enum": ["pending", "resolved", "rejected"], "description": "Status of the promise." }, 3156 { "name": "parentId", "type": "integer", "optional": true, "description": "Id of the parent promise." }, 3157 { "name": "callFrame", "$ref": "Console.CallFrame", "optional": true, "description": "Top call frame on promise creation."} 3158 ], 3159 "hidden": true 3160 } 3161 ], 3162 "commands": [ 3163 { 3164 "name": "enable", 3165 "description": "Enables debugger for the given page. Clients should not assume that the debugging has been enabled until the result for this command is received." 3166 }, 3167 { 3168 "name": "disable", 3169 "description": "Disables debugger for given page." 3170 }, 3171 { 3172 "name": "setBreakpointsActive", 3173 "parameters": [ 3174 { "name": "active", "type": "boolean", "description": "New value for breakpoints active state." } 3175 ], 3176 "description": "Activates / deactivates all breakpoints on the page." 3177 }, 3178 { 3179 "name": "setSkipAllPauses", 3180 "hidden": true, 3181 "parameters": [ 3182 { "name": "skipped", "type": "boolean", "description": "New value for skip pauses state." }, 3183 { "name": "untilReload", "type": "boolean", "optional": true, "description": "Whether page reload should set skipped to false." } 3184 ], 3185 "description": "Makes page not interrupt on any pauses (breakpoint, exception, dom exception etc)." 3186 }, 3187 { 3188 "name": "setBreakpointByUrl", 3189 "parameters": [ 3190 { "name": "lineNumber", "type": "integer", "description": "Line number to set breakpoint at." }, 3191 { "name": "url", "type": "string", "optional": true, "description": "URL of the resources to set breakpoint on." }, 3192 { "name": "urlRegex", "type": "string", "optional": true, "description": "Regex pattern for the URLs of the resources to set breakpoints on. Either <code>url</code> or <code>urlRegex</code> must be specified." }, 3193 { "name": "columnNumber", "type": "integer", "optional": true, "description": "Offset in the line to set breakpoint at." }, 3194 { "name": "condition", "type": "string", "optional": true, "description": "Expression to use as a breakpoint condition. When specified, debugger will only stop on the breakpoint if this expression evaluates to true." }, 3195 { "name": "isAntibreakpoint", "type": "boolean", "optional": true, "hidden": true, "description": "Creates pseudo-breakpoint that prevents debugger from pausing on exception at this location." } 3196 ], 3197 "returns": [ 3198 { "name": "breakpointId", "$ref": "BreakpointId", "description": "Id of the created breakpoint for further reference." }, 3199 { "name": "locations", "type": "array", "items": { "$ref": "Location" }, "description": "List of the locations this breakpoint resolved into upon addition." } 3200 ], 3201 "description": "Sets JavaScript breakpoint at given location specified either by URL or URL regex. Once this command is issued, all existing parsed scripts will have breakpoints resolved and returned in <code>locations</code> property. Further matching script parsing will result in subsequent <code>breakpointResolved</code> events issued. This logical breakpoint will survive page reloads." 3202 }, 3203 { 3204 "name": "setBreakpoint", 3205 "parameters": [ 3206 { "name": "location", "$ref": "Location", "description": "Location to set breakpoint in." }, 3207 { "name": "condition", "type": "string", "optional": true, "description": "Expression to use as a breakpoint condition. When specified, debugger will only stop on the breakpoint if this expression evaluates to true." } 3208 ], 3209 "returns": [ 3210 { "name": "breakpointId", "$ref": "BreakpointId", "description": "Id of the created breakpoint for further reference." }, 3211 { "name": "actualLocation", "$ref": "Location", "description": "Location this breakpoint resolved into." } 3212 ], 3213 "description": "Sets JavaScript breakpoint at a given location." 3214 }, 3215 { 3216 "name": "removeBreakpoint", 3217 "parameters": [ 3218 { "name": "breakpointId", "$ref": "BreakpointId" } 3219 ], 3220 "description": "Removes JavaScript breakpoint." 3221 }, 3222 { 3223 "name": "continueToLocation", 3224 "parameters": [ 3225 { "name": "location", "$ref": "Location", "description": "Location to continue to." }, 3226 { "name": "interstatementLocation", "type": "boolean", "optional": true, "hidden": true, "description": "Allows breakpoints at the intemediate positions inside statements." } 3227 ], 3228 "description": "Continues execution until specific location is reached." 3229 }, 3230 { 3231 "name": "stepOver", 3232 "description": "Steps over the statement." 3233 }, 3234 { 3235 "name": "stepInto", 3236 "description": "Steps into the function call." 3237 }, 3238 { 3239 "name": "stepOut", 3240 "description": "Steps out of the function call." 3241 }, 3242 { 3243 "name": "pause", 3244 "description": "Stops on the next JavaScript statement." 3245 }, 3246 { 3247 "name": "resume", 3248 "description": "Resumes JavaScript execution." 3249 }, 3250 { 3251 "name": "searchInContent", 3252 "parameters": [ 3253 { "name": "scriptId", "$ref": "ScriptId", "description": "Id of the script to search in." }, 3254 { "name": "query", "type": "string", "description": "String to search for." }, 3255 { "name": "caseSensitive", "type": "boolean", "optional": true, "description": "If true, search is case sensitive." }, 3256 { "name": "isRegex", "type": "boolean", "optional": true, "description": "If true, treats string parameter as regex." } 3257 ], 3258 "returns": [ 3259 { "name": "result", "type": "array", "items": { "$ref": "Page.SearchMatch" }, "description": "List of search matches." } 3260 ], 3261 "description": "Searches for given string in script content." 3262 }, 3263 { 3264 "name": "canSetScriptSource", 3265 "returns": [ 3266 { "name": "result", "type": "boolean", "description": "True if <code>setScriptSource</code> is supported." } 3267 ], 3268 "description": "Always returns true." 3269 }, 3270 { 3271 "name": "setScriptSource", 3272 "parameters": [ 3273 { "name": "scriptId", "$ref": "ScriptId", "description": "Id of the script to edit." }, 3274 { "name": "scriptSource", "type": "string", "description": "New content of the script." }, 3275 { "name": "preview", "type": "boolean", "optional": true, "description": " If true the change will not actually be applied. Preview mode may be used to get result description without actually modifying the code.", "hidden": true } 3276 ], 3277 "returns": [ 3278 { "name": "callFrames", "type": "array", "optional": true, "items": { "$ref": "CallFrame" }, "description": "New stack trace in case editing has happened while VM was stopped." }, 3279 { "name": "result", "type": "object", "optional": true, "description": "VM-specific description of the changes applied.", "hidden": true }, 3280 { "name": "asyncStackTrace", "$ref": "StackTrace", "optional": true, "description": "Async stack trace, if any.", "hidden": true } 3281 ], 3282 "error": { 3283 "$ref": "SetScriptSourceError" 3284 }, 3285 "description": "Edits JavaScript source live." 3286 }, 3287 { 3288 "name": "restartFrame", 3289 "parameters": [ 3290 { "name": "callFrameId", "$ref": "CallFrameId", "description": "Call frame identifier to evaluate on." } 3291 ], 3292 "returns": [ 3293 { "name": "callFrames", "type": "array", "items": { "$ref": "CallFrame" }, "description": "New stack trace." }, 3294 { "name": "result", "type": "object", "description": "VM-specific description." }, 3295 { "name": "asyncStackTrace", "$ref": "StackTrace", "optional": true, "description": "Async stack trace, if any." } 3296 ], 3297 "hidden": true, 3298 "description": "Restarts particular call frame from the beginning." 3299 }, 3300 { 3301 "name": "getScriptSource", 3302 "parameters": [ 3303 { "name": "scriptId", "$ref": "ScriptId", "description": "Id of the script to get source for." } 3304 ], 3305 "returns": [ 3306 { "name": "scriptSource", "type": "string", "description": "Script source." } 3307 ], 3308 "description": "Returns source for the script with given id." 3309 }, 3310 { 3311 "name": "getFunctionDetails", 3312 "hidden": true, 3313 "parameters": [ 3314 { "name": "functionId", "$ref": "Runtime.RemoteObjectId", "description": "Id of the function to get location for." } 3315 ], 3316 "returns": [ 3317 { "name": "details", "$ref": "FunctionDetails", "description": "Information about the function." } 3318 ], 3319 "description": "Returns detailed information on given function." 3320 }, 3321 { 3322 "name": "getCollectionEntries", 3323 "hidden": true, 3324 "parameters": [ 3325 { "name": "objectId", "$ref": "Runtime.RemoteObjectId", "description": "Id of the collection to get entries for." } 3326 ], 3327 "returns": [ 3328 { "name": "entries", "type": "array", "items": { "$ref": "CollectionEntry" }, "description": "Array of collection entries." } 3329 ], 3330 "description": "Returns entries of given collection." 3331 }, 3332 { 3333 "name": "setPauseOnExceptions", 3334 "parameters": [ 3335 { "name": "state", "type": "string", "enum": ["none", "uncaught", "all"], "description": "Pause on exceptions mode." } 3336 ], 3337 "description": "Defines pause on exceptions state. Can be set to stop on all exceptions, uncaught exceptions or no exceptions. Initial pause on exceptions state is <code>none</code>." 3338 }, 3339 { 3340 "name": "evaluateOnCallFrame", 3341 "parameters": [ 3342 { "name": "callFrameId", "$ref": "CallFrameId", "description": "Call frame identifier to evaluate on." }, 3343 { "name": "expression", "type": "string", "description": "Expression to evaluate." }, 3344 { "name": "objectGroup", "type": "string", "optional": true, "description": "String object group name to put result into (allows rapid releasing resulting object handles using <code>releaseObjectGroup</code>)." }, 3345 { "name": "includeCommandLineAPI", "type": "boolean", "optional": true, "description": "Specifies whether command line API should be available to the evaluated expression, defaults to false.", "hidden": true }, 3346 { "name": "doNotPauseOnExceptionsAndMuteConsole", "type": "boolean", "optional": true, "description": "Specifies whether evaluation should stop on exceptions and mute console. Overrides setPauseOnException state.", "hidden": true }, 3347 { "name": "returnByValue", "type": "boolean", "optional": true, "description": "Whether the result is expected to be a JSON object that should be sent by value." }, 3348 { "name": "generatePreview", "type": "boolean", "optional": true, "hidden": true, "description": "Whether preview should be generated for the result." } 3349 ], 3350 "returns": [ 3351 { "name": "result", "$ref": "Runtime.RemoteObject", "description": "Object wrapper for the evaluation result." }, 3352 { "name": "wasThrown", "type": "boolean", "optional": true, "description": "True if the result was thrown during the evaluation." }, 3353 { "name": "exceptionDetails", "$ref": "Debugger.ExceptionDetails", "optional": true, "hidden": true, "description": "Exception details."} 3354 ], 3355 "description": "Evaluates expression on a given call frame." 3356 }, 3357 { 3358 "name": "compileScript", 3359 "hidden": true, 3360 "parameters": [ 3361 { "name": "expression", "type": "string", "description": "Expression to compile." }, 3362 { "name": "sourceURL", "type": "string", "description": "Source url to be set for the script." }, 3363 { "name": "executionContextId", "$ref": "Runtime.ExecutionContextId", "optional": true, "description": "Specifies in which isolated context to perform script run. Each content script lives in an isolated context and this parameter may be used to specify one of those contexts. If the parameter is omitted or 0 the evaluation will be performed in the context of the inspected page." } 3364 ], 3365 "returns": [ 3366 { "name": "scriptId", "$ref": "ScriptId", "optional": true, "description": "Id of the script." }, 3367 { "name": "exceptionDetails", "$ref": "ExceptionDetails", "optional": true, "description": "Exception details."} 3368 ], 3369 "description": "Compiles expression." 3370 }, 3371 { 3372 "name": "runScript", 3373 "hidden": true, 3374 "parameters": [ 3375 { "name": "scriptId", "$ref": "ScriptId", "description": "Id of the script to run." }, 3376 { "name": "executionContextId", "$ref": "Runtime.ExecutionContextId", "optional": true, "description": "Specifies in which isolated context to perform script run. Each content script lives in an isolated context and this parameter may be used to specify one of those contexts. If the parameter is omitted or 0 the evaluation will be performed in the context of the inspected page." }, 3377 { "name": "objectGroup", "type": "string", "optional": true, "description": "Symbolic group name that can be used to release multiple objects." }, 3378 { "name": "doNotPauseOnExceptionsAndMuteConsole", "type": "boolean", "optional": true, "description": "Specifies whether script run should stop on exceptions and mute console. Overrides setPauseOnException state." } 3379 ], 3380 "returns": [ 3381 { "name": "result", "$ref": "Runtime.RemoteObject", "description": "Run result." }, 3382 { "name": "exceptionDetails", "$ref": "ExceptionDetails", "optional": true, "description": "Exception details."} 3383 ], 3384 "description": "Runs script with given id in a given context." 3385 }, 3386 { 3387 "name": "setOverlayMessage", 3388 "parameters": [ 3389 { "name": "message", "type": "string", "optional": true, "description": "Overlay message to display when paused in debugger." } 3390 ], 3391 "hidden": true, 3392 "description": "Sets overlay message." 3393 }, 3394 { 3395 "name": "setVariableValue", 3396 "parameters": [ 3397 { "name": "scopeNumber", "type": "integer", "description": "0-based number of scope as was listed in scope chain. Only 'local', 'closure' and 'catch' scope types are allowed. Other scopes could be manipulated manually." }, 3398 { "name": "variableName", "type": "string", "description": "Variable name." }, 3399 { "name": "newValue", "$ref": "Runtime.CallArgument", "description": "New variable value." }, 3400 { "name": "callFrameId", "$ref": "CallFrameId", "optional": true, "description": "Id of callframe that holds variable." }, 3401 { "name": "functionObjectId", "$ref": "Runtime.RemoteObjectId", "optional": true, "description": "Object id of closure (function) that holds variable." } 3402 ], 3403 "hidden": true, 3404 "description": "Changes value of variable in a callframe or a closure. Either callframe or function must be specified. Object-based scopes are not supported and must be mutated manually." 3405 }, 3406 { 3407 "name": "getStepInPositions", 3408 "parameters": [ 3409 { "name": "callFrameId", "$ref": "CallFrameId", "description": "Id of a call frame where the current statement should be analized" } 3410 ], 3411 "returns": [ 3412 { "name": "stepInPositions", "type": "array", "items": { "$ref": "Location" }, "optional": true, "description": "experimental" } 3413 ], 3414 "hidden": true, 3415 "description": "Lists all positions where step-in is possible for a current statement in a specified call frame" 3416 }, 3417 { 3418 "name": "getBacktrace", 3419 "returns": [ 3420 { "name": "callFrames", "type": "array", "items": { "$ref": "CallFrame" }, "description": "Call stack the virtual machine stopped on." }, 3421 { "name": "asyncStackTrace", "$ref": "StackTrace", "optional": true, "description": "Async stack trace, if any." } 3422 ], 3423 "hidden": true, 3424 "description": "Returns call stack including variables changed since VM was paused. VM must be paused." 3425 }, 3426 { 3427 "name": "skipStackFrames", 3428 "parameters": [ 3429 { "name": "script", "type": "string", "optional": true, "description": "Regular expression defining the scripts to ignore while stepping." }, 3430 { "name": "skipContentScripts", "type": "boolean", "optional": true, "description": "True, if all content scripts should be ignored." } 3431 ], 3432 "hidden": true, 3433 "description": "Makes backend skip steps in the sources with names matching given pattern. VM will try leave blacklisted scripts by performing 'step in' several times, finally resorting to 'step out' if unsuccessful." 3434 }, 3435 { 3436 "name": "setAsyncCallStackDepth", 3437 "parameters": [ 3438 { "name": "maxDepth", "type": "integer", "description": "Maximum depth of async call stacks. Setting to <code>0</code> will effectively disable collecting async call stacks (default)." } 3439 ], 3440 "hidden": true, 3441 "description": "Enables or disables async call stacks tracking." 3442 }, 3443 { 3444 "name": "enablePromiseTracker", 3445 "hidden": true, 3446 "description": "Enables promise tracking, information about <code>Promise</code>s created or updated will now be stored on the backend." 3447 }, 3448 { 3449 "name": "disablePromiseTracker", 3450 "hidden": true, 3451 "description": "Disables promise tracking." 3452 }, 3453 { 3454 "name": "getPromises", 3455 "returns": [ 3456 { "name": "promises", "type": "array", "items": { "$ref": "PromiseDetails" }, "description": "Information about stored promises." } 3457 ], 3458 "hidden": true, 3459 "description": "Returns detailed information about all <code>Promise</code>s that were created or updated after the <code>enablePromiseTracker</code> command, and have not been garbage collected yet." 3460 }, 3461 { 3462 "name": "getPromiseById", 3463 "parameters": [ 3464 { "name": "promiseId", "type": "integer" }, 3465 { "name": "objectGroup", "type": "string", "optional": true, "description": "Symbolic group name that can be used to release multiple objects." } 3466 ], 3467 "returns": [ 3468 { "name": "promise", "$ref": "Runtime.RemoteObject", "description": "Object wrapper for <code>Promise</code> with specified ID, if any." } 3469 ], 3470 "hidden": true, 3471 "description": "Returns <code>Promise</code> with specified ID." 3472 } 3473 ], 3474 "events": [ 3475 { 3476 "name": "globalObjectCleared", 3477 "description": "Called when global has been cleared and debugger client should reset its state. Happens upon navigation or reload." 3478 }, 3479 { 3480 "name": "scriptParsed", 3481 "parameters": [ 3482 { "name": "scriptId", "$ref": "ScriptId", "description": "Identifier of the script parsed." }, 3483 { "name": "url", "type": "string", "description": "URL or name of the script parsed (if any)." }, 3484 { "name": "startLine", "type": "integer", "description": "Line offset of the script within the resource with given URL (for script tags)." }, 3485 { "name": "startColumn", "type": "integer", "description": "Column offset of the script within the resource with given URL." }, 3486 { "name": "endLine", "type": "integer", "description": "Last line of the script." }, 3487 { "name": "endColumn", "type": "integer", "description": "Length of the last line of the script." }, 3488 { "name": "isContentScript", "type": "boolean", "optional": true, "description": "Determines whether this script is a user extension script." }, 3489 { "name": "sourceMapURL", "type": "string", "optional": true, "description": "URL of source map associated with script (if any)." }, 3490 { "name": "hasSourceURL", "type": "boolean", "optional": true, "description": "True, if this script has sourceURL.", "hidden": true } 3491 ], 3492 "description": "Fired when virtual machine parses script. This event is also fired for all known and uncollected scripts upon enabling debugger." 3493 }, 3494 { 3495 "name": "scriptFailedToParse", 3496 "parameters": [ 3497 { "name": "scriptId", "$ref": "ScriptId", "description": "Identifier of the script parsed." }, 3498 { "name": "url", "type": "string", "description": "URL or name of the script parsed (if any)." }, 3499 { "name": "startLine", "type": "integer", "description": "Line offset of the script within the resource with given URL (for script tags)." }, 3500 { "name": "startColumn", "type": "integer", "description": "Column offset of the script within the resource with given URL." }, 3501 { "name": "endLine", "type": "integer", "description": "Last line of the script." }, 3502 { "name": "endColumn", "type": "integer", "description": "Length of the last line of the script." }, 3503 { "name": "isContentScript", "type": "boolean", "optional": true, "description": "Determines whether this script is a user extension script." }, 3504 { "name": "sourceMapURL", "type": "string", "optional": true, "description": "URL of source map associated with script (if any)." }, 3505 { "name": "hasSourceURL", "type": "boolean", "optional": true, "description": "True, if this script has sourceURL.", "hidden": true } 3506 ], 3507 "description": "Fired when virtual machine fails to parse the script." 3508 }, 3509 { 3510 "name": "breakpointResolved", 3511 "parameters": [ 3512 { "name": "breakpointId", "$ref": "BreakpointId", "description": "Breakpoint unique identifier." }, 3513 { "name": "location", "$ref": "Location", "description": "Actual breakpoint location." } 3514 ], 3515 "description": "Fired when breakpoint is resolved to an actual script and location." 3516 }, 3517 { 3518 "name": "paused", 3519 "parameters": [ 3520 { "name": "callFrames", "type": "array", "items": { "$ref": "CallFrame" }, "description": "Call stack the virtual machine stopped on." }, 3521 { "name": "reason", "type": "string", "enum": [ "XHR", "DOM", "EventListener", "exception", "assert", "CSPViolation", "debugCommand", "other" ], "description": "Pause reason." }, 3522 { "name": "data", "type": "object", "optional": true, "description": "Object containing break-specific auxiliary properties." }, 3523 { "name": "hitBreakpoints", "type": "array", "optional": true, "items": { "type": "string" }, "description": "Hit breakpoints IDs", "hidden": true }, 3524 { "name": "asyncStackTrace", "$ref": "StackTrace", "optional": true, "description": "Async stack trace, if any.", "hidden": true } 3525 ], 3526 "description": "Fired when the virtual machine stopped on breakpoint or exception or any other stop criteria." 3527 }, 3528 { 3529 "name": "resumed", 3530 "description": "Fired when the virtual machine resumed execution." 3531 } 3532 ] 3533 }, 3534 { 3535 "domain": "DOMDebugger", 3536 "description": "DOM debugging allows setting breakpoints on particular DOM operations and events. JavaScript execution will stop on these operations as if there was a regular breakpoint set.", 3537 "types": [ 3538 { 3539 "id": "DOMBreakpointType", 3540 "type": "string", 3541 "enum": ["subtree-modified", "attribute-modified", "node-removed"], 3542 "description": "DOM breakpoint type." 3543 } 3544 ], 3545 "commands": [ 3546 { 3547 "name": "setDOMBreakpoint", 3548 "parameters": [ 3549 { "name": "nodeId", "$ref": "DOM.NodeId", "description": "Identifier of the node to set breakpoint on." }, 3550 { "name": "type", "$ref": "DOMBreakpointType", "description": "Type of the operation to stop upon." } 3551 ], 3552 "description": "Sets breakpoint on particular operation with DOM." 3553 }, 3554 { 3555 "name": "removeDOMBreakpoint", 3556 "parameters": [ 3557 { "name": "nodeId", "$ref": "DOM.NodeId", "description": "Identifier of the node to remove breakpoint from." }, 3558 { "name": "type", "$ref": "DOMBreakpointType", "description": "Type of the breakpoint to remove." } 3559 ], 3560 "description": "Removes DOM breakpoint that was set using <code>setDOMBreakpoint</code>." 3561 }, 3562 { 3563 "name": "setEventListenerBreakpoint", 3564 "parameters": [ 3565 { "name": "eventName", "type": "string", "description": "DOM Event name to stop on (any DOM event will do)." }, 3566 { "name": "targetName", "type": "string", "optional": true, "description": "EventTarget interface name to stop on. If equal to <code>\"*\"</code> or not provided, will stop on any EventTarget.", "hidden": true } 3567 ], 3568 "description": "Sets breakpoint on particular DOM event." 3569 }, 3570 { 3571 "name": "removeEventListenerBreakpoint", 3572 "parameters": [ 3573 { "name": "eventName", "type": "string", "description": "Event name." }, 3574 { "name": "targetName", "type": "string", "optional": true, "description": "EventTarget interface name.", "hidden": true } 3575 ], 3576 "description": "Removes breakpoint on particular DOM event." 3577 }, 3578 { 3579 "name": "setInstrumentationBreakpoint", 3580 "parameters": [ 3581 { "name": "eventName", "type": "string", "description": "Instrumentation name to stop on." } 3582 ], 3583 "description": "Sets breakpoint on particular native event.", 3584 "hidden": true 3585 }, 3586 { 3587 "name": "removeInstrumentationBreakpoint", 3588 "parameters": [ 3589 { "name": "eventName", "type": "string", "description": "Instrumentation name to stop on." } 3590 ], 3591 "description": "Removes breakpoint on particular native event.", 3592 "hidden": true 3593 }, 3594 { 3595 "name": "setXHRBreakpoint", 3596 "parameters": [ 3597 { "name": "url", "type": "string", "description": "Resource URL substring. All XHRs having this substring in the URL will get stopped upon." } 3598 ], 3599 "description": "Sets breakpoint on XMLHttpRequest." 3600 }, 3601 { 3602 "name": "removeXHRBreakpoint", 3603 "parameters": [ 3604 { "name": "url", "type": "string", "description": "Resource URL substring." } 3605 ], 3606 "description": "Removes breakpoint from XMLHttpRequest." 3607 } 3608 ] 3609 }, 3610 { 3611 "domain": "Profiler", 3612 "hidden": true, 3613 "types": [ 3614 { 3615 "id": "CPUProfileNode", 3616 "type": "object", 3617 "description": "CPU Profile node. Holds callsite information, execution statistics and child nodes.", 3618 "properties": [ 3619 { "name": "functionName", "type": "string", "description": "Function name." }, 3620 { "name": "scriptId", "$ref": "Debugger.ScriptId", "description": "Script identifier." }, 3621 { "name": "url", "type": "string", "description": "URL." }, 3622 { "name": "lineNumber", "type": "integer", "description": "1-based line number of the function start position." }, 3623 { "name": "columnNumber", "type": "integer", "description": "1-based column number of the function start position." }, 3624 { "name": "hitCount", "type": "integer", "description": "Number of samples where this node was on top of the call stack." }, 3625 { "name": "callUID", "type": "number", "description": "Call UID." }, 3626 { "name": "children", "type": "array", "items": { "$ref": "CPUProfileNode" }, "description": "Child nodes." }, 3627 { "name": "deoptReason", "type": "string", "description": "The reason of being not optimized. The function may be deoptimized or marked as don't optimize."}, 3628 { "name": "id", "type": "integer", "description": "Unique id of the node." } 3629 ] 3630 }, 3631 { 3632 "id": "CPUProfile", 3633 "type": "object", 3634 "description": "Profile.", 3635 "properties": [ 3636 { "name": "head", "$ref": "CPUProfileNode" }, 3637 { "name": "startTime", "type": "number", "description": "Profiling start time in seconds." }, 3638 { "name": "endTime", "type": "number", "description": "Profiling end time in seconds." }, 3639 { "name": "samples", "optional": true, "type": "array", "items": { "type": "integer" }, "description": "Ids of samples top nodes." }, 3640 { "name": "timestamps", "optional": true, "type": "array", "items": { "type": "number" }, "description": "Timestamps of the samples in microseconds." } 3641 ] 3642 } 3643 ], 3644 "commands": [ 3645 { 3646 "name": "enable" 3647 }, 3648 { 3649 "name": "disable" 3650 }, 3651 { 3652 "name": "setSamplingInterval", 3653 "parameters": [ 3654 { "name": "interval", "type": "integer", "description": "New sampling interval in microseconds." } 3655 ], 3656 "description": "Changes CPU profiler sampling interval. Must be called before CPU profiles recording started." 3657 }, 3658 { 3659 "name": "start" 3660 }, 3661 { 3662 "name": "stop", 3663 "returns": [ 3664 { "name": "profile", "$ref": "CPUProfile", "description": "Recorded profile." } 3665 ] 3666 } 3667 ], 3668 "events": [ 3669 { 3670 "name": "consoleProfileStarted", 3671 "parameters": [ 3672 { "name": "id", "type": "string" }, 3673 { "name": "location", "$ref": "Debugger.Location", "description": "Location of console.profile()." }, 3674 { "name": "title", "type": "string", "optional": true, "description": "Profile title passed as argument to console.profile()." } 3675 3676 ], 3677 "description": "Sent when new profile recodring is started using console.profile() call." 3678 }, 3679 { 3680 "name": "consoleProfileFinished", 3681 "parameters": [ 3682 { "name": "id", "type": "string" }, 3683 { "name": "location", "$ref": "Debugger.Location", "description": "Location of console.profileEnd()." }, 3684 { "name": "profile", "$ref": "CPUProfile" }, 3685 { "name": "title", "type": "string", "optional": true, "description": "Profile title passed as argunet to console.profile()." } 3686 ] 3687 } 3688 ] 3689 }, 3690 { 3691 "domain": "HeapProfiler", 3692 "hidden": true, 3693 "types": [ 3694 { 3695 "id": "HeapSnapshotObjectId", 3696 "type": "string", 3697 "description": "Heap snapshot object id." 3698 } 3699 ], 3700 "commands": [ 3701 { 3702 "name": "enable" 3703 }, 3704 { 3705 "name": "disable" 3706 }, 3707 { 3708 "name": "startTrackingHeapObjects", 3709 "parameters": [ 3710 { "name": "trackAllocations", "type": "boolean", "optional": true } 3711 ] 3712 }, 3713 { 3714 "name": "stopTrackingHeapObjects", 3715 "parameters": [ 3716 { "name": "reportProgress", "type": "boolean", "optional": true, "description": "If true 'reportHeapSnapshotProgress' events will be generated while snapshot is being taken when the tracking is stopped." } 3717 ] 3718 3719 }, 3720 { 3721 "name": "takeHeapSnapshot", 3722 "parameters": [ 3723 { "name": "reportProgress", "type": "boolean", "optional": true, "description": "If true 'reportHeapSnapshotProgress' events will be generated while snapshot is being taken." } 3724 ] 3725 }, 3726 { 3727 "name": "collectGarbage" 3728 }, 3729 { 3730 "name": "getObjectByHeapObjectId", 3731 "parameters": [ 3732 { "name": "objectId", "$ref": "HeapSnapshotObjectId" }, 3733 { "name": "objectGroup", "type": "string", "optional": true, "description": "Symbolic group name that can be used to release multiple objects." } 3734 ], 3735 "returns": [ 3736 { "name": "result", "$ref": "Runtime.RemoteObject", "description": "Evaluation result." } 3737 ] 3738 }, 3739 { 3740 "name": "getHeapObjectId", 3741 "parameters": [ 3742 { "name": "objectId", "$ref": "Runtime.RemoteObjectId", "description": "Identifier of the object to get heap object id for." } 3743 ], 3744 "returns": [ 3745 { "name": "heapSnapshotObjectId", "$ref": "HeapSnapshotObjectId", "description": "Id of the heap snapshot object corresponding to the passed remote object id." } 3746 ] 3747 } 3748 ], 3749 "events": [ 3750 { 3751 "name": "addHeapSnapshotChunk", 3752 "parameters": [ 3753 { "name": "chunk", "type": "string" } 3754 ] 3755 }, 3756 { 3757 "name": "resetProfiles" 3758 }, 3759 { 3760 "name": "reportHeapSnapshotProgress", 3761 "parameters": [ 3762 { "name": "done", "type": "integer" }, 3763 { "name": "total", "type": "integer" }, 3764 { "name": "finished", "type": "boolean", "optional": true } 3765 ] 3766 }, 3767 { 3768 "name": "lastSeenObjectId", 3769 "description": "If heap objects tracking has been started then backend regulary sends a current value for last seen object id and corresponding timestamp. If the were changes in the heap since last event then one or more heapStatsUpdate events will be sent before a new lastSeenObjectId event.", 3770 "parameters": [ 3771 { "name": "lastSeenObjectId", "type": "integer" }, 3772 { "name": "timestamp", "type": "number" } 3773 ] 3774 }, 3775 { 3776 "name": "heapStatsUpdate", 3777 "description": "If heap objects tracking has been started then backend may send update for one or more fragments", 3778 "parameters": [ 3779 { "name": "statsUpdate", "type": "array", "items": { "type": "integer" }, "description": "An array of triplets. Each triplet describes a fragment. The first integer is the fragment index, the second integer is a total count of objects for the fragment, the third integer is a total size of the objects for the fragment."} 3780 ] 3781 } 3782 ] 3783 }, 3784 { 3785 "domain": "Worker", 3786 "hidden": true, 3787 "types": [], 3788 "commands": [ 3789 { 3790 "name": "enable" 3791 }, 3792 { 3793 "name": "disable" 3794 }, 3795 { 3796 "name": "sendMessageToWorker", 3797 "parameters": [ 3798 { "name": "workerId", "type": "integer" }, 3799 { "name": "message", "type": "object" } 3800 ] 3801 }, 3802 { 3803 "name": "canInspectWorkers", 3804 "description": "Tells whether browser supports workers inspection.", 3805 "returns": [ 3806 { "name": "result", "type": "boolean", "description": "True if browser has workers support." } 3807 ] 3808 }, 3809 { 3810 "name": "connectToWorker", 3811 "parameters": [ 3812 { "name": "workerId", "type": "integer" } 3813 ] 3814 }, 3815 { 3816 "name": "disconnectFromWorker", 3817 "parameters": [ 3818 { "name": "workerId", "type": "integer" } 3819 ], 3820 "handlers": ["browser", "renderer"] 3821 }, 3822 { 3823 "name": "setAutoconnectToWorkers", 3824 "parameters": [ 3825 { "name": "value", "type": "boolean" } 3826 ] 3827 } 3828 ], 3829 "events": [ 3830 { 3831 "name": "workerCreated", 3832 "parameters": [ 3833 { "name": "workerId", "type": "integer" }, 3834 { "name": "url", "type": "string" }, 3835 { "name": "inspectorConnected", "type": "boolean" } 3836 ] 3837 }, 3838 { 3839 "name": "workerTerminated", 3840 "parameters": [ 3841 { "name": "workerId", "type": "integer" } 3842 ] 3843 }, 3844 { 3845 "name": "dispatchMessageFromWorker", 3846 "parameters": [ 3847 { "name": "workerId", "type": "integer" }, 3848 { "name": "message", "type": "object" } 3849 ] 3850 }, 3851 { 3852 "name": "disconnectedFromWorker", 3853 "handlers": ["browser"] 3854 } 3855 ] 3856 }, 3857 { 3858 "domain": "Canvas", 3859 "hidden": true, 3860 "types": [ 3861 { 3862 "id": "ResourceId", 3863 "type": "string", 3864 "description": "Unique resource identifier." 3865 }, 3866 { 3867 "id": "ResourceStateDescriptor", 3868 "type": "object", 3869 "description": "Resource state descriptor.", 3870 "properties": [ 3871 { "name": "name", "type": "string", "description": "State name." }, 3872 { "name": "enumValueForName", "type": "string", "optional": true, "description": "String representation of the enum value, if <code>name</code> stands for an enum." }, 3873 { "name": "value", "$ref": "CallArgument", "optional": true, "description": "The value associated with the particular state." }, 3874 { "name": "values", "type": "array", "items": { "$ref": "ResourceStateDescriptor" }, "optional": true, "description": "Array of values associated with the particular state. Either <code>value</code> or <code>values</code> will be specified." }, 3875 { "name": "isArray", "type": "boolean", "optional": true, "description": "True iff the given <code>values</code> items stand for an array rather than a list of grouped states." } 3876 ] 3877 }, 3878 { 3879 "id": "ResourceState", 3880 "type": "object", 3881 "description": "Resource state.", 3882 "properties": [ 3883 { "name": "id", "$ref": "ResourceId" }, 3884 { "name": "traceLogId", "$ref": "TraceLogId" }, 3885 { "name": "descriptors", "type": "array", "items": { "$ref": "ResourceStateDescriptor" }, "optional": true, "description": "Describes current <code>Resource</code> state." }, 3886 { "name": "imageURL", "type": "string", "optional": true, "description": "Screenshot image data URL." } 3887 ] 3888 }, 3889 { 3890 "id": "CallArgument", 3891 "type": "object", 3892 "properties": [ 3893 { "name": "description", "type": "string", "description": "String representation of the object." }, 3894 { "name": "enumName", "type": "string", "optional": true, "description": "Enum name, if any, that stands for the value (for example, a WebGL enum name)." }, 3895 { "name": "resourceId", "$ref": "ResourceId", "optional": true, "description": "Resource identifier. Specified for <code>Resource</code> objects only." }, 3896 { "name": "type", "type": "string", "optional": true, "enum": ["object", "function", "undefined", "string", "number", "boolean"], "description": "Object type. Specified for non <code>Resource</code> objects only." }, 3897 { "name": "subtype", "type": "string", "optional": true, "enum": ["array", "null", "node", "regexp", "date", "map", "set"], "description": "Object subtype hint. Specified for <code>object</code> type values only." }, 3898 { "name": "remoteObject", "$ref": "Runtime.RemoteObject", "optional": true, "description": "The <code>RemoteObject</code>, if requested." } 3899 ] 3900 }, 3901 { 3902 "id": "Call", 3903 "type": "object", 3904 "properties": [ 3905 { "name": "contextId", "$ref": "ResourceId" }, 3906 { "name": "functionName", "type": "string", "optional": true }, 3907 { "name": "arguments", "type": "array", "items": { "$ref": "CallArgument" }, "optional": true }, 3908 { "name": "result", "$ref": "CallArgument", "optional": true }, 3909 { "name": "isDrawingCall", "type": "boolean", "optional": true }, 3910 { "name": "isFrameEndCall", "type": "boolean", "optional": true }, 3911 { "name": "property", "type": "string", "optional": true }, 3912 { "name": "value", "$ref": "CallArgument", "optional": true }, 3913 { "name": "sourceURL", "type": "string", "optional": true }, 3914 { "name": "lineNumber", "type": "integer", "optional": true }, 3915 { "name": "columnNumber", "type": "integer", "optional": true } 3916 ] 3917 }, 3918 { 3919 "id": "TraceLogId", 3920 "type": "string", 3921 "description": "Unique trace log identifier." 3922 }, 3923 { 3924 "id": "TraceLog", 3925 "type": "object", 3926 "properties": [ 3927 { "name": "id", "$ref": "TraceLogId" }, 3928 { "name": "calls", "type": "array", "items": { "$ref": "Call" } }, 3929 { "name": "contexts", "type": "array", "items": { "$ref": "CallArgument" } }, 3930 { "name": "startOffset", "type": "integer" }, 3931 { "name": "alive", "type": "boolean" }, 3932 { "name": "totalAvailableCalls", "type": "number" } 3933 ] 3934 } 3935 ], 3936 "commands": [ 3937 { 3938 "name": "enable", 3939 "description": "Enables Canvas inspection." 3940 }, 3941 { 3942 "name": "disable", 3943 "description": "Disables Canvas inspection." 3944 }, 3945 { 3946 "name": "dropTraceLog", 3947 "parameters": [ 3948 { "name": "traceLogId", "$ref": "TraceLogId" } 3949 ] 3950 }, 3951 { 3952 "name": "hasUninstrumentedCanvases", 3953 "returns": [ 3954 { "name": "result", "type": "boolean" } 3955 ], 3956 "description": "Checks if there is any uninstrumented canvas in the inspected page." 3957 }, 3958 { 3959 "name": "captureFrame", 3960 "parameters": [ 3961 { "name": "frameId", "$ref": "Page.FrameId", "optional": true, "description": "Identifier of the frame containing document whose canvases are to be captured. If omitted, main frame is assumed." } 3962 ], 3963 "returns": [ 3964 { "name": "traceLogId", "$ref": "TraceLogId", "description": "Identifier of the trace log containing captured canvas calls." } 3965 ], 3966 "description": "Starts (or continues) a canvas frame capturing which will be stopped automatically after the next frame is prepared." 3967 }, 3968 { 3969 "name": "startCapturing", 3970 "parameters": [ 3971 { "name": "frameId", "$ref": "Page.FrameId", "optional": true, "description": "Identifier of the frame containing document whose canvases are to be captured. If omitted, main frame is assumed." } 3972 ], 3973 "returns": [ 3974 { "name": "traceLogId", "$ref": "TraceLogId", "description": "Identifier of the trace log containing captured canvas calls." } 3975 ], 3976 "description": "Starts (or continues) consecutive canvas frames capturing. The capturing is stopped by the corresponding stopCapturing command." 3977 }, 3978 { 3979 "name": "stopCapturing", 3980 "parameters": [ 3981 { "name": "traceLogId", "$ref": "TraceLogId" } 3982 ] 3983 }, 3984 { 3985 "name": "getTraceLog", 3986 "parameters": [ 3987 { "name": "traceLogId", "$ref": "TraceLogId" }, 3988 { "name": "startOffset", "type": "integer", "optional": true }, 3989 { "name": "maxLength", "type": "integer", "optional": true } 3990 ], 3991 "returns": [ 3992 { "name": "traceLog", "$ref": "TraceLog" } 3993 ] 3994 }, 3995 { 3996 "name": "replayTraceLog", 3997 "parameters": [ 3998 { "name": "traceLogId", "$ref": "TraceLogId" }, 3999 { "name": "stepNo", "type": "integer", "description": "Last call index in the trace log to replay (zero based)." } 4000 ], 4001 "returns": [ 4002 { "name": "resourceState", "$ref": "ResourceState" }, 4003 { "name": "replayTime", "type": "number", "description": "Replay time (in milliseconds)." } 4004 ] 4005 }, 4006 { 4007 "name": "getResourceState", 4008 "parameters": [ 4009 { "name": "traceLogId", "$ref": "TraceLogId" }, 4010 { "name": "resourceId", "$ref": "ResourceId" } 4011 ], 4012 "returns": [ 4013 { "name": "resourceState", "$ref": "ResourceState" } 4014 ] 4015 }, 4016 { 4017 "name": "evaluateTraceLogCallArgument", 4018 "parameters": [ 4019 { "name": "traceLogId", "$ref": "TraceLogId" }, 4020 { "name": "callIndex", "type": "integer", "description": "Index of the call to evaluate on (zero based)." }, 4021 { "name": "argumentIndex", "type": "integer", "description": "Index of the argument to evaluate (zero based). Provide <code>-1</code> to evaluate call result." }, 4022 { "name": "objectGroup", "type": "string", "optional": true, "description": "String object group name to put result into (allows rapid releasing resulting object handles using <code>Runtime.releaseObjectGroup</code>)." } 4023 ], 4024 "returns": [ 4025 { "name": "result", "$ref": "Runtime.RemoteObject", "optional": true, "description": "Object wrapper for the evaluation result." }, 4026 { "name": "resourceState", "$ref": "ResourceState", "optional": true, "description": "State of the <code>Resource</code> object." } 4027 ], 4028 "description": "Evaluates a given trace call argument or its result." 4029 } 4030 ], 4031 "events": [ 4032 { 4033 "name": "contextCreated", 4034 "parameters": [ 4035 { "name": "frameId", "$ref": "Page.FrameId", "description": "Identifier of the frame containing a canvas with a context." } 4036 ], 4037 "description": "Fired when a canvas context has been created in the given frame. The context may not be instrumented (see hasUninstrumentedCanvases command)." 4038 }, 4039 { 4040 "name": "traceLogsRemoved", 4041 "parameters": [ 4042 { "name": "frameId", "$ref": "Page.FrameId", "optional": true, "description": "If given, trace logs from the given frame were removed." }, 4043 { "name": "traceLogId", "$ref": "TraceLogId", "optional": true, "description": "If given, trace log with the given ID was removed." } 4044 ], 4045 "description": "Fired when a set of trace logs were removed from the backend. If no parameters are given, all trace logs were removed." 4046 } 4047 ] 4048 }, 4049 { 4050 "domain": "Input", 4051 "types": [ 4052 { 4053 "id": "TouchPoint", 4054 "type": "object", 4055 "hidden": true, 4056 "properties": [ 4057 { "name": "state", "type": "string", "enum": ["touchPressed", "touchReleased", "touchMoved", "touchStationary", "touchCancelled"], "description": "State of the touch point." }, 4058 { "name": "x", "type": "integer", "description": "X coordinate of the event relative to the main frame's viewport."}, 4059 { "name": "y", "type": "integer", "description": "Y coordinate of the event relative to the main frame's viewport. 0 refers to the top of the viewport and Y increases as it proceeds towards the bottom of the viewport."}, 4060 { "name": "radiusX", "type": "integer", "optional": true, "description": "X radius of the touch area (default: 1)."}, 4061 { "name": "radiusY", "type": "integer", "optional": true, "description": "Y radius of the touch area (default: 1)."}, 4062 { "name": "rotationAngle", "type": "number", "optional": true, "description": "Rotation angle (default: 0.0)."}, 4063 { "name": "force", "type": "number", "optional": true, "description": "Force (default: 1.0)."}, 4064 { "name": "id", "type": "number", "optional": true, "description": "Identifier used to track touch sources between events, must be unique within an event."} 4065 ] 4066 } 4067 ], 4068 "commands": [ 4069 { 4070 "name": "dispatchKeyEvent", 4071 "parameters": [ 4072 { "name": "type", "type": "string", "enum": ["keyDown", "keyUp", "rawKeyDown", "char"], "description": "Type of the key event." }, 4073 { "name": "modifiers", "type": "integer", "optional": true, "description": "Bit field representing pressed modifier keys. Alt=1, Ctrl=2, Meta/Command=4, Shift=8 (default: 0)." }, 4074 { "name": "timestamp", "type": "number", "optional": true, "description": "Time at which the event occurred. Measured in UTC time in seconds since January 1, 1970 (default: current time)." }, 4075 { "name": "text", "type": "string", "optional": true, "description": "Text as generated by processing a virtual key code with a keyboard layout. Not needed for for <code>keyUp</code> and <code>rawKeyDown</code> events (default: \"\")" }, 4076 { "name": "unmodifiedText", "type": "string", "optional": true, "description": "Text that would have been generated by the keyboard if no modifiers were pressed (except for shift). Useful for shortcut (accelerator) key handling (default: \"\")." }, 4077 { "name": "keyIdentifier", "type": "string", "optional": true, "description": "Unique key identifier (e.g., 'U+0041') (default: \"\")." }, 4078 { "name": "windowsVirtualKeyCode", "type": "integer", "optional": true, "description": "Windows virtual key code (default: 0)." }, 4079 { "name": "nativeVirtualKeyCode", "type": "integer", "optional": true, "description": "Native virtual key code (default: 0)." }, 4080 { "name": "autoRepeat", "type": "boolean", "optional": true, "description": "Whether the event was generated from auto repeat (default: false)." }, 4081 { "name": "isKeypad", "type": "boolean", "optional": true, "description": "Whether the event was generated from the keypad (default: false)." }, 4082 { "name": "isSystemKey", "type": "boolean", "optional": true, "description": "Whether the event was a system key event (default: false)." } 4083 ], 4084 "description": "Dispatches a key event to the page." 4085 }, 4086 { 4087 "name": "dispatchMouseEvent", 4088 "parameters": [ 4089 { "name": "type", "type": "string", "enum": ["mousePressed", "mouseReleased", "mouseMoved"], "description": "Type of the mouse event." }, 4090 { "name": "x", "type": "integer", "description": "X coordinate of the event relative to the main frame's viewport."}, 4091 { "name": "y", "type": "integer", "description": "Y coordinate of the event relative to the main frame's viewport. 0 refers to the top of the viewport and Y increases as it proceeds towards the bottom of the viewport."}, 4092 { "name": "modifiers", "type": "integer", "optional": true, "description": "Bit field representing pressed modifier keys. Alt=1, Ctrl=2, Meta/Command=4, Shift=8 (default: 0)." }, 4093 { "name": "timestamp", "type": "number", "optional": true, "description": "Time at which the event occurred. Measured in UTC time in seconds since January 1, 1970 (default: current time)." }, 4094 { "name": "button", "type": "string", "enum": ["none", "left", "middle", "right"], "optional": true, "description": "Mouse button (default: \"none\")." }, 4095 { "name": "clickCount", "type": "integer", "optional": true, "description": "Number of times the mouse button was clicked (default: 0)." } 4096 ], 4097 "description": "Dispatches a mouse event to the page.", 4098 "handlers": ["renderer"] 4099 }, 4100 { 4101 "name": "dispatchTouchEvent", 4102 "hidden": true, 4103 "parameters": [ 4104 { "name": "type", "type": "string", "enum": ["touchStart", "touchEnd", "touchMove"], "description": "Type of the touch event." }, 4105 { "name": "touchPoints", "type": "array", "items": { "$ref": "TouchPoint" }, "description": "Touch points." }, 4106 { "name": "modifiers", "type": "integer", "optional": true, "description": "Bit field representing pressed modifier keys. Alt=1, Ctrl=2, Meta/Command=4, Shift=8 (default: 0)." }, 4107 { "name": "timestamp", "type": "number", "optional": true, "description": "Time at which the event occurred. Measured in UTC time in seconds since January 1, 1970 (default: current time)." } 4108 ], 4109 "description": "Dispatches a touch event to the page." 4110 }, 4111 { 4112 "name": "emulateTouchFromMouseEvent", 4113 "hidden": true, 4114 "parameters": [ 4115 { "name": "type", "type": "string", "enum": ["mousePressed", "mouseReleased", "mouseMoved", "mouseWheel"], "description": "Type of the mouse event." }, 4116 { "name": "x", "type": "integer", "description": "X coordinate of the mouse pointer in DIP."}, 4117 { "name": "y", "type": "integer", "description": "Y coordinate of the mouse pointer in DIP."}, 4118 { "name": "timestamp", "type": "number", "description": "Time at which the event occurred. Measured in UTC time in seconds since January 1, 1970." }, 4119 { "name": "button", "type": "string", "enum": ["none", "left", "middle", "right"], "description": "Mouse button." }, 4120 { "name": "deltaX", "type": "number", "optional": true, "description": "X delta in DIP for mouse wheel event (default: 0)."}, 4121 { "name": "deltaY", "type": "number", "optional": true, "description": "Y delta in DIP for mouse wheel event (default: 0)."}, 4122 { "name": "modifiers", "type": "integer", "optional": true, "description": "Bit field representing pressed modifier keys. Alt=1, Ctrl=2, Meta/Command=4, Shift=8 (default: 0)." }, 4123 { "name": "clickCount", "type": "integer", "optional": true, "description": "Number of times the mouse button was clicked (default: 0)." } 4124 ], 4125 "description": "Emulates touch event from the mouse event parameters.", 4126 "handlers": ["browser"] 4127 } 4128 ], 4129 "events": [] 4130 }, 4131 { 4132 "domain": "LayerTree", 4133 "hidden": true, 4134 "types": [ 4135 { 4136 "id": "LayerId", 4137 "type": "string", 4138 "description": "Unique RenderLayer identifier." 4139 }, 4140 { 4141 "id": "SnapshotId", 4142 "type": "string", 4143 "description": "Unique snapshot identifier." 4144 }, 4145 { 4146 "id": "ScrollRect", 4147 "type": "object", 4148 "description": "Rectangle where scrolling happens on the main thread.", 4149 "properties": [ 4150 { "name": "rect", "$ref": "DOM.Rect", "description": "Rectangle itself." }, 4151 { "name": "type", "type": "string", "enum": ["RepaintsOnScroll", "TouchEventHandler", "WheelEventHandler"], "description": "Reason for rectangle to force scrolling on the main thread" } 4152 ] 4153 }, 4154 { 4155 "id": "Layer", 4156 "type": "object", 4157 "description": "Information about a compositing layer.", 4158 "properties": [ 4159 { "name": "layerId", "$ref": "LayerId", "description": "The unique id for this layer." }, 4160 { "name": "parentLayerId", "$ref": "LayerId", "optional": true, "description": "The id of parent (not present for root)." }, 4161 { "name": "backendNodeId", "$ref": "DOM.BackendNodeId", "optional": true, "description": "The backend id for the node associated with this layer." }, 4162 { "name": "offsetX", "type": "number", "description": "Offset from parent layer, X coordinate." }, 4163 { "name": "offsetY", "type": "number", "description": "Offset from parent layer, Y coordinate." }, 4164 { "name": "width", "type": "number", "description": "Layer width." }, 4165 { "name": "height", "type": "number", "description": "Layer height." }, 4166 { "name": "transform", "type": "array", "items": { "type": "number" }, "minItems": 16, "maxItems": 16, "optional": true, "description": "Transformation matrix for layer, default is identity matrix" }, 4167 { "name": "anchorX", "type": "number", "optional": true, "description": "Transform anchor point X, absent if no transform specified" }, 4168 { "name": "anchorY", "type": "number", "optional": true, "description": "Transform anchor point Y, absent if no transform specified" }, 4169 { "name": "anchorZ", "type": "number", "optional": true, "description": "Transform anchor point Z, absent if no transform specified" }, 4170 { "name": "paintCount", "type": "integer", "description": "Indicates how many time this layer has painted." }, 4171 { "name": "invisible", "type": "boolean", "optional": true, "description": "Set if layer is not visible." }, 4172 { "name": "scrollRects", "type": "array", "items": { "$ref": "ScrollRect"}, "optional": true, "description": "Rectangles scrolling on main thread only."} 4173 ] 4174 }, 4175 { 4176 "id": "PaintProfile", 4177 "type": "array", 4178 "description": "Array of timings, one per paint step.", 4179 "items": { 4180 "type": "number", 4181 "description": "A time in seconds since the end of previous step (for the first step, time since painting started)" 4182 } 4183 } 4184 ], 4185 "commands": [ 4186 { 4187 "name": "enable", 4188 "description": "Enables compositing tree inspection." 4189 }, 4190 { 4191 "name": "disable", 4192 "description": "Disables compositing tree inspection." 4193 }, 4194 { 4195 "name": "compositingReasons", 4196 "parameters": [ 4197 { "name": "layerId", "$ref": "LayerId", "description": "The id of the layer for which we want to get the reasons it was composited." } 4198 ], 4199 "description": "Provides the reasons why the given layer was composited.", 4200 "returns": [ 4201 { "name": "compositingReasons", "type": "array", "items": { "type": "string" }, "description": "A list of strings specifying reasons for the given layer to become composited." } 4202 ] 4203 }, 4204 { 4205 "name": "makeSnapshot", 4206 "parameters": [ 4207 { "name": "layerId", "$ref": "LayerId", "description": "The id of the layer." } 4208 ], 4209 "description": "Returns the layer snapshot identifier.", 4210 "returns": [ 4211 { "name": "snapshotId", "$ref": "SnapshotId", "description": "The id of the layer snapshot." } 4212 ] 4213 }, 4214 { 4215 "name": "loadSnapshot", 4216 "parameters": [ 4217 { "name": "data", "type": "string", "description": "Base64-encoded snapshot data." } 4218 ], 4219 "description": "Returns the snapshot identifier.", 4220 "returns": [ 4221 { "name": "snapshotId", "$ref": "SnapshotId", "description": "The id of the snapshot." } 4222 ] 4223 }, 4224 { 4225 "name": "releaseSnapshot", 4226 "parameters": [ 4227 { "name": "snapshotId", "$ref": "SnapshotId", "description": "The id of the layer snapshot." } 4228 ], 4229 "description": "Releases layer snapshot captured by the back-end." 4230 }, 4231 { 4232 "name": "profileSnapshot", 4233 "parameters": [ 4234 { "name": "snapshotId", "$ref": "SnapshotId", "description": "The id of the layer snapshot." }, 4235 { "name": "minRepeatCount", "type": "integer", "optional": true, "description": "The maximum number of times to replay the snapshot (1, if not specified)." }, 4236 { "name": "minDuration", "type": "number", "optional": true, "description": "The minimum duration (in seconds) to replay the snapshot." } 4237 ], 4238 "returns": [ 4239 { "name": "timings", "type": "array", "items": { "$ref": "PaintProfile" }, "description": "The array of paint profiles, one per run." } 4240 ] 4241 }, 4242 { 4243 "name": "replaySnapshot", 4244 "parameters": [ 4245 { "name": "snapshotId", "$ref": "SnapshotId", "description": "The id of the layer snapshot." }, 4246 { "name": "fromStep", "type": "integer", "optional": true, "description": "The first step to replay from (replay from the very start if not specified)." }, 4247 { "name": "toStep", "type": "integer", "optional": true, "description": "The last step to replay to (replay till the end if not specified)." }, 4248 { "name": "scale", "type": "number", "optional": true, "description": "The scale to apply while replaying (defaults to 1)." } 4249 ], 4250 "description": "Replays the layer snapshot and returns the resulting bitmap.", 4251 "returns": [ 4252 { "name": "dataURL", "type": "string", "description": "A data: URL for resulting image." } 4253 ] 4254 }, 4255 { 4256 "name": "snapshotCommandLog", 4257 "parameters": [ 4258 { "name": "snapshotId", "$ref": "SnapshotId", "description": "The id of the layer snapshot." } 4259 ], 4260 "description": "Replays the layer snapshot and returns canvas log.", 4261 "returns": [ 4262 { "name": "commandLog", "type": "array", "items": { "type": "object" }, "description": "The array of canvas function calls." } 4263 ] 4264 } 4265 ], 4266 "events": [ 4267 { 4268 "name": "layerTreeDidChange", 4269 "parameters": [ 4270 { "name": "layers", "type": "array", "items": { "$ref": "Layer" }, "optional": true, "description": "Layer tree, absent if not in the comspositing mode." } 4271 ] 4272 }, 4273 { 4274 "name": "layerPainted", 4275 "parameters": [ 4276 { "name": "layerId", "$ref": "LayerId", "description": "The id of the painted layer." }, 4277 { "name": "clip", "$ref": "DOM.Rect", "description": "Clip rectangle." } 4278 ] 4279 } 4280 ] 4281 }, 4282 { 4283 "domain": "Geolocation", 4284 "hidden": true, 4285 "commands": [ 4286 { 4287 "name": "setGeolocationOverride", 4288 "description": "Overrides the Geolocation Position or Error.", 4289 "parameters": [ 4290 { "name": "latitude", "type": "number", "optional": true, "description": "Mock latitude"}, 4291 { "name": "longitude", "type": "number", "optional": true, "description": "Mock longitude"}, 4292 { "name": "accuracy", "type": "number", "optional": true, "description": "Mock accuracy"} 4293 ] 4294 }, 4295 { 4296 "name": "clearGeolocationOverride", 4297 "description": "Clears the overriden Geolocation Position and Error." 4298 } 4299 ] 4300 }, 4301 { 4302 "domain": "DeviceOrientation", 4303 "hidden": true, 4304 "commands": [ 4305 { 4306 "name": "setDeviceOrientationOverride", 4307 "description": "Overrides the Device Orientation.", 4308 "parameters": [ 4309 { "name": "alpha", "type": "number", "description": "Mock alpha"}, 4310 { "name": "beta", "type": "number", "description": "Mock beta"}, 4311 { "name": "gamma", "type": "number", "description": "Mock gamma"} 4312 ] 4313 }, 4314 { 4315 "name": "clearDeviceOrientationOverride", 4316 "description": "Clears the overridden Device Orientation." 4317 } 4318 ] 4319 }, 4320 { 4321 "domain": "Tracing", 4322 "hidden": true, 4323 "commands": [ 4324 { 4325 "name": "start", 4326 "description": "Start trace events collection.", 4327 "parameters": [ 4328 { "name": "categories", "type": "string", "description": "Category/tag filter" }, 4329 { "name": "options", "type": "string", "description": "Tracing options" }, 4330 { "name": "bufferUsageReportingInterval", "type": "number", "optional": true, "description": "If set, the agent will issue bufferUsage events at this interval, specified in milliseconds" } 4331 ], 4332 "handlers": ["browser", "renderer", "frontend"] 4333 }, 4334 { 4335 "name": "end", 4336 "description": "Stop trace events collection.", 4337 "handlers": ["browser", "renderer", "frontend"] 4338 }, 4339 { 4340 "name": "getCategories", 4341 "async": true, 4342 "description": "Gets supported tracing categories.", 4343 "returns": [ 4344 { "name": "categories", "type": "array", "items": { "type": "string" }, "description": "A list of supported tracing categories." } 4345 ], 4346 "handlers": ["browser", "frontend"] 4347 } 4348 ], 4349 "events": [ 4350 { 4351 "name": "started", 4352 "description": "Fired when tracing is started.", 4353 "handlers": ["browser", "frontend"], 4354 "hidden": true 4355 }, 4356 { 4357 "name": "dataCollected", 4358 "parameters": [ 4359 { "name": "value", "type": "array", "items": { "type": "object" } } 4360 ], 4361 "description": "Contains an bucket of collected trace events. When tracing is stopped collected events will be send as a sequence of dataCollected events followed by tracingComplete event.", 4362 "handlers": ["browser", "frontend"] 4363 }, 4364 { 4365 "name": "tracingComplete", 4366 "description": "Signals that tracing is stopped and there is no trace buffers pending flush, all data were delivered via dataCollected events.", 4367 "handlers": ["browser", "frontend"] 4368 }, 4369 { 4370 "name": "bufferUsage", 4371 "parameters": [ 4372 { "name": "value", "type": "number", "description": "A number in range [0..1] that indicates the used size of event buffer as a fraction of its total size." } 4373 ], 4374 "handlers": ["browser", "frontend"] 4375 } 4376 ] 4377 }, 4378 { 4379 "domain": "Power", 4380 "hidden": true, 4381 "types": [ 4382 { 4383 "id": "PowerEvent", 4384 "type": "object", 4385 "properties": [ 4386 { "name": "type", "type": "string", "description": "Power Event Type." }, 4387 { "name": "timestamp", "type": "number", "description": "Power Event Time, in milliseconds." }, 4388 { "name": "value", "type": "number", "description": "Power Event Value." } 4389 ], 4390 "description": "PowerEvent item" 4391 } 4392 ], 4393 "commands": [ 4394 { 4395 "name": "start", 4396 "description": "Start power events collection.", 4397 "parameters": [], 4398 "handlers": ["browser", "frontend"] 4399 }, 4400 { 4401 "name": "end", 4402 "description": "Stop power events collection.", 4403 "parameters": [], 4404 "handlers": ["browser", "frontend"] 4405 }, 4406 { 4407 "name": "canProfilePower", 4408 "description": "Tells whether power profiling is supported.", 4409 "returns": [ 4410 { "name": "result", "type": "boolean", "description": "True if power profiling is supported." } 4411 ], 4412 "hidden": true, 4413 "handlers": ["browser", "frontend"] 4414 }, 4415 { 4416 "name": "getAccuracyLevel", 4417 "description": "Describes the accuracy level of the data provider.", 4418 "returns": [ 4419 { "name": "result", "type": "string", "enum": ["high", "moderate", "low"] } 4420 ], 4421 "handlers": ["browser", "frontend"] 4422 } 4423 ], 4424 "events": [ 4425 { 4426 "name": "dataAvailable", 4427 "parameters": [ 4428 {"name": "value", "type": "array", "items": { "$ref": "PowerEvent" }, "description": "List of power events." } 4429 ], 4430 "handlers": ["browser", "frontend"] 4431 } 4432 ] 4433 }] 4434} 4435