mirror of
https://github.com/honojs/hono.git
synced 2024-11-21 18:18:57 +01:00
feat(middleware/combine): Introduce combine middleware (#2941)
* feat(middleware/predicate): Introduce predicate middleware * fix: apply `bun run format:fix` * refactor: rename middleware predicate -> combine
This commit is contained in:
Taku Amano
GitHub
parent
e6d253d96f
commit
9a6e52d734
1
jsr.json
1
jsr.json
@ -51,6 +51,7 @@
|
||||
"./pretty-json": "./src/middleware/pretty-json/index.ts",
|
||||
"./request-id": "./src/middleware/request-id/request-id.ts",
|
||||
"./secure-headers": "./src/middleware/secure-headers/secure-headers.ts",
|
||||
"./combine": "./src/middleware/combine/index.ts",
|
||||
"./ssg": "./src/helper/ssg/index.ts",
|
||||
"./streaming": "./src/helper/streaming/index.ts",
|
||||
"./validator": "./src/validator/index.ts",
|
||||
|
||||
@ -233,6 +233,11 @@
|
||||
"import": "./dist/middleware/secure-headers/index.js",
|
||||
"require": "./dist/cjs/middleware/secure-headers/index.js"
|
||||
},
|
||||
"./combine": {
|
||||
"types": "./dist/types/middleware/combine/index.d.ts",
|
||||
"import": "./dist/middleware/combine/index.js",
|
||||
"require": "./dist/cjs/middleware/combine/index.js"
|
||||
},
|
||||
"./ssg": {
|
||||
"types": "./dist/types/helper/ssg/index.d.ts",
|
||||
"import": "./dist/helper/ssg/index.js",
|
||||
@ -493,6 +498,9 @@
|
||||
"secure-headers": [
|
||||
"./dist/types/middleware/secure-headers"
|
||||
],
|
||||
"combine": [
|
||||
"./dist/types/middleware/combine"
|
||||
],
|
||||
"validator": [
|
||||
"./dist/types/validator/index.d.ts"
|
||||
],
|
||||
|
||||
264
src/middleware/combine/index.test.ts
Normal file
264
src/middleware/combine/index.test.ts
Normal file
@ -0,0 +1,264 @@
|
||||
import { Hono } from '../../hono'
|
||||
import { every, except, some } from '.'
|
||||
import type { MiddlewareHandler } from '../../types'
|
||||
|
||||
const nextMiddleware: MiddlewareHandler = async (_, next) => await next()
|
||||
|
||||
describe('some', () => {
|
||||
let app: Hono
|
||||
|
||||
beforeEach(() => {
|
||||
app = new Hono()
|
||||
})
|
||||
|
||||
it('Should call only the first middleware', async () => {
|
||||
const middleware1 = vi.fn(nextMiddleware)
|
||||
const middleware2 = vi.fn(nextMiddleware)
|
||||
|
||||
app.use('/', some(middleware1, middleware2))
|
||||
app.get('/', (c) => {
|
||||
return c.text('Hello World')
|
||||
})
|
||||
const res = await app.request('http://localhost/')
|
||||
|
||||
expect(middleware1).toBeCalled()
|
||||
expect(middleware2).not.toBeCalled()
|
||||
expect(await res.text()).toBe('Hello World')
|
||||
})
|
||||
|
||||
it('Should try to call the second middleware if the first one throws an error', async () => {
|
||||
const middleware1 = () => {
|
||||
throw new Error('Error')
|
||||
}
|
||||
const middleware2 = vi.fn(nextMiddleware)
|
||||
|
||||
app.use('/', some(middleware1, middleware2))
|
||||
app.get('/', (c) => {
|
||||
return c.text('Hello World')
|
||||
})
|
||||
const res = await app.request('http://localhost/')
|
||||
|
||||
expect(middleware2).toBeCalled()
|
||||
expect(await res.text()).toBe('Hello World')
|
||||
})
|
||||
|
||||
it('Should try to call the second middleware if the first one returns false', async () => {
|
||||
const middleware1 = () => false
|
||||
const middleware2 = vi.fn(nextMiddleware)
|
||||
|
||||
app.use('/', some(middleware1, middleware2))
|
||||
app.get('/', (c) => {
|
||||
return c.text('Hello World')
|
||||
})
|
||||
const res = await app.request('http://localhost/')
|
||||
|
||||
expect(middleware2).toBeCalled()
|
||||
expect(await res.text()).toBe('Hello World')
|
||||
})
|
||||
|
||||
it('Should throw last error if all middleware throw an error', async () => {
|
||||
const middleware1 = () => {
|
||||
throw new Error('Error1')
|
||||
}
|
||||
const middleware2 = () => {
|
||||
throw new Error('Error2')
|
||||
}
|
||||
|
||||
app.use('/', some(middleware1, middleware2))
|
||||
app.get('/', (c) => {
|
||||
return c.text('Hello World')
|
||||
})
|
||||
app.onError((error, c) => {
|
||||
return c.text(error.message)
|
||||
})
|
||||
const res = await app.request('http://localhost/')
|
||||
|
||||
expect(await res.text()).toBe('Error2')
|
||||
})
|
||||
|
||||
it('Should throw error if all middleware return false', async () => {
|
||||
const middleware1 = () => false
|
||||
const middleware2 = () => false
|
||||
|
||||
app.use('/', some(middleware1, middleware2))
|
||||
app.get('/', (c) => {
|
||||
return c.text('Hello World')
|
||||
})
|
||||
app.onError((_, c) => {
|
||||
return c.text('oops')
|
||||
})
|
||||
const res = await app.request('http://localhost/')
|
||||
|
||||
expect(await res.text()).toBe('oops')
|
||||
})
|
||||
})
|
||||
|
||||
describe('every', () => {
|
||||
let app: Hono
|
||||
|
||||
beforeEach(() => {
|
||||
app = new Hono()
|
||||
})
|
||||
|
||||
it('Should call all middleware', async () => {
|
||||
const middleware1 = vi.fn(nextMiddleware)
|
||||
const middleware2 = vi.fn(nextMiddleware)
|
||||
|
||||
app.use('/', every(middleware1, middleware2))
|
||||
app.get('/', (c) => {
|
||||
return c.text('Hello World')
|
||||
})
|
||||
const res = await app.request('http://localhost/')
|
||||
|
||||
expect(middleware1).toBeCalled()
|
||||
expect(middleware2).toBeCalled()
|
||||
expect(await res.text()).toBe('Hello World')
|
||||
})
|
||||
|
||||
it('Should throw error if any middleware throws an error', async () => {
|
||||
const middleware1 = () => {
|
||||
throw new Error('Error1')
|
||||
}
|
||||
const middleware2 = vi.fn(nextMiddleware)
|
||||
|
||||
app.use('/', every(middleware1, middleware2))
|
||||
app.get('/', (c) => {
|
||||
return c.text('Hello World')
|
||||
})
|
||||
app.onError((error, c) => {
|
||||
return c.text(error.message)
|
||||
})
|
||||
const res = await app.request('http://localhost/')
|
||||
|
||||
expect(await res.text()).toBe('Error1')
|
||||
expect(middleware2).not.toBeCalled()
|
||||
})
|
||||
|
||||
it('Should throw error if any middleware returns false', async () => {
|
||||
const middleware1 = () => false
|
||||
const middleware2 = vi.fn(nextMiddleware)
|
||||
|
||||
app.use('/', every(middleware1, middleware2))
|
||||
app.get('/', (c) => {
|
||||
return c.text('Hello World')
|
||||
})
|
||||
app.onError((_, c) => {
|
||||
return c.text('oops')
|
||||
})
|
||||
const res = await app.request('http://localhost/')
|
||||
|
||||
expect(await res.text()).toBe('oops')
|
||||
expect(middleware2).not.toBeCalled()
|
||||
})
|
||||
})
|
||||
|
||||
describe('except', () => {
|
||||
let app: Hono
|
||||
|
||||
beforeEach(() => {
|
||||
app = new Hono()
|
||||
})
|
||||
|
||||
it('Should call all middleware, except the one that matches the condition', async () => {
|
||||
const middleware1 = vi.fn(nextMiddleware)
|
||||
const middleware2 = vi.fn(nextMiddleware)
|
||||
|
||||
app.use('*', except('/maintenance', middleware1, middleware2))
|
||||
app.get('/maintenance', (c) => {
|
||||
return c.text('Hello Maintenance')
|
||||
})
|
||||
app.get('*', (c) => {
|
||||
return c.redirect('/maintenance')
|
||||
})
|
||||
let res = await app.request('http://localhost/')
|
||||
|
||||
expect(middleware1).toBeCalled()
|
||||
expect(middleware2).toBeCalled()
|
||||
expect(res.headers.get('location')).toBe('/maintenance')
|
||||
|
||||
middleware1.mockClear()
|
||||
middleware2.mockClear()
|
||||
res = await app.request('http://localhost/maintenance')
|
||||
|
||||
expect(middleware1).not.toBeCalled()
|
||||
expect(middleware2).not.toBeCalled()
|
||||
expect(await res.text()).toBe('Hello Maintenance')
|
||||
})
|
||||
|
||||
it('Should call all middleware, except the one that matches some of the conditions', async () => {
|
||||
const middleware1 = vi.fn(nextMiddleware)
|
||||
const middleware2 = vi.fn(nextMiddleware)
|
||||
|
||||
app.use('*', except(['/maintenance', '/public/users/:id'], middleware1, middleware2))
|
||||
app.get('/maintenance', (c) => {
|
||||
return c.text('Hello Maintenance')
|
||||
})
|
||||
app.get('/public/users/:id', (c) => {
|
||||
return c.text(`Hello Public User ${c.req.param('id')}`)
|
||||
})
|
||||
app.get('/secret', (c) => {
|
||||
return c.text('Hello Secret')
|
||||
})
|
||||
let res = await app.request('http://localhost/secret')
|
||||
|
||||
expect(middleware1).toBeCalled()
|
||||
expect(middleware2).toBeCalled()
|
||||
expect(await res.text()).toBe('Hello Secret')
|
||||
|
||||
middleware1.mockClear()
|
||||
middleware2.mockClear()
|
||||
res = await app.request('http://localhost/maintenance')
|
||||
|
||||
expect(middleware1).not.toBeCalled()
|
||||
expect(middleware2).not.toBeCalled()
|
||||
expect(await res.text()).toBe('Hello Maintenance')
|
||||
|
||||
middleware1.mockClear()
|
||||
middleware2.mockClear()
|
||||
res = await app.request('http://localhost/public/users/123')
|
||||
|
||||
expect(middleware1).not.toBeCalled()
|
||||
expect(middleware2).not.toBeCalled()
|
||||
expect(await res.text()).toBe('Hello Public User 123')
|
||||
})
|
||||
|
||||
it('Should call all middleware, except the one that matches some of the condition function', async () => {
|
||||
const middleware1 = vi.fn(nextMiddleware)
|
||||
const middleware2 = vi.fn(nextMiddleware)
|
||||
|
||||
app.use(
|
||||
'*',
|
||||
except(['/maintenance', (c) => !!c.req.path.match(/public/)], middleware1, middleware2)
|
||||
)
|
||||
app.get('/maintenance', (c) => {
|
||||
return c.text('Hello Maintenance')
|
||||
})
|
||||
app.get('/public/users/:id', (c) => {
|
||||
return c.text(`Hello Public User ${c.req.param('id')}`)
|
||||
})
|
||||
app.get('/secret', (c) => {
|
||||
return c.text('Hello Secret')
|
||||
})
|
||||
let res = await app.request('http://localhost/secret')
|
||||
|
||||
expect(middleware1).toBeCalled()
|
||||
expect(middleware2).toBeCalled()
|
||||
expect(await res.text()).toBe('Hello Secret')
|
||||
|
||||
middleware1.mockClear()
|
||||
middleware2.mockClear()
|
||||
res = await app.request('http://localhost/maintenance')
|
||||
|
||||
expect(middleware1).not.toBeCalled()
|
||||
expect(middleware2).not.toBeCalled()
|
||||
expect(await res.text()).toBe('Hello Maintenance')
|
||||
|
||||
middleware1.mockClear()
|
||||
middleware2.mockClear()
|
||||
res = await app.request('http://localhost/public/users/123')
|
||||
|
||||
expect(middleware1).not.toBeCalled()
|
||||
expect(middleware2).not.toBeCalled()
|
||||
expect(await res.text()).toBe('Hello Public User 123')
|
||||
})
|
||||
})
|
||||
148
src/middleware/combine/index.ts
Normal file
148
src/middleware/combine/index.ts
Normal file
@ -0,0 +1,148 @@
|
||||
import type { Context } from '../../context'
|
||||
import type { MiddlewareHandler, Next } from '../../types'
|
||||
import { TrieRouter } from '../../router/trie-router'
|
||||
import { METHOD_NAME_ALL } from '../../router'
|
||||
import { compose } from '../../compose'
|
||||
|
||||
type Condition = (c: Context) => boolean
|
||||
|
||||
/**
|
||||
* Create a composed middleware that runs the first middleware that returns true.
|
||||
*
|
||||
* @param middleware - An array of MiddlewareHandler or Condition functions.
|
||||
* Middleware is applied in the order it is passed, and if any middleware exits without returning
|
||||
* an exception first, subsequent middleware will not be executed.
|
||||
* You can also pass a condition function that returns a boolean value. If returns true
|
||||
* the evaluation will be halted, and rest of the middleware will not be executed.
|
||||
* @returns A composed middleware.
|
||||
*
|
||||
* @example
|
||||
* ```ts
|
||||
* import { some } from 'combine'
|
||||
* import { bearerAuth } from 'bearer-auth'
|
||||
* import { myRateLimit } from '@/rate-limit'
|
||||
*
|
||||
* // If client has a valid token, then skip rate limiting.
|
||||
* // Otherwise, apply rate limiting.
|
||||
* app.use('/api/*', some(
|
||||
* bearerAuth({ token }),
|
||||
* myRateLimit({ limit: 100 }),
|
||||
* ));
|
||||
* ```
|
||||
*/
|
||||
export const some = (...middleware: (MiddlewareHandler | Condition)[]): MiddlewareHandler => {
|
||||
return async function some(c, next) {
|
||||
let lastError: unknown
|
||||
for (const handler of middleware) {
|
||||
try {
|
||||
const result = await handler(c, next)
|
||||
if (result === true && !c.finalized) {
|
||||
await next()
|
||||
} else if (result === false) {
|
||||
lastError = new Error('No successful middleware found')
|
||||
continue
|
||||
}
|
||||
lastError = undefined
|
||||
break
|
||||
} catch (error) {
|
||||
lastError = error
|
||||
continue
|
||||
}
|
||||
}
|
||||
if (lastError) {
|
||||
throw lastError
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Create a composed middleware that runs all middleware and throws an error if any of them fail.
|
||||
*
|
||||
* @param middleware - An array of MiddlewareHandler or Condition functions.
|
||||
* Middleware is applied in the order it is passed, and if any middleware throws an error,
|
||||
* subsequent middleware will not be executed.
|
||||
* You can also pass a condition function that returns a boolean value. If returns false
|
||||
* the evaluation will be halted, and rest of the middleware will not be executed.
|
||||
* @returns A composed middleware.
|
||||
*
|
||||
* @example
|
||||
* ```ts
|
||||
* import { some, every } from 'combine'
|
||||
* import { bearerAuth } from 'bearer-auth'
|
||||
* import { myCheckLocalNetwork } from '@/check-local-network'
|
||||
* import { myRateLimit } from '@/rate-limit'
|
||||
*
|
||||
* // If client is in local network, then skip authentication and rate limiting.
|
||||
* // Otherwise, apply authentication and rate limiting.
|
||||
* app.use('/api/*', some(
|
||||
* myCheckLocalNetwork(),
|
||||
* every(
|
||||
* bearerAuth({ token }),
|
||||
* myRateLimit({ limit: 100 }),
|
||||
* ),
|
||||
* ));
|
||||
* ```
|
||||
*/
|
||||
export const every = (...middleware: (MiddlewareHandler | Condition)[]): MiddlewareHandler => {
|
||||
const wrappedMiddleware = middleware.map((m) => async (c: Context, next: Next) => {
|
||||
const res = await m(c, next)
|
||||
if (res === false) {
|
||||
throw new Error('Unmet condition')
|
||||
}
|
||||
})
|
||||
|
||||
const handler = async (c: Context, next: Next) =>
|
||||
compose<Context>(wrappedMiddleware.map((m) => [[m, undefined], c.req.param()]))(c, next)
|
||||
|
||||
return async function every(c, next) {
|
||||
await handler(c, next)
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Create a composed middleware that runs all middleware except when the condition is met.
|
||||
*
|
||||
* @param condition - A string or Condition function.
|
||||
* If there are multiple targets to match any of them, they can be passed as an array.
|
||||
* If a string is passed, it will be treated as a path pattern to match.
|
||||
* If a Condition function is passed, it will be evaluated against the request context.
|
||||
* @param middleware - A composed middleware
|
||||
*
|
||||
* @example
|
||||
* ```ts
|
||||
* import { except } from 'combine'
|
||||
* import { bearerAuth } from 'bearer-auth
|
||||
*
|
||||
* // If client is accessing public API, then skip authentication.
|
||||
* // Otherwise, require a valid token.
|
||||
* app.use('/api/*', except(
|
||||
* '/api/public/*',
|
||||
* bearerAuth({ token }),
|
||||
* ));
|
||||
* ```
|
||||
*/
|
||||
export const except = (
|
||||
condition: string | Condition | (string | Condition)[],
|
||||
...middleware: MiddlewareHandler[]
|
||||
): MiddlewareHandler => {
|
||||
let router: TrieRouter<true> | undefined = undefined
|
||||
const conditions = (Array.isArray(condition) ? condition : [condition])
|
||||
.map((condition) => {
|
||||
if (typeof condition === 'string') {
|
||||
router ||= new TrieRouter()
|
||||
router.add(METHOD_NAME_ALL, condition, true)
|
||||
} else {
|
||||
return condition
|
||||
}
|
||||
})
|
||||
.filter(Boolean) as Condition[]
|
||||
|
||||
if (router) {
|
||||
conditions.unshift((c: Context) => !!router?.match(METHOD_NAME_ALL, c.req.path)?.[0]?.[0]?.[0])
|
||||
}
|
||||
|
||||
const handler = some((c: Context) => conditions.some((cond) => cond(c)), every(...middleware))
|
||||
return async function except(c, next) {
|
||||
await handler(c, next)
|
||||
}
|
||||
}
|
||||
Loading…
Reference in New Issue
Block a user