mirror of
https://github.com/withastro/astro.git
synced 2024-12-23 21:53:55 -05:00
5e52814d97
* Adapter v0 * Finalizing adapters * Update the lockfile * Add the default adapter after config setup is called * Create the default adapter in config:done * Fix lint error * Remove unused callConfigSetup * remove unused export * Use a test adapter to test SSR * Adds a changeset * Updated based on feedback * Updated the lockfile * Only throw if set to a different adapter * Clean up outdated comments * Move the adapter to an config option * Make adapter optional * Update the docs/changeset to reflect config API change * Clarify regular Node usage
1.3 KiB
1.3 KiB
@astrojs/node
An experimental static-side rendering adapter for use with Node.js servers.
In your astro.config.mjs use:
import nodejs from '@astrojs/node';
export default {
adapter: nodejs()
}
After performing a build there will be a dist/server/entry.mjs
module that works like a middleware function. You can use with any framework that supports the Node request
and response
objects. For example, with Express you can do:
import express from 'express';
import { handler as ssrHandler } from './dist/server/entry.mjs';
const app = express();
app.use(ssrHandler);
app.listen(8080);
Using http
This adapter does not require you use Express and can work with even the http
and https
modules. The adapter does following the Expression convention of calling a function when either
- A route is not found for the request.
- There was an error rendering.
You can use these to implement your own 404 behavior like so:
import http from 'http';
import { handler as ssrHandler } from './dist/server/entry.mjs';
http.createServer(function(req, res) {
ssrHandler(req, res, err => {
if(err) {
res.writeHead(500);
res.end(err.toString());
} else {
// Serve your static assets here maybe?
// 404?
res.writeHead(404);
res.end();
}
});
}).listen(8080);