Skip to content

[Web Inspector] Add Debugging guide for Inspector frontend development#148

Open
burg wants to merge 1 commit intoWebKit:mainfrom
burg:eng/bburg/wi-debugging-guide
Open

[Web Inspector] Add Debugging guide for Inspector frontend development#148
burg wants to merge 1 commit intoWebKit:mainfrom
burg:eng/bburg/wi-debugging-guide

Conversation

@burg
Copy link
Copy Markdown
Contributor

@burg burg commented Apr 1, 2026

Port and modernize the WebInspectorDebugging wiki page from trac.webkit.org. Organized around common problems developers encounter:

  • Fast JS-only rebuilds (make -C Source/WebInspectorUI/)
  • Protocol message tracing (Debug UI toggle, settings, programmatic flags)
  • Inspecting the Inspector (Inspector^2 via Debug UI or Settings)
  • Debugging failing layout tests (InspectorTest.debug(), forceDebugLogging)
  • Readable stack traces (COMBINE_INSPECTOR_RESOURCES=NO)
  • C++ backend debugging (process identification, logging channels)
  • iOS Simulator debugging
  • Engineering and Debug settings reference
  • Quick reference table

All commands and preference keys verified against current WebKit source.

Port and modernize the WebInspectorDebugging wiki page from trac.webkit.org.
Organized around common problems developers encounter:

- Fast JS-only rebuilds (make -C Source/WebInspectorUI/)
- Protocol message tracing (Debug UI toggle, settings, programmatic flags)
- Inspecting the Inspector (Inspector^2 via Debug UI or Settings)
- Debugging failing layout tests (InspectorTest.debug(), forceDebugLogging)
- Readable stack traces (COMBINE_INSPECTOR_RESOURCES=NO)
- C++ backend debugging (process identification, logging channels)
- iOS Simulator debugging
- Engineering and Debug settings reference
- Quick reference table

All commands and preference keys verified against current WebKit source.
@burg burg force-pushed the eng/bburg/wi-debugging-guide branch from 26a2acd to 61a6a96 Compare April 3, 2026 21:16
@burg
Copy link
Copy Markdown
Contributor Author

burg commented Apr 3, 2026

Incorporated feedback.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants