platform/packages/proxy/README.md
2024-10-12 18:45:27 -07:00

1.3 KiB

Protevus Proxy

Pub Version (including pre-releases) Null Safety Discord License

Protevus middleware to forward requests to another server (i.e. webdev serve). Also supports WebSockets.

import 'package:protevus_proxy/protevus_proxy.dart';
import 'package:http/http.dart' as http;

void main() async {
  // Forward requests instead of serving statically.
  // You can also pass a URI, instead of a string.
  var proxy1 = Proxy('http://localhost:3000');
  
  // handle all methods (GET, POST, ...)
  app.fallback(proxy.handleRequest);
}

You can also restrict the proxy to serving only from a specific root:

Proxy(baseUrl, publicPath: '/remote');

Also, you can map requests to a root path on the remote server:

Proxy(baseUrl.replace(path: '/path'));

Request bodies will be forwarded as well, if they are not empty. This allows things like POST requests to function. For a request body to be forwarded, the body must not have already been parsed.