Safari localhost proxy limitations
Discover Safari’s localhost proxy limitations in Percy and workarounds for proper resource loading.
Localhost proxy support on Safari
Percy does not support localhost proxying on Safari. If a resource link in your DOM snapshot
uses localhost:<port>/resource
, it will not load on Safari, even if captured via the SDK. Safari bypasses the proxy for localhost and tries to resolves it directly.
Workarounds
- Use relative paths for resources.
- Use a public DNS entry that resolves to
127.0.0.1
(Example: localtest.me or domaincontrol.com or create one on your own). - Create a custom domain with a hosts file entry resolving to
127.0.0.1
(Example: add127.0.0.1 mylocalsite.dev
).
Reference Topic
We're sorry to hear that. Please share your feedback so we can do better
Contact our Support team for immediate help while we work on improving our docs.
We're continuously improving our docs. We'd love to know what you liked
We're sorry to hear that. Please share your feedback so we can do better
Contact our Support team for immediate help while we work on improving our docs.
We're continuously improving our docs. We'd love to know what you liked
Thank you for your valuable feedback!