Troubleshooting

Network requests not replaying

qckfx uses a system HTTP proxy to intercept and replay network requests. For this to work, your app must use URLSessionConfiguration.default, which respects the system proxy settings.

Custom URLSessionConfiguration instances or .ephemeral sessions may not route traffic through the system proxy, which means qckfx won't be able to capture or replay those requests.

Low-level networking

NWConnection and other low-level networking APIs bypass the system proxy entirely. Requests made through these APIs won't be captured or replayed by qckfx.

Socket.io

If your app uses Socket.io, configure SocketManager with .forceWebsockets(true) and .useCustomEngine(false). Without these settings, websocket traffic won't flow through the proxy.

let manager = SocketManager(
    socketURL: url,
    config: [
        .forceWebsockets(true),
        .useCustomEngine(false)
    ]
)