By name: pixijs-environments description: "Use for PixiJS v8 environments outside normal browser pages: Web Workers, OffscreenCanvas, Node/SSR, CSP, DOMAdapter, BrowserAdapter, WebWorkerAdapter, unsafe-eval." license: MIT
Use this for non-standard runtimes: workers, OffscreenCanvas, Node/SSR, or strict CSP.
Rules
- Use
DOMAdapter.set(...)to select or provide the environment adapter before creating renderer/application objects. - Use
WebWorkerAdapterand OffscreenCanvas patterns for worker rendering. - In Node/SSR, avoid touching browser globals unless an adapter or mock is installed.
- For strict CSP, avoid code paths that require dynamic evaluation; only use
pixi.js/unsafe-evalwhen policy allows it and the project accepts the tradeoff. - Keep environment setup near the application bootstrap.
Deep Reads
- Full adapter and runtime examples: references/details.md
- Standard application setup:
pixijs-application - Migration from
settings.ADAPTER:pixijs-migration-v8
Common Fixes
document/windowmissing: set the right adapter before init.- Worker canvas fails: verify OffscreenCanvas transfer and worker-side imports.
- CSP error: remove unsafe-eval-dependent imports or explicitly choose the unsafe build only when allowed.