Troubleshooting Guide

Solve common problems and errors encountered during FullPageScreenshot usage

🚨 Common Problem Categories

Installation and Startup Issues

Extension Cannot Be Installed

Symptoms:

  • Chrome Store shows "Extension is invalid"
  • Downloaded files cannot be installed
  • Errors during installation process

Cause Analysis:

  • Corrupted or incomplete files
  • Browser version too old
  • Security software blocking installation

Solutions:

  1. Redownload

    • Clear browser cache and redownload
    • Ensure downloading from official channels
  2. Check Browser Version

    • Chrome 88+
    • Firefox 90+
    • Edge 88+
    • Safari 14+
  3. Temporarily Disable Security Software

    • Antivirus software
    • Firewall
    • Other security extensions

Extension Won't Start

Symptoms:

  • No response when clicking icon
  • Popup shows blank
  • Extension icon is grayed out

Solutions:

  1. Restart Browser

    • Completely close all browser windows
    • Restart browser
  2. Check Extension Permissions

    • Open chrome://extensions/
    • Ensure extension is enabled
    • Check permission settings
  3. Reload Extension

    • Click "Reload" button on extension page
    • Or use shortcut Ctrl+R (Windows) / Cmd+R (Mac)

Screenshot Function Issues

Screenshot Shows Blank

Symptoms:

  • Screenshot result is white or black
  • Content area is empty
  • Only browser interface elements

Cause Analysis:

  • Page uses special security policies
  • Content rendered through Canvas or WebGL
  • Browser security restrictions

Solutions:

  1. Check Page Settings

    • Ensure page allows screenshots
    • Check Content-Security-Policy
    • Temporarily disable ad blockers
  2. Try Different Modes

    • Switch to visible area mode
    • Use element selection mode
    • Try area selection mode
  3. Browser Debugging

    • Open developer tools to check for errors
    • View error information in Console
    • Check Network requests

Full Page Screenshot Failed

Symptoms:

  • Stops during scrolling
  • Screenshot is incomplete
  • Image stitching errors

Solutions:

  1. Adjust Page Settings

    • Reduce page scroll speed
    • Increase scroll wait time
    • Disable page animation effects
  2. Optimize Network Environment

    • Ensure stable network connection
    • Wait for page to fully load
    • Pause auto-playing content
  3. Page Processing

    • Use segmented screenshots for extra-long pages
    • Manually control scroll process
    • Use professional mode

Permission and Security Issues

Permission Denied

Symptoms:

  • "Insufficient permissions" prompt
  • Cannot access specific pages
  • Some features unavailable

Solutions:

  1. Check Extension Permissions

    • Open extension management page
    • Ensure all necessary permissions are enabled
    • Manually adjust permission settings
  2. Website Permission Settings

    • Check website permission settings
    • Ensure website allows extension access
    • Check CORS policies
  3. Enterprise Environment Policies

    • Contact IT administrator
    • Request to add to whitelist
    • Use enterprise version extension

Security Software Blocking

Symptoms:

  • Security software alerts
  • Extension functionality limited
  • Data transfer blocked

Solutions:

  1. Add Trust

    • Add extension to security software whitelist
    • Allow extension network access
    • Enable file access permissions
  2. Adjust Security Level

    • Temporarily lower security level
    • Add domain to trust list
    • Configure firewall rules

🔍 Diagnostic Tools

Built-in Diagnostics

Extension provides built-in diagnostic tools:

  1. Open Diagnostic Page

    • Click extension icon
    • Select "Settings" > "Diagnostics"
    • Run system diagnostics
  2. Diagnostic Items

    • Extension status check
    • Permission verification
    • Network connection test
    • Storage space check
  3. Export Diagnostic Report

    • Generate detailed report file
    • Include system information and error logs
    • Convenient for technical support analysis

Browser Developer Tools

Use browser developer tools to diagnose issues:

  1. Console Panel

    • View error messages
    • Monitor extension messages
    • Check error logs
  2. Network Panel

    • Monitor network requests
    • Check API calls
    • Analyze response times
  3. Application Panel

    • Check storage data
    • View extension configuration
    • Analyze cache usage

Browser Diagnostic Pages

Use browser built-in pages for diagnosis:

  1. Extension Management Page

    • Visit chrome://extensions/
    • View extension status and permissions
    • Check error information
  2. Permission Management Page

    • Visit chrome://extensions/permissions
    • Manage extension permission settings
  3. Error Log Page

    • Visit chrome://extensions/errors
    • View detailed error information

🛠️ Advanced Problem Solving

Memory Leak Issues

Symptoms:

  • Browser becomes slow
  • Memory usage continues to grow
  • Extension response becomes slow

