Koa.js - Form Data


Forms are an integral part of the web. Almost every website we visit offers us forms that submit or fetch some information for us. To get started with forms, we will first install the koa-body. To install this, go to your terminal and use −

$ npm install --save koa-body

Replace your app.js file contents with the following code.

var koa = require('koa');
var router = require('koa-router');
var bodyParser = require('koa-body');
var app = koa();

//Set up Pug
var Pug = require('koa-pug');
var pug = new Pug({
   viewPath: './views',
   basedir: './views',
   app: app //Equivalent to app.use(pug)

//Set up body parsing middleware
   formidable:{uploadDir: './uploads'},
   multipart: true,
   urlencoded: true

_.get('/', renderForm);
_.post('/', handleForm);

function * renderForm(){
function *handleForm(){
   this.body = this.request.body; //This is where the parsed request is stored


The new things we are doing here are importing the body parser and multer. We are using the body parser for parsing json and x-www-form-urlencoded header requests, while we use multer for parsing multipart/form-data.

Let us create a html form to test this out! Create a new view named form.pug with the following code.

      title Form Tester
      form(action = "/", method = "POST")
            label(for = "say") Say: 
            input(name = "say" value = "Hi")
            label(for = "to") To: 
            input(name = "to" value = "Koa form")
         button(type = "submit") Send my greetings

Run your server using −

nodemon index.js

Now go to localhost:3000/ and fill the form as you like, and submit it. You'll receive the response as −

Form Received

Take a look at your console, it'll show you the body of your request as a JavaScript object. For example −

Form Console

The this.request.body object contains your parsed request body. To use fields from that object, just use them as normal JS objects.

This is just one way to send a request. There are many other ways, but those are irrelevant to cover here, because our Koa app will handle all those requests in the same way. To read more about different ways to make a request, have a look at this page.