Esta página se muestra en inglés. Una traducción al español está en curso.
ScriptsMay 11, 2026·3 min de lectura

Partytown — Run Third-Party Scripts in a Web Worker

A lightweight library that relocates resource-intensive third-party scripts off of the main thread and into a web worker, improving page performance and Core Web Vitals.

Script Depot
Script Depot · Community

Introduction

Partytown moves third-party scripts like analytics, tag managers, and tracking pixels off the main thread and into a web worker. This frees the main thread for your application code, leading to faster page loads and better responsiveness.

What Partytown Does

  • Executes third-party scripts inside a web worker instead of the main thread
  • Provides synchronous DOM access from the worker via a service worker proxy
  • Forwards global function calls (like dataLayer.push) from main thread to worker
  • Reduces main-thread blocking caused by analytics, ads, and chat widgets
  • Integrates with Next.js, Nuxt, Astro, Remix, and other frameworks via plugins

Architecture Overview

Partytown uses a service worker as a middleware layer between the web worker and the main thread. When a third-party script running in the worker tries to access the DOM, the request is proxied through the service worker to the main thread using synchronous XHR. This approach allows scripts that expect synchronous DOM access to work transparently inside a worker without code changes.

Self-Hosting & Configuration

  • Install via npm and copy library files to your public directory with npx partytown copylib
  • Add the Partytown snippet to the <head> of your HTML before any third-party scripts
  • Change third-party script tags from type="text/javascript" to type="text/partytown"
  • Configure the forward array to proxy global function calls like dataLayer.push or fbq
  • Use framework-specific integrations for Next.js (@builder.io/partytown/nextjs), Astro, or Nuxt

Key Features

  • Zero changes to third-party script code required
  • Configurable forwarding for global function calls and event queues
  • Built-in integrations for Next.js, Nuxt, Astro, Remix, and SvelteKit
  • Sandboxing: third-party scripts cannot access cookies or localStorage unless explicitly allowed
  • Atomic DOM operations batched for minimal cross-thread communication overhead

Comparison with Similar Tools

  • Google Tag Manager server-side — runs tags on a server; Partytown runs them client-side in a worker
  • Zaraz (Cloudflare) — edge-based third-party script management; Partytown is self-hosted and framework-agnostic
  • Script defer/async — reduces parser blocking but scripts still run on the main thread; Partytown moves execution entirely off-thread
  • Web Workers (manual) — require rewriting scripts; Partytown provides transparent DOM proxying
  • Inline script lazy loading — delays execution; Partytown runs scripts concurrently without blocking

FAQ

Q: Does Partytown work with Google Analytics and GTM? A: Yes. Google Tag Manager and Google Analytics are common use cases. You add them as type="text/partytown" scripts and forward dataLayer.push.

Q: Will every third-party script work in Partytown? A: Most analytics and tracking scripts work. Scripts that heavily manipulate the visible DOM (like chat widgets that render UI) may need testing. The project maintains a list of tested integrations.

Q: Does Partytown add latency to events? A: There is a small overhead from cross-thread communication, but for analytics and tracking this is negligible. The net effect is positive because your main thread runs faster.

Q: Is Partytown production-ready? A: It is used in production by multiple companies. The library is still labeled beta, so thorough testing with your specific third-party scripts is recommended.

Sources

Discusión

Inicia sesión para unirte a la discusión.
Aún no hay comentarios. Sé el primero en compartir tus ideas.

Activos relacionados

Komga — Self-Hosted Comics and Manga Server

A media server for comics, manga, and digital books. Komga scans your library, provides a web-based reader, and serves content via OPDS for third-party reading apps.

Scripts
Script Depot

WebLLM — Run Large Language Models Directly in the Browser

WebLLM is an MLC project that brings LLM inference to web browsers using WebGPU. It runs models like LLaMA, Mistral, and Phi entirely client-side with no server required, enabling private AI chat and text generation from any modern browser.

Scripts
Script Depot

Robyn — High-Performance Python Web Framework with Rust Runtime

A fast Python web framework that uses a Rust-based async runtime for request handling while keeping the developer experience in pure Python.

Scripts
Script Depot

Screego — Self-Hosted Screen Sharing for Developers

A lightweight self-hosted screen sharing tool built with Go and WebRTC, designed for developer teams who need low-latency sharing without third-party services.

Scripts
Script Depot
◈Inicio🔍Buscar👤Yo