Solutions:

  1. Monitor Memory Usage

    • Use browser task manager to view memory usage
    • Observe memory changes during extension operation
    • Regularly restart browser to release memory
  2. Clear Cache

    • Clear extension cache
    • Restart browser
    • Close unnecessary tabs
  3. Optimize Settings

    • Reduce number of screenshots processed simultaneously
    • Lower screenshot quality settings
    • Enable auto-cleanup feature

Network Connection Issues

Symptoms:

  • Cannot sync to cloud
  • Update failures
  • Online features unavailable

Solutions:

  1. Check Network Connection

    • Use online network test tools to check connection
    • Visit service website to confirm service status
    • Try accessing other websites to verify network
  2. Configure Proxy Settings

    • Check system proxy settings
    • Configure extension proxy settings
    • Test different network environments
  3. Use Offline Mode

    • Enable offline work mode
    • Store screenshots locally
    • Sync after network recovery

Compatibility Issues

Symptoms:

  • Doesn't work on specific websites
  • Conflicts with other extensions
  • Browser version compatibility issues

Solutions:

  1. Website Compatibility

    • Check website's Content-Security-Policy
    • Test different screenshot modes
    • Use compatibility mode
  2. Extension Conflicts

    • Disable other extensions for individual testing
    • Adjust extension loading order
    • Use conflict detection tools
  3. Browser Version

    • Update to latest browser version
    • Use compatibility mode
    • Consider downgrading to stable version

📊 Performance Issues

Slow Screenshot Speed

Symptoms:

  • Long screenshot processing time
  • Excessive wait time
  • High system resource usage

Optimization Solutions:

  1. Lower Quality Settings

    • Use standard quality instead of high quality
    • Choose JPG format instead of PNG
    • Enable compression options
  2. Optimize Hardware Usage

    • Enable hardware acceleration in browser settings
    • Adjust screenshot resolution settings
    • Choose appropriate compression quality
  3. Batch Processing Optimization

    • Reduce concurrent count
    • Increase processing intervals
    • Use queue management

Insufficient Storage Space

Symptoms:

  • Insufficient storage space prompt
  • Cannot save new screenshots
  • Sync failures

Solutions:

  1. Clear Storage Space

    • Delete unnecessary screenshots
    • Clear temporary files
    • Compress existing files
  2. Optimize Storage Strategy

    • Enable auto-cleanup feature
    • Set file save period (e.g., 30 days)
    • Limit maximum storage space
    • Enable file compression options
  3. Use External Storage

    • Configure external storage path
    • Use cloud storage
    • Regularly backup to external devices

🔄 Factory Reset

When encountering unsolvable problems, you can try factory reset:

  1. Backup Important Data

    • Export configuration and settings
    • Backup important screenshots
    • Save account information
  2. Reset Extension

    • Remove extension in extension management page
    • Clear browser-related data
    • Reinstall extension program
  3. Reconfigure

    • Reinstall extension
    • Restore configuration backup
    • Test basic functions

📞 Get Technical Support

If none of the above methods solve the problem, you can seek technical support:

Contact Information

Please provide when submitting issues:

  1. System Information

    • Operating system and version
    • Browser name and version
    • Extension version number
  2. Problem Description

    • Detailed description of the problem
    • Steps to reproduce the problem
    • Expected behavior vs actual behavior
  3. Error Information

    • Complete error messages
    • Console logs
    • Screenshots or screen recordings
  4. Environment Information

    • Network environment
    • Other installed extensions
    • Specific website information

Common Response Times

  • Email Support: Response within 24-48 hours
  • Urgent Issues: Response within 4-8 hours
  • Community Support: Depends on community activity

🎯 Preventive Measures

To avoid problems, it's recommended to take the following preventive measures:

  1. Regular Updates

    • Keep extension and browser up to date
    • Pay attention to official update notes
    • Test new version features
  2. Reasonable Configuration

    • Choose appropriate settings according to needs
    • Avoid excessive resource usage
    • Regularly clear cache
  3. Data Backup

    • Regularly backup important screenshots
    • Export configuration settings
    • Use cloud sync
  4. Monitor Usage

    • Pay attention to extension performance
    • Monitor storage space
    • Pay attention to abnormal behavior

🎉 Summary

Troubleshooting is an important part of using any software tool. Through the methods provided in this guide, you should be able to solve most common problems.

Key Points:

  • Start troubleshooting from simple issues
  • Make good use of built-in diagnostic tools
  • Keep extension and system updated
  • Seek technical support promptly

Remember, most problems have solutions, patience and systematic troubleshooting methods are key.