Add Ons
Use our WonderSwitcher browser extension to quickly switch between proxy servers
WonderSwitcher
The WonderSwitcher browser extension is designed to allow you to start testing sooner, and complete your manual testing faster.
Installation
Getting started
After installing the Switcher, follow the steps in the pop-up to add your WonderProxy credentials and import your servers.
Search or browse to find a proxy server, and click to connect. When you are connected to a proxy server, the Switcher icon will turn green.
Access your settings and more features by clicking the gear icon in the pop-up.
Proxy servers
Manage your proxy servers in the Proxy Servers tab in your settings.
Import WonderProxy servers
Import all servers from your WonderProxy account with the click of a button.
- Go to your account's servers page
- Click Import to Switcher
When you add or remove servers in your WonderProxy account, import them to the Switcher again to keep your list updated.
Add custom servers
If you have your own proxy server you'd like to use, you can add a custom server.
- In the Proxy Servers tab, click Add Server
- Set a display name, e.g. Custom Server
- Set a hostname, e.g.
example.com - Set a port, e.g.
12000 - Set custom credentials (optional)
- Click Save
Credentials
Save your WonderProxy or global credentials in the Switcher to make connecting to proxy servers easier. The Switcher uses these credentials for all proxy servers, unless you set custom credentials for specific servers.
The Switcher asks for your credentials during setup. You can update your credentials in the Credentials tab at any time.
WonderProxy credentials
If you have a WonderProxy account, enter your username and a proxy token.
When you click Save, the Switcher will verify your credentials and notify you if there are any problems.
The Switcher will tell you when your proxy token will expire.
Global credentials
If you don't have a WonderProxy account, you can set global credentials to use for all your proxy servers. This is optional, but convenient if you use the same username and password for multiple servers.
Custom credentials
The Switcher uses your WonderProxy or global credentials by default for all servers. If you need to, you can change the credentials for individual servers.
- In the Proxy Servers tab, click Add Server or find an existing server and click Edit
- Uncheck the Use my WonderProxy (or global) credentials box
- Enter your credentials
- Click Save
Geolocation
The Switcher supports two types of localization testing:
| Type | Description |
|---|---|
| GeoIP | Send your browser traffic through a proxy server, so it reflects the proxy server's IP address and location |
| Browser geolocation (optional) | Override how your browser reports your location to match the coordinates of the proxy server |
All WonderProxy servers are physically located where we say they are. When you connect to a WonderProxy server, your geoIP and browser geolocation will reflect your selected location.
Both of these features:
- Work only while you are connected to a proxy
- Respect any filters you have enabled
GeoIP testing
When you connect to a WonderProxy server, your browser traffic will travel through that proxy server and adopt its IP address. Any websites that are localized with geoIP will place you at the location of the proxy server.
This feature works automatically whenever you connect to a WonderProxy server.
Browser geolocation testing
Your browser can determine the physical location of your device using GPS, WiFi positioning, cell network positioning, and other methods. When you connect to a WonderProxy server, the Switcher can override your browser location to match the latitude and longitude of the proxy server.
Geolocation overriding is optional, but on by default. You can manage this feature in the Geolocation tab. This feature is not available for custom servers.
- Enable Override browser geolocation
-
Enable location sharing in your browser settings:
Share your location in Chrome
Share your location in Firefox
Share your location in Edge - Connect to a WonderProxy server
- Visit the site you want to test
- Allow the site permission to access your location, when prompted
When geolocation overriding is enabled, a small globe icon will appear in the Switcher popup.
Reminder
Display a flashing notice on the extension icon when a specified amount of time has passed.
- Open WonderSwitcher extension and click Settings, then the Reminder option in the side menu
- Ensure that the reminder setting is enabled and you have entered an amount in minutes
- Save your changes
Header
Set a custom HTTP header that will be included when using the Switcher. It's occasionally useful to identify your testing traffic, either to bypass your CDN, or to have your testing traffic omitted from analytics.
- Open WonderSwitcher extension and click Settings, then Header from the side menu
- Ensure that the feature is toggled on, and you have added values to both required fields
- Make sure to save your changes
Filters
Specify domains or IP addresses you’d like to include or exclude from proxied traffic. Exclusion is useful when you wish to access internal network resources (like a bug tracker) while using the proxy. Inclusion is useful when you wish to only route some traffic through the proxy (like your website) while skipping the proxy for all other traffic.
- Open WonderSwitcher extension and click Settings, then click the Filters menu option.
- Toggle the feature on
- Select the Include traffic or Exclude traffic option
-
List the domains or IPs you would like to filter, separated by commas (
domain.com,*.domain.com) - Save your changes
Warnings & notices
This popup may appear at some point after installing this plugin. It's warning you (correctly) that configuring a proxy server means all the data in your browser will be sent through that proxy. In our case, that's what we want: to use a proxy server for geoIP testing. You will need to select "Keep Changes" to continue using the WonderSwitcher.
