How titaniumnetwork-dev/ultraviolet works
Ultraviolet is a browser-side web proxy for accessing remote sites through a controlled sandbox. The documented flow is browser requests intercepted by a service worker, then proxy handling and response rewriting before content reaches the browser. The client layer adapts DOM, URL, storage, worker, and network APIs; the rewrite layer covers HTML, CSS, JavaScript, URLs, and cookies. The README establishes service-worker interception, while some handler and service-worker wiring is not visible in excerpts, so those links are marked unverified.
Main entry points: rewrite/index.js Rewrite engine · client/index.js Client setup · uv.handler.js Proxy handler · sw.js Service worker
Components 20
Proxy runtime
- Service worker
src/sw.js - Worker runtime
src/uv.sw.js - Proxy handler
src/uv.handler.js
Content rewriting
- Rewrite engine
src/rewrite/index.js - HTML rewrite
src/rewrite/html.js - HTML rules
src/rewrite/rewrite.html.js - Script rules
src/rewrite/rewrite.script.js - CSS rewrite
src/rewrite/css.js - JavaScript rewrite
src/rewrite/js.js - URL and cookie codecs
src/rewrite/codecs.js
Browser client
- Client setup
src/client/index.js - Network adapters
src/client/requests - Worker adapters
src/client/worker.js - DOM adapters
src/client/dom - Location and history
src/client/location.js - Storage adapters
src/client/storage.js
Client hooks
- Interception event
src/client/hook.js
Other components
- Browser
- Remote site
- Bare mux
Connections 21
- Browser → Service worker: sends requests
README.md - Service worker → Worker runtime: dispatches to
- Worker runtime → Proxy handler: routes requests
- Proxy handler → Remote site: fetches content
- Proxy handler → Rewrite engine: rewrites responses
- Rewrite engine → HTML rewrite: uses parser
src/rewrite/index.js - Rewrite engine → CSS rewrite: uses
src/rewrite/index.js - Rewrite engine → JavaScript rewrite: uses
src/rewrite/index.js - Rewrite engine → HTML rules: registers rules
src/rewrite/index.js - Rewrite engine → Script rules: registers rules
src/rewrite/index.js - Rewrite engine → URL and cookie codecs: uses codecs
src/rewrite/index.js - Browser → Client setup: runs client hooks
- Client setup → Network adapters: initializes adapters
src/client/index.js - Client setup → DOM adapters: initializes adapters
src/client/index.js - Client setup → Location and history: initializes adapters
src/client/index.js - Client setup → Storage adapters: initializes adapters
src/client/index.js - Client setup → Worker adapters: initializes adapter
src/client/index.js - DOM adapters → Interception event: emits events
src/client/dom/document.js - Storage adapters → Interception event: creates events
src/client/storage.js - Worker adapters → Bare mux: creates connection
src/client/worker.js - Network adapters → Bare mux: uses transport