Skip to main content
No Result Found

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: add 127.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





Thank you for your valuable feedback

Is this page helping you?

Yes
No

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!

Talk to an Expert
Download Copy Check Circle