Using Middlewares

[mrose]

Hi, I'm new to middlewares and page based routing, and not sure I understand how they should work together.
Maybe I'm not reading the docs correctly?
If I create a folder under my routing root called 'products' and create a .middleware.ts file in the folder, should I expect the middlewares file to run only when the index page in the products folder is requested or on every page request?

[lazarv]

Hi @mrose!

.middleware.ts (starting with a dot) is only the extension of the file, so it's either middleware.ts or name.middleware.ts, where name is not affecting on which route the middleware is active, but only to help you navigate in your project and put your middleware logic in multiple files. You can use the useMatch function from @lazarv/react-server/router to check if your current pathname should be processed in the middleware. See an example in the docs app at https://github.com/lazarv/react-server/blob/main/docs/src/pages/i18n.middleware.mjs, but even the docs is proposing this approach at https://react-server.dev/router/middlewares.

I understand that this is misleading, and this feature might be reworked in the future. To use it in a future-proof manner, you can put the name of the middleware in the filename into parentheses like (i18n).middleware.ts, similar to layouts or pages.

Also worth mentioning is that your implementation should not expect the framework to process the middleware in a fixed order, especially in development mode with file changes.

So, my answer for now is that middlewares are running on each request, even on API routes!