context.locals or locals? about docs

[sasoria]

Thank you for the issue, maybe we could try to keep the code examples as simple as possible and avoid destructuring?

At least in the first code example, the text above it becomes easier to understand:

Inside this file, export an onRequest() function that can be passed a context object and next() function. This must not be a default export.

export function onRequest (context, next) {
  ...
}

[Fryuni]

I don't get your point, the two pages perfectly agree with each other. Which part is confusing you?

Is it because in the Astro example context is being destructured?

[jamesli2021]

I don't get your point too.

Could you please explain the meaning of 'context' within the term 'context.locals'?

What is the difference between context.locals and just write locals?

[Fryuni]

There is no difference.

context is how the first argument of the middleware is called (the type is called APIContext). Same for API Endpoints.

// This
export const onRequest = (context, next) => {
  const locals = context.locals;
  locals.foo = 'bar';
};

// Is the same as this
export const onRequest = ({ locals }, next) => {
  locals.foo = 'bar';
};

It is just a more compact JS syntax called destructuring which can be used in many places including function parameters