# GoogleChromeLabs/comlink

Comlink makes WebWorkers enjoyable.

Repository: https://github.com/GoogleChromeLabs/comlink
Canonical: https://ross.abutalabs.com/products/comlink
Language: TypeScript
License: Apache-2.0
License Family: permissive
Last push: 2026-08-11T21:05:22+00:00

## Health v2 (maintenance only)
Score: 66/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 97, release rhythm 8, longevity 100
- inputs: {"age_days": 3283, "days_push": 22, "days_rel": 664, "gap_med": null, "n_releases_24m": 1}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 12787, forks 436 (observed 2026-08-28T04:10:59.796930+00:00)

## What it is
Comlink is a tiny (1.1kB) TypeScript library that implements RPC over postMessage using ES6 Proxies, making WebWorkers feel like local objects. It hides the message-passing boilerplate so you can call worker code with plain async/await.

## Use cases
- run heavy computation off the main thread with web workers
- call worker functions like local async functions
- avoid postMessage boilerplate in browser apps
- keep the UI thread responsive on low-end mobile devices
- share objects between main thread and worker
- use callbacks and proxies across worker boundaries

## When to choose
- you want ergonomic, promise-based WebWorker communication in the browser
- you need a tiny dependency with broad browser support
- you want to move CPU-heavy work off the main thread without rewriting APIs

## When to avoid
- you need shared-memory parallelism or fine-grained thread control
- your environment lacks WebWorkers or ES6 Proxy support and you can't polyfill
- you need structured high-throughput message passing rather than RPC-style calls

## Facets
- artifact type: library
- maturity: stable
- function: rpc, concurrency, developer-tools
- domain: web-development, frontend, developer-tools
- platform: browser
- tags: webworkers, es6-proxies, postmessage, typescript, multithreading, web-server, nodejs

## Member repositories
- GoogleChromeLabs/comlink (main) score 66

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:59.796930+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:13:47.788926+00:00, confidence not recorded.
  - readme: https://github.com/GoogleChromeLabs/comlink (fetched 2026-08-28T04:10:59.796930+00:00, sha 3ff26090558f)
  - registry_npm: https://registry.npmjs.org/comlink (fetched 2026-08-29T08:10:12.144591+00:00, sha 52510d21b7ac)
- Data as of 2026-08-30T08:39:29.467469+00:00.