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.
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.

1 participant