npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

hops-development-proxy

v15.2.1

Published

Proxy

Downloads

852

Readme

hops-development-proxy

npm

Please see the main Hops Readme for general information and a Getting Started Guide.

Hops preset that adds an API-proxy for development.

Hops apps are often run on the same host as their backend/api endpoints. However, when working locally, backend apps often run on a different host as the frontend application. This can cause issues with cross origin requests during development that are of no concern in the production environment.

This package allows to proxy requests to your api server which runs on a different host/port.

Installation

Add hops-development-proxy to your project.

npm install --save hops-development-proxy

Usage

hops-development-proxy attaches a proxy when the application runs in development mode. It does not do anything when run in production mode.

Configuration

Preset Options

| Name | Type | Default | Required | Description | | --- | --- | --- | --- | --- | | proxy | String | Object | undefined | no | Proxy target configuration |

proxy

Configures where to proxy API requests to.

Simplest way to set up the proxy is to configure the proxy target URL as string. In this case, the proxy target URL is used for every request that is not an HTML document (i.e. a requested page) or an asset (js file, css file etc.) served by the webpack dev server.

Example

.hopsrc.js

module.exports = {
  proxy: 'https://example.org/',
};

browser GET / -> Is handled by your Hops application, because browser requests an html file.

GET /assets/main.js -> Will always be handled by webpack dev server, because it takes precedence.

fetch GET /api/data -> Is proxied to https://example.org/, results in https://example.org/api/data being requested.

If more flexibility is needed, proxy can also be configured as an object, where the keys represent express route matchers to be proxied and target to configure the respective proxy target.

.hopsrc.js

module.exports = {
  proxy: {
    '/api': { target: 'https://example.org/' },
    '/legacy-api': { target: 'https://example.org/old' },
  },
};

When the object notation is used, every request that is not handled by the webpack dev server, will be proxied as long as the route matches. This is also true for html documents.

Mixin Hooks API

Caution: Please be aware that the mixin hooks are not part of the SemVer API contract. This means that hook methods and signatures can change even in minor releases. Therefore it's up to you to make sure that all hooks that you are using in your own mixins still adhere to the new implementation after an upgrade of a Hops packages.

onProxyReq(): void (sequence) core

Hook to implement http-proxy-middleware onProxyReq event callback.

Example: Add request headers

Sometimes additional request headers are needed, for example to add a fake user id for the backend api.

mixin.core.js

const { Mixin } = require('hops-mixin');

class MyMixin extends Mixin {
  onProxyReq(proxyReq) {
    proxyReq.setHeader('X-USER-ID', '23');
  }
}

module.exports = MyMixin;

onProxyRes(): void (sequence) core

Hook to implement http-proxy-middleware onProxyRes event callback.

onProxyError(): void (sequence) core

Hook to implement http-proxy-middleware onError event callback.

Debugging

Available tags for the debug-module are:

  • hops:development-proxy