https://github.com/binki/express-autoserve

Use http-autodetect with Express apps to deploy to FastCGI, Passenger, node http, etc.
https://github.com/binki/express-autoserve

Last synced: 9 months ago
JSON representation

Use http-autodetect with Express apps to deploy to FastCGI, Passenger, node http, etc.

• Host: GitHub
• URL: https://github.com/binki/express-autoserve
• Owner: binki
• License: other
• Created: 2016-08-23T06:04:55.000Z (almost 10 years ago)
• Default Branch: master
• Last Pushed: 2016-09-28T05:28:22.000Z (over 9 years ago)
• Last Synced: 2025-08-20T07:33:17.915Z (10 months ago)
• Language: JavaScript
• Size: 13.7 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

          
[Autodetect the service platform](https://github.com/binki/autoserve) and delegate to an

Express app.

# Usage

    const expressAutoserve = require('express-autoserve');

    const app = require('./app');

    

    expressAutoserve(app);

# Mechanics

## `req.baseUrl`

The node [`http`](https://nodejs.org/api/http.html) module has no

concept of `baseUrl` because it assumes it will get to open the TCP

socket itself and just serve out pages at `/`. However, various

deployment strategies supported by

[`autoserve`](https://github.com/binki/autoserve) are

commonly used to deploy applications at URIs other than `/`. Thus

`autoserve` provides a `getBaseUrl(req)` function to discover

the baseUrl for the current request (in FastCGI, the necessary

information is not available until a request is received).

Express supports mounting applications at sub-paths. To enable mounted

applications to generate absolute URIs to resources within the apps,

it provide the

[`req.baseUrl`](https://expressjs.com/en/4x/api.html#req.baseUrl)

property. This enables the following to work sensibly:

    const express = require('express');

    

    const app = express();

    

    const subApp = express();

    subApp.get('/asdf', function (req, res) {

       // When mounted, will get /subApp/foo

      res.send(`Another resource on this app is ${req.baseUrl}/foo`);

    });

    subApp.get('/foo', function (req, res) {

      res.send(`You found me!`);

    });

    

    app.use('/subApp', subApp);

    app.listen(3000);

This module ensures that the passed app is treated like it is mounted

in an express app at the `baseUrl` calculated by

`autoserve`. This causes the `baseUrl` to be set properly for

the passed app and ensures that routing is performed relative to the

deployment `baseUrl`.