BuilderIO/partytown
Partytown
Partytown is a main thread performance optimizer and web worker script orchestrator. It functions as a third party script offloader that relocates resource-intensive external JavaScript from the browser's main thread into a sandboxed web worker environment.
The project focuses on improving core web vitals and overall page responsiveness by reducing main thread blocking time. This isolation ensures that heavy third party scripts do not interfere with the execution of core application code and page loading speed.
The system provides infrastructure for client-side script offloading through DOM API shadowing, request interception, and a main-thread dispatcher for executing mutations. It manages synchronization between threads using shared memory and provides emulation for synchronous network requests.
Features
- Script Offloaders - Offloads resource-intensive third-party JavaScript to background threads to ensure the user interface remains responsive.
- Third-Party Script Execution Management - Runs external scripts in a sandboxed web worker to prevent them from blocking the main browser execution.
- UI Thread Responsiveness - Reduces main thread congestion by isolating third-party scripts within a sandboxed worker environment.
- Blocking Time Reduction - Improves interaction metrics by minimizing main thread blocking time through script isolation.
- Main Thread Dispatchers - Provides a lightweight dispatcher to execute DOM mutations on the main UI thread from a background worker.
- DOM Emulation - Implements a virtual DOM subset within a web worker to allow third-party scripts to interact with page state.
- Performance Optimizations - Optimizes page load speed and responsiveness by moving heavy third-party scripts off the main thread.
- Request Interception Middleware - Captures outgoing network requests from third-party scripts to route them through the worker environment.
- Web Worker Orchestrators - Orchestrates the relocation of resource-intensive third-party scripts from the main thread into a web worker.
- Worker Proxy Frameworks - Redirects main thread function calls to a background worker using a synchronized proxy and message bus.
- Cross-Thread Synchronizers - Simulates blocking synchronous XHR requests in a worker via cross-thread synchronization.
- Thread State Synchronization - Uses SharedArrayBuffer and atomic operations to synchronize state between the main thread and the web worker.
- Third-Party Script Controllers - Provides a mechanism to move heavy third-party scripts into a web worker to increase page loading speed.
- Framework Integrations - Offloads third-party scripts to web workers.
- Web Worker Management - Relocating third-party scripts to web workers.
