@e22m4u/js-trie-router 0.7.2 → 0.7.4

package/README.md

@@ -20,6 +20,7 @@ HTTP маршрутизатор для Node.js на основе
   - [Параметры маршрутизатора](#параметры-маршрутизатора)
   - [Контекст запроса](#контекст-запроса)
   - [Отправка ответа](#отправка-ответа)
+  - [Парсинг тела запроса](#парсинг-тела-запроса)
   - [Жизненный цикл](#жизненный-цикл)
   - [Хуки маршрута](#хуки-маршрута)
   - [Глобальные хуки](#глобальные-хуки)
@@ -219,6 +220,99 @@ router.defineRoute({
 });
 ```
 
+### Парсинг тела запроса
+
+Для разбора тела входящего запроса отслеживается заголовок `Content-Type`,
+определяющий формат передаваемых данных. По умолчанию маршрутизатор включает
+парсеры для следующих форматов:
+
+- `application/json` разбирается как *JSON*;
+- `text/plain` преобразуется в строку;
+
+Если входящий запрос содержит данные, но для его формата не найден подходящий
+парсер, маршрутизатор прервет обработку запроса и вернет ошибку
+*415 Unsupported Media Type*.
+
+```json
+{
+  "error": {
+    "message": "Media type \"application/octet-stream\" is not supported."
+  }
+}
+```
+
+Чтобы избежать появления ошибки для форматов, которые предполагается
+обрабатывать особым способом, предусмотрен параметр маршрутизатора
+`ignoredMediaTypes` для игнорирования указанных медиа-типов. Параметр
+позволяет пропустить встроенный парсинг, как это сделано в примере ниже.
+
+```js
+import {TrieRouter, HttpMethod} from '@e22m4u/js-trie-router';
+
+// создание экземпляра маршрутизатора
+// с указанием исключаемых медиа-типов
+const router = new TrieRouter({
+  ignoredMediaTypes: [
+    'application/octet-stream',
+    'multipart/form-data'
+  ],
+});
+
+// регистрация маршрута для обработки файлов
+router.defineRoute({
+  method: HttpMethod.POST,
+  path: '/upload',
+  handler(ctx) {
+    // свойство body остается пустым, далее
+    // выполняется доступ к нативному потоку
+    const stream = ctx.request;
+    return 'OK';
+  }
+});
+```
+
+#### Регистрация пользовательского парсера
+
+Для расширения поддерживаемых форматов предусмотрена возможность регистрации
+пользовательской функции парсинга для определенного медиа-типа. Управление
+такими функциями выполняется сервисом `RequestBodyParser`, который доступен
+через глобальный контейнер маршрутизатора.
+
+```js
+// доступ к сервису через маршрутизатор
+const bodyParser = router.getService(RequestBodyParser);
+// bodyParser.defineParser(mediaType, parserFn); см. далее
+```
+
+Регистрируемая функция принимает извлеченные данные в виде строки и возвращает
+преобразованный результат. Итоговое значение впоследствии будет доступно
+в контексте обработки запроса.
+
+```js
+import queryString from 'querystring';
+import {TrieRouter, HttpMethod, RequestBodyParser} from '@e22m4u/js-trie-router';
+
+const router = new TrieRouter();
+const bodyParser = router.getService(RequestBodyParser);
+
+// регистрация парсера для обработки данных формы
+bodyParser.defineParser(
+  'application/x-www-form-urlencoded',
+  (input) => queryString.parse(input),
+);
+
+// определение маршрута
+router.defineRoute({
+  method: HttpMethod.POST,
+  path: '/submit',
+  handler(ctx) {
+    // свойство содержит результат
+    // работы новой парсер-функции
+    return ctx.body;
+  }
+});
+```
+
 ### Жизненный цикл
 
 Для понимания того, как маршрутизатор обрабатывает входящий запрос, ниже

package/dist/cjs/index.cjs

@@ -881,7 +881,7 @@ function patchHeaders(response) {
         );
       }
       const key = name.toLowerCase();
-      this._headers[key] = String(value);
+      this._headers[key] = Array.isArray(value) ? [...value.map(String)] : String(value);
       return this;
     }, "value")
   });
@@ -2071,12 +2071,28 @@ var _TrieRouterOptions = class _TrieRouterOptions {
    */
   _requestBodyBytesLimit = 512 * 1024;
   // 512kb
+  /**
+   * Request body bytes limit.
+   *
+   * @type {number}
+   */
+  get requestBodyBytesLimit() {
+    return this._requestBodyBytesLimit;
+  }
   /**
    * Ignored media types.
    *
    * @type {string[]}
    */
   _ignoredMediaTypes = [];
+  /**
+   * Ignored media types.
+   *
+   * @type {string[]}
+   */
+  get ignoredMediaTypes() {
+    return this._ignoredMediaTypes;
+  }
   /**
    * Constructor.
    *
@@ -2118,74 +2134,9 @@ var _TrieRouterOptions = class _TrieRouterOptions {
           this._ignoredMediaTypes.push(mediaTypeLc);
         }
       });
+      Object.freeze(this._ignoredMediaTypes);
     }
   }
-  /**
-   * Get request body bytes limit.
-   *
-   * @param {number} limit
-   * @returns {this}
-   */
-  setRequestBodyBytesLimit(limit) {
-    if (typeof limit !== "number" || limit < 0) {
-      throw new import_js_format18.InvalidArgumentError(
-        'Parameter "limit" must be a positive Number or 0, but %v was given.',
-        limit
-      );
-    }
-    this._requestBodyBytesLimit = limit;
-    return this;
-  }
-  /**
-   * Get request body bytes limit.
-   *
-   * @returns {number}
-   */
-  getRequestBodyBytesLimit() {
-    return this._requestBodyBytesLimit;
-  }
-  /**
-   * Get ignored media types.
-   *
-   * @param {string} mediaType
-   * @returns {this}
-   */
-  addIgnoredMediaType(mediaType) {
-    if (!mediaType || typeof mediaType !== "string") {
-      throw new import_js_format18.InvalidArgumentError(
-        'Parameter "mediaType" must be a non-empty String, but %v was given.',
-        mediaType
-      );
-    }
-    const mediaTypeLc = mediaType.toLowerCase();
-    if (!this._ignoredMediaTypes.includes(mediaTypeLc)) {
-      this._ignoredMediaTypes.push(mediaTypeLc);
-    }
-    return this;
-  }
-  /**
-   * Has ignored media type.
-   *
-   * @param {string} mediaType
-   * @returns {boolean}
-   */
-  hasIgnoredMediaType(mediaType) {
-    if (!mediaType || typeof mediaType !== "string") {
-      throw new import_js_format18.InvalidArgumentError(
-        'Parameter "mediaType" must be a non-empty String, but %v was given.',
-        mediaType
-      );
-    }
-    return this._ignoredMediaTypes.includes(mediaType.toLowerCase());
-  }
-  /**
-   * Get ignored media types.
-   *
-   * @returns {string[]}
-   */
-  getIgnoredMediaTypes() {
-    return this._ignoredMediaTypes.slice();
-  }
 };
 __name(_TrieRouterOptions, "TrieRouterOptions");
 var TrieRouterOptions = _TrieRouterOptions;
@@ -2205,23 +2156,23 @@ var _RequestBodyParser = class _RequestBodyParser extends DebuggableService {
    * Set parser.
    *
    * @param {string} mediaType
-   * @param {Function} parser
+   * @param {Function} parserFn
    * @returns {this}
    */
-  defineParser(mediaType, parser) {
+  defineParser(mediaType, parserFn) {
     if (!mediaType || typeof mediaType !== "string") {
       throw new import_js_format19.InvalidArgumentError(
         'Parameter "mediaType" must be a non-empty String, but %v was given.',
         mediaType
       );
     }
-    if (!parser || typeof parser !== "function") {
+    if (!parserFn || typeof parserFn !== "function") {
       throw new import_js_format19.InvalidArgumentError(
-        'Parameter "parser" must be a Function, but %v was given.',
-        parser
+        'Parameter "parserFn" must be a Function, but %v was given.',
+        parserFn
       );
     }
-    this._parsers[mediaType.toLowerCase()] = parser;
+    this._parsers[mediaType.toLowerCase()] = parserFn;
     return this;
   }
   /**
@@ -2252,14 +2203,14 @@ var _RequestBodyParser = class _RequestBodyParser extends DebuggableService {
         mediaType
       );
     }
-    const parser = this._parsers[mediaType.toLowerCase()];
-    if (!parser) {
+    const parserFn = this._parsers[mediaType.toLowerCase()];
+    if (!parserFn) {
       throw new import_js_format19.InvalidArgumentError(
         "Media type %v does not have a parser.",
         mediaType
       );
     }
-    return parser;
+    return parserFn;
   }
   /**
    * Remove parser.
@@ -2307,26 +2258,27 @@ var _RequestBodyParser = class _RequestBodyParser extends DebuggableService {
       );
     }
     const options = this.getService(TrieRouterOptions);
-    const isMediaTypeIgnored = options.hasIgnoredMediaType(mediaType);
+    const mediaTypeLc = mediaType.toLowerCase();
+    const isMediaTypeIgnored = options.ignoredMediaTypes.includes(mediaTypeLc);
     if (isMediaTypeIgnored) {
       debug("Media type %v is ignored.", mediaType);
       return;
     }
-    const parser = this._parsers[mediaType.toLowerCase()];
-    if (!parser) {
+    const parserFn = this._parsers[mediaTypeLc];
+    if (!parserFn) {
       throw createError(
         import_http_errors2.default.UnsupportedMediaType,
         "Media type %v is not supported.",
         mediaType
       );
     }
-    const bodyBytesLimit = options.getRequestBodyBytesLimit();
+    const bodyBytesLimit = options.requestBodyBytesLimit;
     debug("Fetching a request body.");
     debug("Body limit is %v bytes.", bodyBytesLimit);
     return fetchRequestBody(request, bodyBytesLimit).then((rawBody) => {
       if (rawBody != null) {
         debug("Read %v bytes.", Buffer.byteLength(rawBody, "utf8"));
-        return parser(rawBody);
+        return parserFn(rawBody);
       }
       debug("Request body has no content.");
       return rawBody;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@e22m4u/js-trie-router",
-  "version": "0.7.2",
+  "version": "0.7.4",
   "description": "HTTP маршрутизатор для Node.js на основе префиксного дерева",
   "author": "Mikhail Evstropov <e22m4u@yandex.ru>",
   "license": "MIT",

package/src/parsers/request-body-parser.d.ts

@@ -15,9 +15,9 @@ export declare class RequestBodyParser extends DebuggableService {
    * Define parser.
    *
    * @param mediaType
-   * @param parser
+   * @param parserFn
    */
-  defineParser(mediaType: string, parser: BodyParserFunction): this;
+  defineParser(mediaType: string, parserFn: BodyParserFunction): this;
 
   /**
    * Has parser.

package/src/parsers/request-body-parser.js

@@ -29,10 +29,10 @@ export class RequestBodyParser extends DebuggableService {
    * Set parser.
    *
    * @param {string} mediaType
-   * @param {Function} parser
+   * @param {Function} parserFn
    * @returns {this}
    */
-  defineParser(mediaType, parser) {
+  defineParser(mediaType, parserFn) {
     if (!mediaType || typeof mediaType !== 'string') {
       throw new InvalidArgumentError(
         'Parameter "mediaType" must be a non-empty String, ' +
@@ -40,13 +40,13 @@ export class RequestBodyParser extends DebuggableService {
         mediaType,
       );
     }
-    if (!parser || typeof parser !== 'function') {
+    if (!parserFn || typeof parserFn !== 'function') {
       throw new InvalidArgumentError(
-        'Parameter "parser" must be a Function, but %v was given.',
-        parser,
+        'Parameter "parserFn" must be a Function, but %v was given.',
+        parserFn,
       );
     }
-    this._parsers[mediaType.toLowerCase()] = parser;
+    this._parsers[mediaType.toLowerCase()] = parserFn;
     return this;
   }
 
@@ -81,14 +81,14 @@ export class RequestBodyParser extends DebuggableService {
         mediaType,
       );
     }
-    const parser = this._parsers[mediaType.toLowerCase()];
-    if (!parser) {
+    const parserFn = this._parsers[mediaType.toLowerCase()];
+    if (!parserFn) {
       throw new InvalidArgumentError(
         'Media type %v does not have a parser.',
         mediaType,
       );
     }
-    return parser;
+    return parserFn;
   }
 
   /**
@@ -147,15 +147,16 @@ export class RequestBodyParser extends DebuggableService {
     // если текущий медиа тип исключен
     // настройками, то парсинг пропускается
     const options = this.getService(TrieRouterOptions);
-    const isMediaTypeIgnored = options.hasIgnoredMediaType(mediaType);
+    const mediaTypeLc = mediaType.toLowerCase();
+    const isMediaTypeIgnored = options.ignoredMediaTypes.includes(mediaTypeLc);
     if (isMediaTypeIgnored) {
       debug('Media type %v is ignored.', mediaType);
       return;
     }
     // если парсер для текущего медиа типа
     // не определен, то выбрасывается ошибка
-    const parser = this._parsers[mediaType.toLowerCase()];
-    if (!parser) {
+    const parserFn = this._parsers[mediaTypeLc];
+    if (!parserFn) {
       throw createError(
         HttpErrors.UnsupportedMediaType,
         'Media type %v is not supported.',
@@ -164,7 +165,7 @@ export class RequestBodyParser extends DebuggableService {
     }
     // определение максимального количества
     // байт, извлекаемых из тела запроса
-    const bodyBytesLimit = options.getRequestBodyBytesLimit();
+    const bodyBytesLimit = options.requestBodyBytesLimit;
     debug('Fetching a request body.');
     debug('Body limit is %v bytes.', bodyBytesLimit);
     // извлечение тела запроса для последующего
@@ -172,7 +173,7 @@ export class RequestBodyParser extends DebuggableService {
     return fetchRequestBody(request, bodyBytesLimit).then(rawBody => {
       if (rawBody != null) {
         debug('Read %v bytes.', Buffer.byteLength(rawBody, 'utf8'));
-        return parser(rawBody);
+        return parserFn(rawBody);
       }
       debug('Request body has no content.');
       return rawBody;

package/src/parsers/request-body-parser.spec.js

@@ -30,11 +30,11 @@ describe('RequestBodyParser', function () {
       throwable('text/plain')();
     });
 
-    it('should require the parameter "parser" to be a Function', function () {
+    it('should require the parameter "parserFn" to be a Function', function () {
       const S = new RequestBodyParser();
       const throwable = v => () => S.defineParser('str', v);
       const error = v =>
-        format('Parameter "parser" must be a Function, but %s was given.', v);
+        format('Parameter "parserFn" must be a Function, but %s was given.', v);
       expect(throwable('str')).to.throw(error('"str"'));
       expect(throwable('')).to.throw(error('""'));
       expect(throwable(10)).to.throw(error('10'));

package/src/trie-router-options.d.ts

@@ -11,33 +11,19 @@ export type TrieRouterOptionsInput = {
  */
 export declare class TrieRouterOptions {
   /**
-   * Get request body bytes limit.
-   *
-   * @param limit
-   */
-  setRequestBodyBytesLimit(limit: number): this;
-
-  /**
-   * Get request body bytes limit.
+   * Request body bytes limit.
    */
-  getRequestBodyBytesLimit(): number;
+  get requestBodyBytesLimit(): number;
 
   /**
-   * Get ignored media types.
-   *
-   * @param mediaType
+   * Request body bytes limit.
    */
-  addIgnoredMediaType(mediaType: string): this;
+  get ignoredMediaTypes(): string[];
 
   /**
-   * Has ignored media type.
+   * Constructor.
    *
-   * @param mediaType
-   */
-  hasIgnoredMediaType(mediaType: string): boolean;
-
-  /**
-   * Get ignored media types.
+   * @param options
    */
-  getIgnoredMediaTypes(): string[];
+  constructor(options?: TrieRouterOptionsInput);
 }

package/src/trie-router-options.js

@@ -11,6 +11,15 @@ export class TrieRouterOptions {
    */
   _requestBodyBytesLimit = 512 * 1024; // 512kb
 
+  /**
+   * Request body bytes limit.
+   *
+   * @type {number}
+   */
+  get requestBodyBytesLimit() {
+    return this._requestBodyBytesLimit;
+  }
+
   /**
    * Ignored media types.
    *
@@ -18,6 +27,15 @@ export class TrieRouterOptions {
    */
   _ignoredMediaTypes = [];
 
+  /**
+   * Ignored media types.
+   *
+   * @type {string[]}
+   */
+  get ignoredMediaTypes() {
+    return this._ignoredMediaTypes;
+  }
+
   /**
    * Constructor.
    *
@@ -66,77 +84,7 @@ export class TrieRouterOptions {
           this._ignoredMediaTypes.push(mediaTypeLc);
         }
       });
+      Object.freeze(this._ignoredMediaTypes);
     }
   }
-
-  /**
-   * Get request body bytes limit.
-   *
-   * @param {number} limit
-   * @returns {this}
-   */
-  setRequestBodyBytesLimit(limit) {
-    if (typeof limit !== 'number' || limit < 0) {
-      throw new InvalidArgumentError(
-        'Parameter "limit" must be a positive Number or 0, but %v was given.',
-        limit,
-      );
-    }
-    this._requestBodyBytesLimit = limit;
-    return this;
-  }
-
-  /**
-   * Get request body bytes limit.
-   *
-   * @returns {number}
-   */
-  getRequestBodyBytesLimit() {
-    return this._requestBodyBytesLimit;
-  }
-
-  /**
-   * Get ignored media types.
-   *
-   * @param {string} mediaType
-   * @returns {this}
-   */
-  addIgnoredMediaType(mediaType) {
-    if (!mediaType || typeof mediaType !== 'string') {
-      throw new InvalidArgumentError(
-        'Parameter "mediaType" must be a non-empty String, but %v was given.',
-        mediaType,
-      );
-    }
-    const mediaTypeLc = mediaType.toLowerCase();
-    if (!this._ignoredMediaTypes.includes(mediaTypeLc)) {
-      this._ignoredMediaTypes.push(mediaTypeLc);
-    }
-    return this;
-  }
-
-  /**
-   * Has ignored media type.
-   *
-   * @param {string} mediaType
-   * @returns {boolean}
-   */
-  hasIgnoredMediaType(mediaType) {
-    if (!mediaType || typeof mediaType !== 'string') {
-      throw new InvalidArgumentError(
-        'Parameter "mediaType" must be a non-empty String, but %v was given.',
-        mediaType,
-      );
-    }
-    return this._ignoredMediaTypes.includes(mediaType.toLowerCase());
-  }
-
-  /**
-   * Get ignored media types.
-   *
-   * @returns {string[]}
-   */
-  getIgnoredMediaTypes() {
-    return this._ignoredMediaTypes.slice();
-  }
 }

package/src/trie-router-options.spec.js

@@ -87,210 +87,31 @@ describe('TrieRouterOptions', function () {
     it('should set the option "requestBodyBytesLimit" to the current instance', function () {
       const value = 10;
       const inst = new TrieRouterOptions({requestBodyBytesLimit: value});
-      expect(inst.getRequestBodyBytesLimit()).to.be.eq(value);
+      expect(inst.requestBodyBytesLimit).to.be.eq(value);
     });
 
     it('should add elements of the option "ignoredMediaTypes" to the current instance', function () {
       const value = ['text/plain', 'text/html'];
       const inst = new TrieRouterOptions({ignoredMediaTypes: value});
-      expect(inst.getIgnoredMediaTypes()).to.include(value[0]);
-      expect(inst.getIgnoredMediaTypes()).to.include(value[1]);
+      expect(inst.ignoredMediaTypes).to.be.eql(['text/plain', 'text/html']);
     });
 
     it('should add elements of the option "ignoredMediaTypes" without duplicates', function () {
       const value = ['text/plain', 'text/html', 'text/plain'];
       const inst = new TrieRouterOptions({ignoredMediaTypes: value});
-      expect(inst.getIgnoredMediaTypes()).to.be.eql([
-        'text/plain',
-        'text/html',
-      ]);
+      expect(inst.ignoredMediaTypes).to.be.eql(['text/plain', 'text/html']);
     });
 
-    it('should convert ignored media types to lower case', function () {
-      const inst = new TrieRouterOptions({ignoredMediaTypes: ['TEXT/PLAIN']});
-      expect(inst.getIgnoredMediaTypes()).to.be.eql(['text/plain']);
-    });
-  });
-
-  describe('setRequestBodyBytesLimit', function () {
-    it('should require the parameter "value" to be a positive number or zero', function () {
-      const throwable = v => () => {
-        const S = new TrieRouterOptions();
-        S.setRequestBodyBytesLimit(v);
-      };
-      const error = s =>
-        format(
-          'Parameter "limit" must be a positive Number or 0, but %s was given.',
-          s,
-        );
-      expect(throwable('str')).to.throw(error('"str"'));
-      expect(throwable('')).to.throw(error('""'));
-      expect(throwable(-1)).to.throw(error('-1'));
-      expect(throwable(true)).to.throw(error('true'));
-      expect(throwable(false)).to.throw(error('false'));
-      expect(throwable([])).to.throw(error('Array'));
-      expect(throwable({})).to.throw(error('Object'));
-      expect(throwable(undefined)).to.throw(error('undefined'));
-      expect(throwable(null)).to.throw(error('null'));
-      throwable(10)();
-      throwable(0)();
-    });
-
-    it('should set the option value to the current instance', function () {
-      const S = new TrieRouterOptions();
-      const customValue = 10;
-      S.setRequestBodyBytesLimit(customValue);
-      const res = S.getRequestBodyBytesLimit();
-      expect(res).to.be.eq(customValue);
-    });
-
-    it('should return the current instance to allow chaining', function () {
-      const S = new TrieRouterOptions();
-      const res = S.setRequestBodyBytesLimit(10);
-      expect(res).to.be.eq(S);
-    });
-  });
-
-  describe('getRequestBodyBytesLimit', function () {
-    it('should return a default value when the option is not specified', function () {
-      const defaultValue = 512 * 1024; // 512kb
-      const inst = new TrieRouterOptions();
-      expect(inst.getRequestBodyBytesLimit()).to.be.eq(defaultValue);
-    });
-
-    it('should return a value specified in the constructor', function () {
-      const customValue = 10;
-      const inst = new TrieRouterOptions({requestBodyBytesLimit: customValue});
-      expect(inst.getRequestBodyBytesLimit()).to.be.eq(customValue);
-    });
-  });
-
-  describe('addIgnoredMediaType', function () {
-    it('should require the parameter "mediaType" to be a non-empty String', function () {
-      const throwable = v => () => {
-        const S = new TrieRouterOptions();
-        S.addIgnoredMediaType(v);
-      };
-      const error = s =>
-        format(
-          'Parameter "mediaType" must be a non-empty String, ' +
-            'but %s was given.',
-          s,
-        );
-      expect(throwable('')).to.throw(error('""'));
-      expect(throwable(10)).to.throw(error('10'));
-      expect(throwable(0)).to.throw(error('0'));
-      expect(throwable(true)).to.throw(error('true'));
-      expect(throwable(false)).to.throw(error('false'));
-      expect(throwable([])).to.throw(error('Array'));
-      expect(throwable({})).to.throw(error('Object'));
-      expect(throwable(undefined)).to.throw(error('undefined'));
-      expect(throwable(null)).to.throw(error('null'));
-      throwable('text/plain')();
-    });
-
-    it('should add an ignored media type to the current instance', function () {
-      const S = new TrieRouterOptions();
-      const mediaType = 'text/plain';
-      expect(S.hasIgnoredMediaType(mediaType)).to.be.false;
-      S.addIgnoredMediaType(mediaType);
-      expect(S.hasIgnoredMediaType(mediaType)).to.be.true;
-    });
-
-    it('should return the current instance to allow chaining', function () {
-      const S = new TrieRouterOptions();
-      const res = S.addIgnoredMediaType('text/plain');
-      expect(res).to.be.eq(S);
-    });
-  });
-
-  describe('hasIgnoredMediaType', function () {
-    it('should require the parameter "mediaType" to be a non-empty String', function () {
-      const throwable = v => () => {
-        const S = new TrieRouterOptions();
-        S.hasIgnoredMediaType(v);
-      };
-      const error = s =>
-        format(
-          'Parameter "mediaType" must be a non-empty String, ' +
-            'but %s was given.',
-          s,
-        );
-      expect(throwable('')).to.throw(error('""'));
-      expect(throwable(10)).to.throw(error('10'));
-      expect(throwable(0)).to.throw(error('0'));
-      expect(throwable(true)).to.throw(error('true'));
-      expect(throwable(false)).to.throw(error('false'));
-      expect(throwable([])).to.throw(error('Array'));
-      expect(throwable({})).to.throw(error('Object'));
-      expect(throwable(undefined)).to.throw(error('undefined'));
-      expect(throwable(null)).to.throw(error('null'));
-      throwable('text/plain')();
-    });
-
-    it('should return true when the given type is registered', function () {
-      const S = new TrieRouterOptions();
-      const mediaType = 'text/plain';
-      expect(S.hasIgnoredMediaType(mediaType)).to.be.false;
-      S.addIgnoredMediaType(mediaType);
-      expect(S.hasIgnoredMediaType(mediaType)).to.be.true;
-    });
-
-    it('should lookup the media type in case-insensitive mode', function () {
-      const S = new TrieRouterOptions();
-      S.addIgnoredMediaType('TeXt/PlAiN');
-      expect(S.hasIgnoredMediaType('tExT/pLaIn')).to.be.true;
-    });
-
-    it('should not add duplicates even with different cases', function () {
-      const S = new TrieRouterOptions();
-      S.addIgnoredMediaType('text/plain');
-      S.addIgnoredMediaType('TEXT/PLAIN');
-      S.addIgnoredMediaType('text/plain');
-      const res = S.getIgnoredMediaTypes();
-      expect(res).to.have.lengthOf(1);
-      expect(res[0]).to.be.eq('text/plain');
-    });
-  });
-
-  describe('getIgnoredMediaTypes', function () {
-    it('should return media types specified in the constructor', function () {
-      const mediaTypes = ['text/plain', 'text/html'];
-      const S = new TrieRouterOptions({ignoredMediaTypes: mediaTypes});
-      const res = S.getIgnoredMediaTypes();
-      expect(res).to.be.eql(mediaTypes);
-    });
-
-    it('should return media types added by the "addIgnoredMediaType" method', function () {
-      const mediaTypes = ['text/plain', 'text/html'];
-      const S = new TrieRouterOptions();
-      S.addIgnoredMediaType(mediaTypes[0]);
-      S.addIgnoredMediaType(mediaTypes[1]);
-      const res = S.getIgnoredMediaTypes();
-      expect(res).to.be.eql(mediaTypes);
-    });
-
-    it('should combine media types specified by the constructor and the "addIgnoredMediaType" method', function () {
+    it('should freeze the option "ignoredMediaTypes" to prevent mutations', function () {
       const mediaTypes = ['text/plain', 'text/html'];
-      const S = new TrieRouterOptions({ignoredMediaTypes: [mediaTypes[0]]});
-      S.addIgnoredMediaType(mediaTypes[1]);
-      const res = S.getIgnoredMediaTypes();
-      expect(res).to.be.eql(mediaTypes);
+      const inst = new TrieRouterOptions({ignoredMediaTypes: mediaTypes});
+      const res = inst.ignoredMediaTypes;
+      expect(Object.isFrozen(res)).to.be.true;
     });
 
-    it('should return a clone of the media type list that prevents mutate the state', function () {
-      const mediaTypes = ['text/plain', 'text/html'];
-      const S = new TrieRouterOptions();
-      S.addIgnoredMediaType(mediaTypes[0]);
-      S.addIgnoredMediaType(mediaTypes[1]);
-      const res1 = S.getIgnoredMediaTypes();
-      const res2 = S.getIgnoredMediaTypes();
-      expect(res1).to.be.eql(mediaTypes);
-      expect(res2).to.be.eql(mediaTypes);
-      expect(res1).to.be.not.eq(res2);
-      res1[0] = '123';
-      const res3 = S.getIgnoredMediaTypes();
-      expect(res3).to.be.eql(mediaTypes);
+    it('should convert ignored media types to lower case', function () {
+      const inst = new TrieRouterOptions({ignoredMediaTypes: ['TEXT/PLAIN']});
+      expect(inst.ignoredMediaTypes).to.be.eql(['text/plain']);
     });
   });
 });

package/src/trie-router.spec.js

@@ -28,7 +28,7 @@ describe('TrieRouter', function () {
       const optionsInput = {requestBodyBytesLimit: 10};
       const router = new TrieRouter(optionsInput);
       const options = router.getService(TrieRouterOptions);
-      expect(options.getRequestBodyBytesLimit()).to.be.eq(10);
+      expect(options.requestBodyBytesLimit).to.be.eq(10);
     });
 
     it('should use the service container and the router options from parameters', function () {
@@ -37,7 +37,7 @@ describe('TrieRouter', function () {
       const router = new TrieRouter(container, optionsInput);
       const options = router.getService(TrieRouterOptions);
       expect(router.container).to.be.eq(container);
-      expect(options.getRequestBodyBytesLimit()).to.be.eq(10);
+      expect(options.requestBodyBytesLimit).to.be.eq(10);
     });
   });
 

package/src/utils/create-response-mock.js

@@ -72,7 +72,9 @@ function patchHeaders(response) {
         );
       }
       const key = name.toLowerCase();
-      this._headers[key] = String(value);
+      this._headers[key] = Array.isArray(value)
+        ? [...value.map(String)]
+        : String(value);
       return this;
     },
   });

package/src/utils/create-response-mock.spec.js

@@ -79,6 +79,22 @@ describe('createResponseMock', function () {
       expect(ret).to.be.eq(res);
       expect(res._headers['num']).to.be.eq('10');
     });
+
+    it('should not stringify an array value', function () {
+      const res = createResponseMock();
+      expect(res._headers['key']).to.be.eq(undefined);
+      const ret = res.setHeader('key', ['foo', 'bar']);
+      expect(ret).to.be.eq(res);
+      expect(res._headers['key']).to.be.eql(['foo', 'bar']);
+    });
+
+    it('should stringify an array elements', function () {
+      const res = createResponseMock();
+      expect(res._headers['key']).to.be.eq(undefined);
+      const ret = res.setHeader('key', [1, 2]);
+      expect(ret).to.be.eq(res);
+      expect(res._headers['key']).to.be.eql(['1', '2']);
+    });
   });
 
   describe('getHeader', function () {