support

  # WebView Insight - Support & Help

  ## Welcome to WebView Insight Support

  WebView Insight is a professional iOS developer tool for H5/WebView debugging, compatibility testing, and performance monitoring. This page provides

  resources to help you get the most out of the app.

  ---

  ## 📱 Getting Started

  ### System Requirements

  - **iOS Version:** iOS 17.0 or later

  - **Devices:** iPhone, iPad

  - **Permissions:** Camera (for QR code scanning), Photos (for saving screenshots)

  ### Quick Start Guide

  1. **Launch the app** and enter a URL or scan a QR code

  2. **Tap the Debug button** to open the debugging panel

  3. **Explore 8 debugging tabs**: Console, Network, Throttle, Elements, Storage, System, Diagnostics, Performance

  4. **Generate reports** by tapping "Save Report" after testing

  ---

  ## 🔧 Common Issues & Solutions

  ### Camera/QR Scanner Not Working

  **Problem:** Cannot scan QR codes or camera access denied.

  **Solution:**

  1. Go to **Settings > Privacy & Security > Camera**

  2. Find **WebView Insight** and enable camera access

  3. Restart the app and try again

  ### Network Requests Not Captured

  **Problem:** Network requests are not showing in the Network tab.

  **Solution:**

  1. Refresh the page to reload the interceptor script

  2. Check Console tab for any JavaScript errors

  3. Make sure the page has fully loaded before checking

  ### Compatibility Score Shows 100 But Page Has Issues

  **Problem:** Diagnostics shows perfect score but page still has problems.

  **Solution:**

  - The diagnostics system checks for common known issues

  - Some runtime errors require manual testing

  - Check the Console tab for runtime JavaScript errors

  - Test user interactions and edge cases manually

  ### UI Monitor Baseline Snapshot Issues

  **Problem:** Baseline snapshot status is inconsistent across different URLs.

  **Solution:**

  - **Update to v2.1.0 or later** - this issue has been fixed

  - Each URL now maintains its own baseline snapshot independently

  - Delete and re-record baseline snapshots after updating

  ### How to Clear Test Data

  **Solution:**

  1. **Storage Tab:** Clear Cookies, LocalStorage, SessionStorage

  2. **Reports Page:** Delete individual test reports or batch delete

  3. **Home Page:** Clear browsing history

  ---

  ## 📚 Features Overview

  ### Debugging Panel (8 Tabs)

  - **Console:** Real-time log capture, interactive JavaScript execution

  - **Network:** HTTP/HTTPS request interception, cURL export

  - **Throttle:** Network environment simulation (WiFi, 4G, 3G, 2G, offline, etc.)

  - **Elements:** DOM tree structure inspection

  - **Storage:** Cookies, LocalStorage, SessionStorage management

  - **System:** Device and WebKit information

  - **Diagnostics:** Automatic compatibility issue detection (20+ rules)

  - **Performance:** Real-time FPS, memory usage, load time monitoring

  ### UI Regression Testing

  - Record user interaction scenarios

  - **QR code scanning** for quick URL input (v2.1.0+)

  - Lightweight DOM snapshot capture

  - Automatic visual diff comparison

  - **URL isolation** - each URL maintains independent baseline snapshots (v2.1.0+)

  ### Network Throttling

  - 10+ preset network environments

  - Custom bandwidth, latency, and packet loss configuration

  - JavaScript-level interception

  ### Compatibility Diagnostics

  - Automatic detection of iOS-specific compatibility issues

  - 0-100 scoring system

  - Detailed fix suggestions for each issue

  - Special detection for axios ReadableStream issues

  ---

  ## 💡 Best Practices

  ### For Developers

  1. Add `data-testid` attributes to your HTML elements for better UI testing

  2. Use semantic ARIA labels

  3. Avoid pure dynamic hash-based CSS classes

  4. Add unique identifiers to list items

  ### For Testers

  1. Wait for page to fully load before capturing snapshots

  2. Avoid clicking elements during animations

  3. Use "Validate Steps" feature before running UI tests

  4. Enable network throttling to test edge cases

  ---

  ## 🆕 What's New in v2.1.0

  ### QR Code Scanner for URL Input

  - Scan QR codes to quickly input test URLs

  - Available in scenario creation and editing

  - Automatic URL validation

  ### UI Monitor URL Isolation

  - Each URL maintains independent baseline snapshots

  - Fixed cross-URL state contamination issue

  - Support for testing multiple pages simultaneously

  ---

  ## 🐛 Report a Bug

  If you encounter a bug or have a feature request:

  1. **GitHub Issues:** [github.com/your-repo/webview-insight/issues](https://github.com/your-repo/webview-insight/issues)

  2. **Email:** support@webviewinsight.com

  When reporting a bug, please include:

  - iOS version and device model

  - App version

  - Steps to reproduce the issue

  - Screenshots or screen recordings (if applicable)

  - URL being tested (if relevant)

  ---

  ## 💬 Contact & Community

  - **Email:** support@webviewinsight.com

  - **GitHub:** [github.com/your-repo/webview-insight](https://github.com/your-repo/webview-insight)

  - **Documentation:** [docs.webviewinsight.com](https://docs.webviewinsight.com)

  ---

  ## 📖 Documentation & Tutorials

  - [Complete User Guide](https://docs.webviewinsight.com/guide)

  - [API Documentation](https://docs.webviewinsight.com/api)

  - [Video Tutorials](https://youtube.com/webviewinsight)

  - [Blog & Articles](https://blog.webviewinsight.com)

  ---

  ## ❓ Frequently Asked Questions

  **Q: Is WebView Insight free to use?**

  A: Yes, WebView Insight is completely free with no in-app purchases or subscriptions.

  **Q: Does the app collect user data?**

  A: No. All data is stored locally on your device. We do not collect or upload any user data. See our [Privacy Policy](/privacy) for details.

  **Q: Can I test HTTPS websites?**

  A: Yes, all HTTPS sites are fully supported, including those with self-signed certificates (you may need to trust them in Settings).

  **Q: What iOS versions are supported?**

  A: iOS 17.0 or later is required for optimal performance.

  **Q: How do I export test data?**

  A: Generate PDF reports, copy network requests as cURL commands, save screenshots, or copy console logs.

  **Q: Is the app open source?**

  A: Yes! The project is open source under the MIT license. Check our GitHub repository for source code.

  ---

  ## 🔄 Version History

  ### v2.1.0 (Latest)

  - QR code scanner for URL input

  - UI Monitor URL isolation feature

  - Bug fixes and performance improvements

  ### v2.0.0

  - Initial release with 8 debugging tabs

  - UI regression testing engine

  - Compatibility diagnostics system

  - Network throttling simulator

  - Professional PDF report generation

  ---

  ## 📄 Legal

  - [Privacy Policy](/privacy)

  - [Terms of Service](/terms)

  - [Open Source License (MIT)](https://opensource.org/licenses/MIT)