docs: consume req.body in the form of key-value pairs

[max-hk]

Checklist

• run npm run test and npm run benchmark
• tests and/or benchmarks are included
• documentation is changed or added
• commit message and code follows the Developer's Certification of Origin
  and the Code of conduct

The pull request add documentation on how to consume req.body in key-value pairs.

This may help new comers from Express.js

[mcollina]

lgtm

[max-hk]

Hi. I found that most code snippets in readme do not contain trailing semicolon.

Should I remove semicolon from my pull request, or keep it as is?

[mcollina]

thanks, that'd be best!

[max-hk]

After testing in my machine, I found that req.body.foo.value returns the value itself instead of a promise.

Maybe we should remove the await keyword?

fastify.post('/upload/files', async function (req, reply) {
  const uploadValue = await req.body.upload.toBuffer()  // access files
-  const fooValue = await req.body.foo.value           // other fields
+  const fooValue = req.body.foo.value                 // other fields
  const body = Object.fromEntries(
    Object.keys(req.body).map((key) => [key, req.body[key].value])
  ) // Request body in key-value pairs, like req.body in Express (Node 12+)
})

[mcollina]

sure thing

[mcollina]

Can you add a unit test for this? So it's sure we won't regress.

[max-hk]

Can you add a unit test for this? So it's sure we won't regress.

Is the following line enough? Should I write another test for that?

fastify-multipart/test/multipart-body-schema.test.js

Line 45 in d3790a1

t.equal(req.body.hello.value, 'world')

[mcollina]

actually it is! Landed