Как разобрать тело multipart / form-data с Koa?

потому что я потратил некоторое (слишком много) времени, выясняя это простое требование. Я документирую здесь способ достижения multipart/form-data анализ тела с Koa.

в моем случае причиной путаницы было количество доступных альтернатив там:

и я хотел найти самый минималистский/вблизи express/koa/node способ / философия делать вещи.

Так вот. Под. В принятом ответе. Надеюсь, это поможет.

3 ответов


на Koa2, вы можете использовать асинхронно-помощника поскольку другие решения не поддерживают обещания или async / await.

пример из документации:

import asyncBusboy from 'async-busboy';

// Koa 2 middleware
async function(ctx, next) {
  const {files, fields} = await asyncBusboy(ctx.req);

  // Make some validation on the fields before upload to S3
  if ( checkFiles(fields) ) {
    files.map(uploadFilesToS3)
  } else {
    return 'error';
  }
}

вы должны использовать КоА-мултэр как указано в официальном Koa wiki.

таким образом, простая настройка будет выглядеть так:

const koa = require('koa');
const multer = require('koa-multer');

const app = koa();

app.use(multer());

app.use(function *() {
  this.body = this.req.body;
});

пара нот:

  • Multer будет анализировать только тела запросов типа multipart/form-data
  • обратите внимание использование this.req.body вместо Koa с наддувом this.request (не уверен, что это намеренно, но это сбивает с толку наверняка... Я бы ожидайте разбора body доступны this.request...)

и отправка этой HTML-формы как FormData:

<form>
  <input type="hidden" name="topsecret" value="1">
  <input type="text" name="area51[lat]" value="37.235065">
  <input type="text" name="area51[lng]" value="-115.811117">
  ...
</form>

даст вам доступ к вложенным свойствам, как ожидалось:

// -> console.log(this.req.body)
{
  "topsecret": 1,
  "area51": {
    "lat": "37.235065",
    "lng": "-115.811117",
  }
}

Я прошел через то же расследование, что и вы, и вот другие способы достижения multipart/form-data анализ тела с Koa.

со-официанта:

var koa = require('koa');
var parse = require('co-busboy');

const app = koa();

app.use(function* (next) {
  // the body isn't multipart, so busboy can't parse it 
  if (!this.request.is('multipart/*')) return yield next;

  var parts = parse(this),
      part,
      fields = {};
  while (part = yield parts) {
    if (part.length) {
      // arrays are busboy fields 
      console.log('key: ' + part[0]);
      console.log('value: ' + part[1]);

      fields[part[0]] = part[1];
    } else {
      // it's a stream, you can do something like:
      // part.pipe(fs.createWriteStream('some file.txt'));
    }
  }

  this.body = JSON.stringify(fields, null, 2);
})

КоА-тела:

var koa = require('koa');
var router = require('koa-router');
var koaBody = require('koa-body')({ multipart: true });

const app = koa();

app.use(router(app));

app.post('/', koaBody, function *(next) {
  console.log(this.request.body.fields);

  this.body = JSON.stringify(this.request.body, null, 2);
});

в обоих случаях вы будете иметь ответ, как:

{
  "topsecret": 1,
  "area51": {
    "lat": "37.235065",
    "lng": "-115.811117",
  }
}

но лично я предпочитаю, как работает koa-тело. Кроме того, совместим с другими middleware, как koa-validate.

кроме того, если вы укажете загрузку dir to koa-body, он сохранит загруженный файл для вас:

var koaBody = require('koa-body')({
  multipart: true,
  formidable: { uploadDir: path.join(__dirname, 'tmp') }
});