Missing doc about form-data parameters in controller

[JesusTheHun]

In the documentation about route parameters ( https://loopback.io/doc/en/lb4/Routes.html#parameters ) it is mentioned "form Data". However, no where we can see a use of it. And right now, I'm unable to catch any submitted data from the form.

In my case, in the sequence, the call of this.parseParams(request, route) return an array of undefined values. So obviously I'm missing something, and document it would be great !

Exemple :

export class RegistrationController {

  // stuff 

  @post('/register', {
    responses: {
      '200': {
        description: 'Registration information page',
        content: {'text/html': {schema: {type: 'string'}}},
      },
    },
  })
  create(
    @param.query.string('email') email: string,
    @param.query.string('password') password: string,
  ): Promise<string> {
    // email & password are empty
  }
}

[marioestradarosa]

Hi @JesusTheHun , the @param can use query, path and array. I will try to make a test today using post from a form and let you know.

[JesusTheHun]

Hi @marioestradarosa , have you been able to perform some tests ?

[raymondfeng]

You probably should use @requestBody to decorate the body parameter and use body.email and body.password. Something like:

create(@requestBody({
    content: {
      'application/x-www-form-urlencoded': {
        schema: {
          type: 'object',
          properties: {
            email: {
              description: 'email',
              type: 'string',
            },
            password: {
              description: 'password',
              type: 'string',
            },
          },
        },
      },
    },
  })
  body: {
    email: string;
    password: string;
  }) {
    console.log(body.email);
    return 'good';
  }

[dhmlau]

Moving it to In Progress because of PR #1838.