跳到主要内容

中间件

Analog 支持服务端中间件,可以用于修改请求,检查认证,发送跳转等其他操作。

设置中间件

位于 src/server/middleware 目录下的中间件会自动被注册。

src/
└── server/
└── middleware/
└── auth.ts

中间件通过 defineEventHandler 函数来定义。

import { defineEventHandler, sendRedirect, setHeaders } from 'h3';

export default eventHandler((event) => {
if (event.node.req.originalUrl === '/checkout') {
console.log('event url', event.node.req.originalUrl);

setHeaders(event, {
'x-analog-checkout': 'true',
});
}
});
  • 中间件应该只修改请求并且没有任何返回值!
  • 中间件按照文件名的顺序执行。如果要自定义顺序,建议给文件名上加上数字前缀来实现。

中间件的筛选器

中间件可以通过筛选器只处理特定的路由。

export default defineEventHandler(async (event) => {
// Only execute for /admin routes
if (getRequestURL(event).pathname.startsWith('/admin')) {
const cookies = parseCookies(event);
const isLoggedIn = cookies['authToken'];

// check auth and redirect
if (!isLoggedIn) {
sendRedirect(event, '/login', 401);
}
}
});