Debug Overlay
Built-in visual debugger. Shadow DOM isolated — zero style leaks, zero framework dependency.
Enable
new IframeShield({ debugger: { enabled: true, position: 'bottom-right', shortcut: 'ctrl+shift+q', }, });
Features
- Quality selector — buttons for High / Medium / Low / Minimal
- Memory bar — green → orange → red based on utilization
- Stats display — current zone, memory usage, active/frozen count
- Keyboard shortcut — toggle overlay visibility
- Auto-mount — attaches to iframe wrapper on
register() - Auto-cleanup — removed on
dispose()
Position Options
| Value | Position |
|---|---|
'bottom-right' | Bottom-right corner (default) |
'bottom-left' | Bottom-left corner |
'top-right' | Top-right corner |
'top-left' | Top-left corner |
Tip: The overlay uses Shadow DOM, so your app's CSS cannot affect it and its CSS cannot leak into your app.