QwikDev/partytown
Partytown
Partytown is a library designed to offload resource-intensive third-party scripts to background web workers. By executing these scripts outside of the main thread, it prevents them from blocking the critical rendering path, thereby maintaining a responsive user interface and improving overall page load performance.
The project functions as a web worker proxy library that synchronizes browser interfaces between the main thread and background environments. It uses proxy-based access and synchronous messaging to replicate global objects like the window and document, allowing scripts to interact with the DOM and browser APIs from a worker thread. To ensure compatibility, it includes request proxying to bypass cross-origin restrictions and provides fallback execution mechanisms for environments where background processing is limited.
Beyond core offloading, the library offers granular control over script execution through filtering, event forwarding, and configuration settings. It includes diagnostic utilities for auditing third-party activity and tracing script execution, as well as security features for managing storage isolation and content security policies. The library operates as a standalone utility, requiring no specific framework integration or complex build-time modifications to deploy.
Features
- Script Offloaders - Executes resource-intensive third-party scripts in a background thread to prevent main thread blocking and improve page performance.
- Background Processing Workers - Executes resource-intensive third-party scripts in a background thread to prevent main thread blocking and improve overall page responsiveness.
- Worker Proxy Frameworks - Uses proxies and shared memory to synchronize browser interfaces between the main thread and background workers.
- Performance Optimizations - Offloads resource-intensive third-party scripts to background web workers to keep the main thread responsive and improve page load speed.
- Web Performance Optimization Tools - Improves page load speed by offloading heavy tracking and analytics scripts to isolated background execution environments.
- Script Isolators - Moves non-critical scripts into web workers to prevent them from blocking the critical rendering path.
- Third-Party Script Controllers - Centralizes the loading and execution of external marketing and analytics tags to maintain control over site performance.
- Interface Virtualizers - Replicates browser window and document interfaces within a worker environment to provide a consistent execution context.
- Background Thread Dispatchers - Replicates main thread interfaces in a background worker using proxies and serialization to allow scripts to interact with the document structure.
- DOM Synchronization - Coordinates read and write tasks between background threads and the main interface thread to ensure consistent data updates without blocking user interactions.
- Request Proxying Utilities - Routes external script requests through a local server proxy to bypass cross-origin restrictions and ensure proper header configuration.
- Proxy-Based Reactivity - Uses JavaScript proxies to intercept and forward property access and method calls from a background worker to the main thread.
- Web Worker Orchestrators - Synchronizes main thread browser interfaces with background workers to allow complex scripts to run without blocking the user interface.
- Dynamic Script Discovery - Monitors the document for automatically added scripts and notifies the background worker to discover and execute them to ensure complete tracking.
- Cross-Origin Networking - Routes external script requests through a local proxy to bypass cross-origin restrictions and improve the reliability of third-party asset delivery.
- Property Proxying - Intercepts and manages access to global window properties to ensure third-party scripts correctly detect namespaces and object existence in background threads.
- Service Worker Request Routing - Routes external network requests through a local service worker to bypass cross-origin restrictions and cache third-party assets.
- Execution Fallbacks - Runs scripts on the main thread automatically when advanced background processing features are unavailable to ensure consistent functionality.
- Execution Throttling - Limits the execution frequency of external scripts to ensure the main thread remains available for critical user interactions.
- Execution Filters - Selects which scripts run within a background worker and which remain on the main thread to balance performance and compatibility.
- Cross-Thread Synchronizers - Employs synchronous message passing between the main thread and workers to maintain the expected execution flow of legacy scripts.
- Storage Isolations - Manages cookies and local storage access for scripts running in background threads while restricting access to sensitive browser features.
- Activity Auditing - Logs API calls and arguments made by third-party scripts to provide visibility into their behavior and interactions with the browser environment.
- Cross-Thread Event Forwarders - Routes specific function calls and events from the main thread to the background worker to maintain script functionality.
- Script Redirectors - Automatically redirects third-party script execution to background threads to prevent main thread blocking.
