Skip to content

Use devtools against a webpage; a CDP agent implemeted in client-side JS

License

Notifications You must be signed in to change notification settings

Nice-PLQ/devtools-remote-debugger

Repository files navigation

Devtools Remote Debugger

中文文档

Based on Google's open-source devtools-frontend, you can use JavaScript to implement the Chrome DevTools Protocol . By simply loading a piece of JavaScript code on a web page, you can use the familiar Chrome DevTools to remotely debug the page.

The web page being debugged connects to an intermediate Node layer via WebSocket, and DevTools also connects to the Node layer via WebSocket. The primary role of the Node intermediate layer is to forward socket protocols between the web page and DevTools, enabling full-duplex communication between them.

Additionally, this project has been included in the awesome-chrome-devtools collection.

🎬 Debug DEMO

demo.mp4

🎉 Features:

Elements

  • Display Html Tags
  • Edit Html Attributes
  • Display Style Rules
  • Highlight Node
Preivew

Console

  • Execute JavaScript Code
  • Show Error Stack
Preivew

Sources

  • Show Source Code
Preivew

Network

  • Show XHR/Fetch Request
  • Show JavaScript/CSS/HTML Request
  • Show Image Request
Preivew

Application

  • Local Storage
  • Session Storage
  • Cookies
Preivew

ScreenPreview

  • Live Preview
Preivew

How to start?

Open the command terminal and start the following two commands

1. Start Serve

#1. Start the node service
npm run serve

# 2. Start a new terminal
npm run client

2. Open the debug page

Open two pages in the browser

How to use?

1、Modify the variables of the .env file

# The port number to start the Node, such as: port 80
DEBUG_PORT=8080
# Debug the domain name after the deployment of the backend, such as: https://www.remote-debug.com/
DEBUG_HOST='http://localhost:8080'
  1. Execute npm run build to build the project code, and the dist directory will be packaged. The structure is as follows:
├── page    # Debug backend
│   ├── index.css
│   ├── index.html
│   ├── index.js
├── sdk.js  # The SDK code for debugging needs to be loaded on the page being debugged. You can deploy it to a CDN.
  1. Start the backend
npm run start
  1. The browser opens the debugging backend http://www.debug.com/remote/debug/index.html, if the debugging target page loads the sdk.js code, then the debugging backend will see the connection record

💡Please note that www.debug.com is just an example, please replace it with your own specific domain.

Additional Information

Due to the restrictions of the same-origin policy, you may need to make the following changes:

  • By default, the browser does not allow JavaScript to read CSSRules from different domains. Therefore, when including external styles via a link, you need to add the attribute crossorigin="anonymous". This issue does not apply to styles within style tags.
  • To capture detailed JavaScript error information, you also need to add crossorigin="anonymous" to the script tags.

Star History

Star History Chart

License

MIT

Copyright (c) Nice-PLQ