What mapping redirects#
A mapping sends matching traffic to a different destination instead of changing the request on its way through.
Mapping redirects a URL to a different destination. Two flavours sit side by side as their own sub-tabs.
- Map Remote: redirect a host or URL to another host on the network.
- Map Local: serve a URL from a directory on your machine.
How mapping is different from rules#
A rule modifies a request as it passes through. A mapping rewrites the destination entirely: matching traffic goes somewhere else.
Use mapping when:
- You want to swap a production API for staging without touching the client.
- You want to iterate on a local asset without redeploying.
- You want to point a mobile build at a dev backend without changing its code.
For everything else (header rewrites, status replacements, content edits), use a rule.
Where mappings live#
GraphDagger stores mappings alongside rules in the rules store. Mappings apply to live recording only, so a static HAR file does not redirect anything.
What every mapping row holds#
Both Map Remote and Map Local list one rule per row. Every row has the same shape.
- Toggle: enables or disables the rule without a delete.
- Fields: the values that define the mapping.
- Actions: a regex toggle (Map Remote only), a test button, and a delete button.
Test a mapping first#
Both Map Remote and Map Local have a built-in test feature so you can verify a mapping without firing a real request. See Testing a Map Remote and Testing a Map Local.