ProxyVerity Proxy Checker Widget — quick, secure proxy testing you can embed

We’ve released a compact, embeddable solution that brings ProxyVerity’s proxy validation features directly into any website — the ProxyVerity Proxy Checker Widget. It requires a single script tag to install, supports both light and dark themes, is fully responsive, and handles large proxy lists via chunked processing. In this article we explain how it works, how to integrate it, and which technical safeguards are in place.

Demo & resources

• Live demo: https://ProxyVerity.github.io/Proxy-Checker-Widget/
• CodePen preview: CodePen demo
• GitHub repo: https://github.com/ProxyVerity/Proxy-Checker-Widget
• Full online tool: ProxyVerity Proxy Checker

Video-demo:

Overview

The ProxyVerity Widget is a lightweight JavaScript embed that injects a sandboxed iframe into your page. That iframe contains a compact PHP/JS-based UI which communicates with ProxyVerity backend services to validate proxy servers. The design goal: zero backend work for the integrator, full control over appearance via attributes (width, height, theme), and robust handling of large inputs.

Key features

• One-line integration — add a single <script> tag to enable the widget.
• Responsive — adapts to container width and device screens.
• Light & dark themes — switch with data-theme.
• Batch & chunked processing — large lists are automatically split to avoid throttling or timeouts.
• Real-time results — connectivity, anonymity, location detection and speed metrics update live.
• Sandboxed iframe — widget runs isolated from the host page for safety.
• Mobile-optimized — touch-friendly controls and streamlined UX.

Quick start

Basic embed (minimal):

<script src="https://panel.proxyverity.com/widget/embed.js"></script>

Recommended configuration:

<script src="https://panel.proxyverity.com/widget/embed.js"
        async
        data-width="100%"
        data-height="520"
        data-theme="light"></script>

Full configuration example (all options):

<script src="https://panel.proxyverity.com/widget/embed.js"
        async
        data-width="100%"
        data-height="520"
        data-theme="light"
        data-threshold="50"
        data-chunk-size="50"
        data-open-results="0"></script>

Configuration options

Attribute	Type	Default	Description
data-width	string	"100%"	Widget width (CSS units or %).
data-height	string	"520"	Height in px (used as initial iframe height; widget auto-resizes).
data-theme	string	"light"	"light" or "dark".
data-threshold	number	50	Max proxies to process immediately — larger lists will be chunked.
data-chunk-size	number	50	Number of proxies per chunk for large lists.
data-open-results	number	1	1 opens results in a new tab, 0 shows them inside the iframe.

Themes: light & dark

The widget ships with two carefully designed themes. The default light theme uses high-contrast, readable components for typical content sites. The dark theme offers comfortable contrast on dark backgrounds, ideal for dashboards and developer tools. Switch with data-theme="dark".

How it works (technical flow)

1. Embed — host page includes the single <script>. The script dynamically injects a sandboxed iframe into the DOM.
2. Initialization — the iframe loads the widget UI and requests configuration from the parent (if applicable).
3. Input — users paste proxy lists in supported formats: IP:Port, IP Port, IP\tPort, or with protocol prefixes (http://, socks5://, etc.).
4. Processing — small lists (≤ threshold) are processed immediately. For larger lists the widget splits input into chunks of data-chunk-size and schedules them sequentially to avoid spikes and backend rate limits.
5. Validation — each proxy is validated for connectivity, protocol support, anonymity level and approximate geolocation.
6. Results — results stream back to the iframe in realtime; the widget updates the progress bar and per-proxy status. Links to full result pages are available.
7. Communication — the widget uses a secure postMessage channel with origin validation and tokenized messages.

Security & privacy

Security was a key design concern. The widget includes multiple defensive measures:

• Sandboxed iframe — the widget runs inside an iframe with a strict sandbox attribute to limit capabilities.
• Referrer policy — default policy is no-referrer to minimize leakage of host information.
• Origin validation — every incoming postMessage is validated against an allowlist and token scheme.
• Token-based messages — the widget and backend exchange short-lived tokens for sensitive actions to prevent replay/hijacking.
• Rate control — chunking and throttling reduce the risk of accidental abuse and keep backend resources stable.

Auto-resizing and compatibility

The widget automatically resizes to content height using a progressive approach:

• Primary: ResizeObserver watches the widget root and informs the parent of size changes.
• Fallback: MutationObserver detects DOM changes (for environments without ResizeObserver).
• Final fallback: periodic checks / event listeners ensure compatibility with older browsers.

This combination ensures smooth height updates across modern and legacy environments.

Browser support

• Modern browsers (Chrome, Firefox, Edge, Safari) — full functionality with auto-resize, postMessage, and secure protocols.
• Legacy browsers — graceful degradation: core checking still works, but some progressive enhancements (ResizeObserver, fancy animations) may be limited.
• Mobile — UI is touch-friendly and responsive for smaller screens.

Use cases

The widget is suitable for:

• Developer dashboards and SaaS platforms that need an integrated proxy test tool.
• Tool aggregators (SEO, marketing or security sites) who want to provide a free check tool to visitors.
• Internal tooling — quick validation without building and maintaining a dedicated proxy-check backend.

Operational notes & best practices

• Set data-chunk-size according to expected input size — smaller chunks reduce latency for intermediate results but increase total requests.
• Use data-open-results="0" for embedded workflows where users should remain on the same page; use 1 to open a full result view in a new tab.
• Monitor backend quota if you run the service on a private endpoint — ProxyVerity cloud handles quota for the hosted widget.

Support & contribution

The widget is open-source and maintained on GitHub. For issues, feature requests, or contributions visit: Proxy-Checker-Widget on GitHub. For integration help or commercial support, see proxyverity.com.

Conclusion

The ProxyVerity Proxy Checker Widget provides a secure, practical, and developer-friendly way to add proxy validation to any website with minimal effort. It balances performance (chunking, throttling) with UX (real-time results, responsive design) and security (sandbox, tokenized messages). Embed it today and add immediate, high-value functionality to your site.

Quick links

• Official widget page: proxyverity.com/proxy-checker-widget/
• Live demo: GitHub Pages demo
• CodePen: CodePen demo
• Repository: GitHub
• Proxy tool: proxyverity.com/proxy-checker/