released v0.9.7 - added test to verify multi-route waterfall middlewa…

…re and added README example

README.md

@@ -119,11 +119,6 @@ addEventListener('fetch', event => event.respondWith(router.handle(event.request
 ### Multiple Route Handlers as Middleware
 ###### Note: Any of these handlers may be awaitable async functions!
 ```js
-import { Router } from 'itty-router'
-
-// create a router
-const router = Router() // note the intentional lack of "new"
-
 // withUser modifies original request, then continues without returning
 const withUser = (req) => {
   req.user = { name: 'Mittens', age: 3 }
@@ -145,6 +140,20 @@ router.handle({ url: 'https://example.com/pass/user' }) // --> STATUS 200: { nam
 router.handle({ url: 'https://example.com/fail/user' }) // --> STATUS 401: Not Authenticated
 ```
 
+### Multi-route (Upstream) Middleware
+```js
+// withUser modifies original request, then continues without returning
+const withUser = (req) => {
+  req.user = { name: 'Mittens', age: 3 }
+}
+
+router
+  .get('*', withUser) // embeds user before all other matching routes
+  .get('/user', (req) => new Response(JSON.stringify(req.user))) // user embedded already!
+
+router.handle({ url: 'https://example.com/user' }) // --> STATUS 200: { name: 'Mittens', age: 3 }
+```
+
 ## Testing & Contributing
 1. fork repo
 2. add code

package.json

@@ -1,6 +1,6 @@
 {
   "name": "itty-router",
-  "version": "0.9.6",
+  "version": "0.9.7",
   "description": "Tiny, zero-dependency router with route param and query parsing.",
   "main": "dist/itty-router.min.js",
   "files": [

src/itty-router.spec.js

@@ -135,5 +135,23 @@ describe('Router', () => {
           router.handle({ method: 'CUSTOM', url: 'https://example.com/foo' }), // no method listed
       ).not.toThrow()
     })
+
+    it('can match multiple routes if earlier handlers do not return (as middleware)', async () => {
+      const r = Router()
+
+      const middleware = req => {
+        req.user = { id: 13 }
+      }
+
+      const handler = jest.fn((req) => req.user.id)
+
+      r.get('/middleware/*', middleware)
+      r.get('/middleware/:id', handler)
+
+      await r.handle(buildRequest({ path: '/middleware/foo' }))
+
+      expect(handler).toHaveBeenCalled()
+      expect(handler).toHaveReturnedWith(13)
+    })
   })
 })