All samples

Minimal JavaScript browser app using Dev Proxy

Demonstrates the minimal setup to use Dev Proxy with JavaScript in a browser

Waldek Mastykarz

Minimal JavaScript browser app using Dev Proxy

Summary

This sample demonstrates the minimal setup to use Dev Proxy with JavaScript running in a browser. It shows how to:

  • Configure Dev Proxy to intercept API requests from a browser
  • Mock API responses using the MockResponsePlugin with CORS headers
  • Run a simple web app through Dev Proxy

The sample makes a single API call to JSONPlaceholder and returns a mocked response, demonstrating how Dev Proxy intercepts and replaces the real API call in a browser environment.

Dev Proxy mocking a browser API request

Compatibility

Dev Proxy v2.1.0

Contributors

Version history

VersionDateComments
1.2February 4, 2026Updated to Dev Proxy v2.1.0
1.1January 18, 2026Fixed sample metadata
1.0January 5, 2026Initial release

Prerequisites

Minimal path to awesome

  • Get the sample:
    • Download just this sample:

      npx gitload-cli https://github.com/pnp/proxy-samples/tree/main/samples/minimal-browser-js

      or

    • Download as a .ZIP file and unzip it, or

    • Clone this repository

  • Navigate to the sample folder: cd samples/minimal-browser-js
  • Run npm install to install dependencies
  • Run npm start to start Dev Proxy and the web server
  • Open http://localhost:3000 in your browser
  • Click the button to fetch data and observe the mocked response with headers x-powered-by: Dev Proxy and x-mocked-by: Dev Proxy MockResponsePlugin

Features

This sample illustrates the following concepts:

  • Configuring Dev Proxy with a .devproxy/devproxyrc.json file
  • Using MockResponsePlugin to return custom API responses with CORS headers
  • Running browser-based JavaScript applications through Dev Proxy
  • Adding custom headers to mocked responses

Help

We do not support samples, but this community is always willing to help, and we want to improve these samples. We use GitHub to track issues, which makes it easy for community members to volunteer their time and help resolve issues.

You can try looking at issues related to this sample to see if anybody else is having the same issues.

If you encounter any issues using this sample, create a new issue.

Finally, if you have an idea for improvement, make a suggestion.

Disclaimer

THIS CODE IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING ANY IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR NON-INFRINGEMENT.