feature: allowEmptyValue controls (#4788)

* add baseline tests

* coerce empty strings to null when updating parameter values

* add ParameterIncludeEmpty

* add redux management for empty parameter value inclusion state

* use name+in keying for state management instead of hash keying

* update new redux method usages to name+in keying

* coerce empty Immutable iterables in onChangeWrapper

* OAS3 tests & support

* add included empty parameters to requests before dispatching to Swagger Client

* make empty inclusion interface prettier

* add tests for #4587

* linter fixes

* check for truthy value before reaching into property

test/core/plugins/spec/actions.js

@@ -1,7 +1,7 @@
 /* eslint-env mocha */
 import expect, { createSpy } from "expect"
 import { fromJS } from "immutable"
-import { execute, executeRequest, changeParamByIdentity } from "corePlugins/spec/actions"
+import { execute, executeRequest, changeParamByIdentity, updateEmptyParamInclusion } from "corePlugins/spec/actions"
 
 describe("spec plugin - actions", function(){
 
@@ -207,4 +207,22 @@ describe("spec plugin - actions", function(){
       })
     })
   })
+
+  describe("updateEmptyParamInclusion", function () {
+    it("should map its arguments to a payload", function () {
+      const pathMethod = ["/one", "get"]
+
+      const result = updateEmptyParamInclusion(pathMethod, "param", "query", true)
+
+      expect(result).toEqual({
+        type: "spec_update_empty_param_inclusion",
+        payload: {
+          pathMethod,
+          paramName: "param",
+          paramIn: "query",
+          includeEmptyValue: true
+        }
+      })
+    })
+  })
 })

test/core/plugins/spec/reducer.js

@@ -178,4 +178,26 @@ describe("spec plugin - reducer", function(){
       expect(value).toEqual(`{ "a": 123 }`)
     })
   })
+  describe("SPEC_UPDATE_EMPTY_PARAM_INCLUSION", function() {
+    it("should store parameter values by name+in", () => {
+      const updateParam = reducer["spec_update_empty_param_inclusion"]
+
+      const path = "/pet/post"
+      const method = "POST"
+
+      const state = fromJS({})
+
+      const result = updateParam(state, {
+        payload: {
+          pathMethod: [path, method],
+          paramName: "param",
+          paramIn: "query",
+          includeEmptyValue: true
+        }
+      })
+
+      const response = result.getIn(["meta", "paths", path, method, "parameter_inclusions", "param.query"])
+      expect(response).toEqual(true)
+    })
+  })
 })

test/core/plugins/spec/selectors.js

@@ -14,7 +14,8 @@ import Petstore from "./assets/petstore.json"
 import {
   operationWithMeta,
   parameterWithMeta,
-  parameterWithMetaByIdentity
+  parameterWithMetaByIdentity,
+  parameterInclusionSettingFor
 } from "../../../../src/core/plugins/spec/selectors"
 
 describe("spec plugin - selectors", function(){
@@ -712,4 +713,42 @@ describe("spec plugin - selectors", function(){
       })
     })
   })
+  describe("parameterInclusionSettingFor", function() {
+    it("should support getting name+in param inclusion settings", function () {
+      const param = fromJS({
+        name: "param",
+        in: "query",
+        allowEmptyValue: true
+      })
+
+      const state = fromJS({
+        json: {
+          paths: {
+            "/": {
+              "get": {
+                parameters: [
+                  param
+                ]
+              }
+            }
+          }
+        },
+        meta: {
+          paths: {
+            "/": {
+              "get": {
+                "parameter_inclusions": {
+                  [`param.query`]: true
+                }
+              }
+            }
+          }
+        }
+      })
+
+      const result = parameterInclusionSettingFor(state, ["/", "get"], "param", "query")
+
+      expect(result).toEqual(true)
+    })
+  })
 })

test/e2e/scenarios/bugs/4587.js

@@ -0,0 +1,36 @@
+describe("bug #4587: clearing header param values", function () {
+  let mainPage
+  beforeEach(function (client, done) {
+    mainPage = client
+      .url("localhost:3230")
+      .page.main()
+
+    client.waitForElementVisible(".download-url-input:not([disabled])", 5000)
+      .pause(2000)
+      .clearValue(".download-url-input")
+      .setValue(".download-url-input", "http://localhost:3230/test-specs/bugs/4587.yaml")
+      .click("button.download-url-button")
+      .pause(1000)
+
+    done()
+  })
+
+  afterEach(function (client, done) {
+    done()
+  })
+
+  it("sets a required initial value based the first enum value", function (client) {
+    client.waitForElementVisible(".opblock-tag-section", 10000)
+    .click("#operations-sql-execSql")
+    .waitForElementVisible(".opblock.is-open", 5000)
+      .click("button.btn.try-out__btn")
+      .setValue(`tr[data-param-name="x-irest-conn"] input`, "hi")
+      .click("button.btn.execute")
+      .waitForElementVisible(".request-url", 2000)
+      .setValue(`tr[data-param-name="x-irest-conn"] input`, `\u0008\u0008\u0008`) // backspaces
+      .pause(900)
+      .click("button.btn.execute")
+      .expect.element("textarea.curl").text
+      .to.not.contain(`x-irest-conn`)
+  })
+})

test/e2e/scenarios/features/allow-empty-value.openapi.js

@@ -0,0 +1,433 @@
+describe("feature: OpenAPI 3 allowEmptyValue", function () {
+  beforeEach(function (client, done) {
+    client
+      .url("localhost:3230")
+      .page.main()
+
+    client.waitForElementVisible(".download-url-input:not([disabled])", 5000)
+      .clearValue(".download-url-input")
+      .setValue(".download-url-input", "/test-specs/features/allow-empty-value.openapi.yaml")
+      .click("button.download-url-button")
+      .waitForElementVisible(".opblock", 10000)
+
+    done()
+  })
+
+  afterEach(function (client, done) {
+    done()
+  })
+
+  describe("regular parameters", function () {
+    it("should set and unset an integer value", function (client) {
+      const inputSelector = `tr[data-param-name="int"] input`
+
+      client // open try-it-out
+        .click("#operations-default-get_regularParams")
+        .waitForElementVisible("button.btn.try-out__btn", 5000)
+        .click("button.btn.try-out__btn")
+        .pause(200)
+
+      client // set parameter, to ensure an initial value is set
+        .setValue(inputSelector, "123")
+        .click("button.btn.execute.opblock-control__btn")
+        .pause(200)
+
+      client // remove initial value, execute again
+        .setValue(inputSelector, "\u0008\u0008\u0008") // backspaces
+        .pause(200)
+        .click("button.btn.execute.opblock-control__btn")
+        .expect.element("textarea.curl").text
+        .to.contain(`GET "http://localhost:3230/regularParams"`)
+    })
+    it("should set and unset a string value", function (client) {
+      const inputSelector = `tr[data-param-name="str"] input`
+
+      client // open try-it-out
+        .click("#operations-default-get_regularParams")
+        .waitForElementVisible("button.btn.try-out__btn", 5000)
+        .click("button.btn.try-out__btn")
+        .pause(200)
+
+      client // set parameter, to ensure an initial value is set
+        .setValue(inputSelector, "123")
+        .click("button.btn.execute.opblock-control__btn")
+        .pause(200)
+
+      client // remove initial value, execute again
+        .setValue(inputSelector, "\u0008\u0008\u0008") // backspaces
+        .pause(200)
+        .click("button.btn.execute.opblock-control__btn")
+        .expect.element("textarea.curl").text
+        .to.contain(`GET "http://localhost:3230/regularParams"`)
+    })
+    it("should set and unset a number value", function (client) {
+      const inputSelector = `tr[data-param-name="num"] input`
+
+      client // open try-it-out
+        .click("#operations-default-get_regularParams")
+        .waitForElementVisible("button.btn.try-out__btn", 5000)
+        .click("button.btn.try-out__btn")
+        .pause(200)
+
+      client // set parameter, to ensure an initial value is set
+        .setValue(inputSelector, "123")
+        .click("button.btn.execute.opblock-control__btn")
+        .pause(200)
+
+      client // remove initial value, execute again
+        .setValue(inputSelector, "\u0008\u0008\u0008") // backspaces
+        .pause(200)
+        .click("button.btn.execute.opblock-control__btn")
+        .expect.element("textarea.curl").text
+        .to.contain(`GET "http://localhost:3230/regularParams"`)
+    })
+    it("should set and unset a boolean value", function (client) {
+      const inputSelector = `tr[data-param-name="bool"] select`
+
+      client // open try-it-out
+        .click("#operations-default-get_regularParams")
+        .waitForElementVisible("button.btn.try-out__btn", 5000)
+        .click("button.btn.try-out__btn")
+        .pause(200)
+
+      client // set parameter, to ensure an initial value is set
+        .click(`${inputSelector} [value="true"]`)
+        .click("button.btn.execute.opblock-control__btn")
+        .pause(200)
+
+      client // remove initial value, execute again
+        .click(`${inputSelector} [value=""]`)
+        .pause(200)
+        .click("button.btn.execute.opblock-control__btn")
+        .expect.element("textarea.curl").text
+        .to.contain(`GET "http://localhost:3230/regularParams"`)
+    })
+    it("should set and unset an array value", function (client) {
+      const inputSelector = `tr[data-param-name="arr"]`
+
+      client // open try-it-out
+        .click("#operations-default-get_regularParams")
+        .waitForElementVisible("button.btn.try-out__btn", 5000)
+        .click("button.btn.try-out__btn")
+        .pause(200)
+
+      client // set parameter, to ensure an initial value is set
+        .click(`${inputSelector} .json-schema-form-item-add`)
+        .setValue(`${inputSelector} input`, "asdf")
+        .click("button.btn.execute.opblock-control__btn")
+        .pause(200)
+
+      client // remove initial value, execute again
+        .click(`${inputSelector} .json-schema-form-item-remove`)
+        .pause(200)
+        .click("button.btn.execute.opblock-control__btn")
+        .expect.element("textarea.curl").text
+        .to.contain(`GET "http://localhost:3230/regularParams"`)
+    })
+  })
+
+  describe("allowEmptyValue parameters", function () {
+    describe("normal behavior", function () {
+      it("should set and unset an integer value", function (client) {
+        const inputSelector = `tr[data-param-name="int"] input`
+
+        client // open try-it-out
+          .click("#operations-default-get_emptyValueParams")
+          .waitForElementVisible("button.btn.try-out__btn", 5000)
+          .click("button.btn.try-out__btn")
+          .pause(200)
+
+        client // set parameter, to ensure an initial value is set
+          .setValue(inputSelector, "123")
+          .click("button.btn.execute.opblock-control__btn")
+          .pause(200)
+
+        client // remove initial value, execute again
+          .setValue(inputSelector, "\u0008\u0008\u0008") // backspaces
+          .pause(200)
+          .click("button.btn.execute.opblock-control__btn")
+          .expect.element("textarea.curl").text
+          .to.contain(`GET "http://localhost:3230/emptyValueParams"`)
+      })
+      it("should set and unset a string value", function (client) {
+        const inputSelector = `tr[data-param-name="str"] input`
+
+        client // open try-it-out
+          .click("#operations-default-get_emptyValueParams")
+          .waitForElementVisible("button.btn.try-out__btn", 5000)
+          .click("button.btn.try-out__btn")
+          .pause(200)
+
+        client // set parameter, to ensure an initial value is set
+          .setValue(inputSelector, "123")
+          .click("button.btn.execute.opblock-control__btn")
+          .pause(200)
+
+        client // remove initial value, execute again
+          .setValue(inputSelector, "\u0008\u0008\u0008") // backspaces
+          .pause(200)
+          .click("button.btn.execute.opblock-control__btn")
+          .expect.element("textarea.curl").text
+          .to.contain(`GET "http://localhost:3230/emptyValueParams"`)
+      })
+      it("should set and unset a number value", function (client) {
+        const inputSelector = `tr[data-param-name="num"] input`
+
+        client // open try-it-out
+          .click("#operations-default-get_emptyValueParams")
+          .waitForElementVisible("button.btn.try-out__btn", 5000)
+          .click("button.btn.try-out__btn")
+          .pause(200)
+
+        client // set parameter, to ensure an initial value is set
+          .setValue(inputSelector, "123")
+          .click("button.btn.execute.opblock-control__btn")
+          .pause(200)
+
+        client // remove initial value, execute again
+          .setValue(inputSelector, "\u0008\u0008\u0008") // backspaces
+          .pause(200)
+          .click("button.btn.execute.opblock-control__btn")
+          .expect.element("textarea.curl").text
+          .to.contain(`GET "http://localhost:3230/emptyValueParams"`)
+      })
+      it("should set and unset a boolean value", function (client) {
+        const inputSelector = `tr[data-param-name="bool"] select`
+
+        client // open try-it-out
+          .click("#operations-default-get_emptyValueParams")
+          .waitForElementVisible("button.btn.try-out__btn", 5000)
+          .click("button.btn.try-out__btn")
+          .pause(200)
+
+        client // set parameter, to ensure an initial value is set
+          .click(`${inputSelector} [value="true"]`)
+          .click("button.btn.execute.opblock-control__btn")
+          .pause(200)
+
+        client // remove initial value, execute again
+          .click(`${inputSelector} [value=""]`)
+          .pause(200)
+          .click("button.btn.execute.opblock-control__btn")
+          .expect.element("textarea.curl").text
+          .to.contain(`GET "http://localhost:3230/emptyValueParams"`)
+      })
+      it("should set and unset an array value", function (client) {
+        const inputSelector = `tr[data-param-name="arr"]`
+
+        client // open try-it-out
+          .click("#operations-default-get_emptyValueParams")
+          .waitForElementVisible("button.btn.try-out__btn", 5000)
+          .click("button.btn.try-out__btn")
+          .pause(200)
+
+        client // set parameter, to ensure an initial value is set
+          .click(`${inputSelector} .json-schema-form-item-add`)
+          .setValue(`${inputSelector} input`, "asdf")
+          .click("button.btn.execute.opblock-control__btn")
+          .pause(200)
+
+        client // remove initial value, execute again
+          .click(`${inputSelector} .json-schema-form-item-remove`)
+          .pause(200)
+          .click("button.btn.execute.opblock-control__btn")
+          .expect.element("textarea.curl").text
+          .to.contain(`GET "http://localhost:3230/emptyValueParams"`)
+      })
+    })
+    describe("send empty inital value behavior", function () {
+      it("should send an empty integer value", function (client) {
+        const paramSelector = `tr[data-param-name="int"]`
+
+        client // open try-it-out
+          .click("#operations-default-get_emptyValueParams")
+          .waitForElementVisible("button.btn.try-out__btn", 5000)
+          .click("button.btn.try-out__btn")
+          .pause(200)
+
+        client // tick "send empty value" box and execute
+          .click(`${paramSelector} .parameter__empty_value_toggle input`)
+          .click("button.btn.execute.opblock-control__btn")
+          .expect.element("textarea.curl").text
+          .to.contain(`GET "http://localhost:3230/emptyValueParams?int="`)
+      })
+      it("should send an empty string value", function (client) {
+        const paramSelector = `tr[data-param-name="str"]`
+
+        client // open try-it-out
+          .click("#operations-default-get_emptyValueParams")
+          .waitForElementVisible("button.btn.try-out__btn", 5000)
+          .click("button.btn.try-out__btn")
+          .pause(200)
+
+        client // tick "send empty value" box and execute
+          .click(`${paramSelector} .parameter__empty_value_toggle input`)
+          .click("button.btn.execute.opblock-control__btn")
+          .expect.element("textarea.curl").text
+          .to.contain(`GET "http://localhost:3230/emptyValueParams?str="`)
+      })
+      it("should send an empty number value", function (client) {
+        const paramSelector = `tr[data-param-name="num"]`
+
+        client // open try-it-out
+          .click("#operations-default-get_emptyValueParams")
+          .waitForElementVisible("button.btn.try-out__btn", 5000)
+          .click("button.btn.try-out__btn")
+          .pause(200)
+
+        client // tick "send empty value" box and execute
+          .click(`${paramSelector} .parameter__empty_value_toggle input`)
+          .click("button.btn.execute.opblock-control__btn")
+          .expect.element("textarea.curl").text
+          .to.contain(`GET "http://localhost:3230/emptyValueParams?num="`)
+      })
+      it("should send an empty boolean value", function (client) {
+        const paramSelector = `tr[data-param-name="bool"]`
+
+        client // open try-it-out
+          .click("#operations-default-get_emptyValueParams")
+          .waitForElementVisible("button.btn.try-out__btn", 5000)
+          .click("button.btn.try-out__btn")
+          .pause(200)
+
+        client // tick "send empty value" box and execute
+          .click(`${paramSelector} .parameter__empty_value_toggle input`)
+          .click("button.btn.execute.opblock-control__btn")
+          .expect.element("textarea.curl").text
+          .to.contain(`GET "http://localhost:3230/emptyValueParams?bool="`)
+      })
+      it("should send an empty array value", function (client) {
+        const paramSelector = `tr[data-param-name="arr"]`
+
+        client // open try-it-out
+          .click("#operations-default-get_emptyValueParams")
+          .waitForElementVisible("button.btn.try-out__btn", 5000)
+          .click("button.btn.try-out__btn")
+          .pause(200)
+
+        client // tick "send empty value" box and execute
+          .click(`${paramSelector} .parameter__empty_value_toggle input`)
+          .click("button.btn.execute.opblock-control__btn")
+          .expect.element("textarea.curl").text
+          .to.contain(`GET "http://localhost:3230/emptyValueParams?arr="`)
+      })
+    })
+    describe("modify and send empty behavior", function () {
+      it("should set, unset and send an empty integer value", function (client) {
+        const paramSelector = `tr[data-param-name="int"]`
+        const inputSelector = `${paramSelector} input`
+
+        client // open try-it-out
+          .click("#operations-default-get_emptyValueParams")
+          .waitForElementVisible("button.btn.try-out__btn", 5000)
+          .click("button.btn.try-out__btn")
+          .pause(200)
+
+        client // set parameter, to ensure an initial value is set
+          .setValue(inputSelector, "123")
+          .click("button.btn.execute.opblock-control__btn")
+          .pause(200)
+
+        client // remove initial value, click "send empty", execute again, assert
+          .setValue(inputSelector, "\u0008\u0008\u0008") // backspaces
+          .pause(400)
+          .click(`${paramSelector} .parameter__empty_value_toggle input`)
+          .click("button.btn.execute.opblock-control__btn")
+          .expect.element("textarea.curl").text
+          .to.contain(`GET "http://localhost:3230/emptyValueParams?int="`)
+      })
+      it("should set, unset and send an empty string value", function (client) {
+        const paramSelector = `tr[data-param-name="str"]`
+        const inputSelector = `${paramSelector} input`
+
+        client // open try-it-out
+          .click("#operations-default-get_emptyValueParams")
+          .waitForElementVisible("button.btn.try-out__btn", 5000)
+          .click("button.btn.try-out__btn")
+          .pause(200)
+
+        client // set parameter, to ensure an initial value is set
+          .setValue(inputSelector, "123")
+          .click("button.btn.execute.opblock-control__btn")
+          .pause(200)
+
+        client // remove initial value, click "send empty", execute again, assert
+          .setValue(inputSelector, "\u0008\u0008\u0008") // backspaces
+          .pause(400)
+          .click(`${paramSelector} .parameter__empty_value_toggle input`)
+          .click("button.btn.execute.opblock-control__btn")
+          .expect.element("textarea.curl").text
+          .to.contain(`GET "http://localhost:3230/emptyValueParams?str="`)
+      })
+      it("should set, unset and send an empty number value", function (client) {
+        const paramSelector = `tr[data-param-name="num"]`
+        const inputSelector = `${paramSelector} input`
+
+        client // open try-it-out
+          .click("#operations-default-get_emptyValueParams")
+          .waitForElementVisible("button.btn.try-out__btn", 5000)
+          .click("button.btn.try-out__btn")
+          .pause(200)
+
+        client // set parameter, to ensure an initial value is set
+          .setValue(inputSelector, "123")
+          .click("button.btn.execute.opblock-control__btn")
+          .pause(200)
+
+        client // remove initial value, click "send empty", execute again, assert
+          .setValue(inputSelector, "\u0008\u0008\u0008") // backspaces
+          .pause(400)
+          .click(`${paramSelector} .parameter__empty_value_toggle input`)
+          .click("button.btn.execute.opblock-control__btn")
+          .expect.element("textarea.curl").text
+          .to.contain(`GET "http://localhost:3230/emptyValueParams?num="`)
+      })
+      it("should set, unset and send an empty boolean value", function (client) {
+        const paramSelector = `tr[data-param-name="bool"]`
+        const inputSelector = `${paramSelector} select`
+
+        client // open try-it-out
+          .click("#operations-default-get_emptyValueParams")
+          .waitForElementVisible("button.btn.try-out__btn", 5000)
+          .click("button.btn.try-out__btn")
+          .pause(200)
+
+        client // set parameter, to ensure an initial value is set
+          .click(`${inputSelector} option[value="true"]`)
+          .click("button.btn.execute.opblock-control__btn")
+          .pause(200)
+
+        client // remove initial value, click "send empty", execute again, assert
+          .click(`${inputSelector} option[value=""]`)
+          .pause(400)
+          .click(`${paramSelector} .parameter__empty_value_toggle input`)
+          .click("button.btn.execute.opblock-control__btn")
+          .expect.element("textarea.curl").text
+          .to.contain(`GET "http://localhost:3230/emptyValueParams?bool="`)
+      })
+      it("should set, unset and send an empty array value", function (client) {
+        const paramSelector = `tr[data-param-name="arr"]`
+
+        client // open try-it-out
+          .click("#operations-default-get_emptyValueParams")
+          .waitForElementVisible("button.btn.try-out__btn", 5000)
+          .click("button.btn.try-out__btn")
+          .pause(200)
+
+        client // set parameter, to ensure an initial value is set
+          .click(`${paramSelector} .json-schema-form-item-add`)
+          .setValue(`${paramSelector} input`, "asdf")
+          .click("button.btn.execute.opblock-control__btn")
+          .pause(200)
+
+        client // remove initial value, execute again
+          .click(`${paramSelector} .json-schema-form-item-remove`)
+          .pause(400)
+          .click(`${paramSelector} .parameter__empty_value_toggle input`)
+          .click("button.btn.execute.opblock-control__btn")
+          .expect.element("textarea.curl").text
+          .to.contain(`GET "http://localhost:3230/emptyValueParams?arr="`)
+      })
+    })
+  })
+})

test/e2e/scenarios/features/allow-empty-value.swagger.js

@@ -0,0 +1,433 @@
+describe("feature: Swagger 2 allowEmptyValue", function () {
+  beforeEach(function (client, done) {
+    client
+      .url("localhost:3230")
+      .page.main()
+
+    client.waitForElementVisible(".download-url-input:not([disabled])", 5000)
+      .clearValue(".download-url-input")
+      .setValue(".download-url-input", "/test-specs/features/allow-empty-value.swagger.yaml")
+      .click("button.download-url-button")
+      .waitForElementVisible(".opblock", 10000)
+
+    done()
+  })
+
+  afterEach(function (client, done) {
+    done()
+  })
+
+  describe("regular parameters", function () {
+    it("should set and unset an integer value", function (client) {
+      const inputSelector = `tr[data-param-name="int"] input`
+
+      client // open try-it-out
+        .click("#operations-default-get_regularParams")
+        .waitForElementVisible("button.btn.try-out__btn", 5000)
+        .click("button.btn.try-out__btn")
+        .pause(200)
+
+      client // set parameter, to ensure an initial value is set
+        .setValue(inputSelector, "123")
+        .click("button.btn.execute.opblock-control__btn")
+        .pause(200)
+
+      client // remove initial value, execute again
+        .setValue(inputSelector, "\u0008\u0008\u0008") // backspaces
+        .pause(200)
+        .click("button.btn.execute.opblock-control__btn")
+        .expect.element("textarea.curl").text
+        .to.contain(`GET "http://localhost:3230/regularParams"`)
+    })
+    it("should set and unset a string value", function (client) {
+      const inputSelector = `tr[data-param-name="str"] input`
+
+      client // open try-it-out
+        .click("#operations-default-get_regularParams")
+        .waitForElementVisible("button.btn.try-out__btn", 5000)
+        .click("button.btn.try-out__btn")
+        .pause(200)
+
+      client // set parameter, to ensure an initial value is set
+        .setValue(inputSelector, "123")
+        .click("button.btn.execute.opblock-control__btn")
+        .pause(200)
+
+      client // remove initial value, execute again
+        .setValue(inputSelector, "\u0008\u0008\u0008") // backspaces
+        .pause(200)
+        .click("button.btn.execute.opblock-control__btn")
+        .expect.element("textarea.curl").text
+        .to.contain(`GET "http://localhost:3230/regularParams"`)
+    })
+    it("should set and unset a number value", function (client) {
+      const inputSelector = `tr[data-param-name="num"] input`
+
+      client // open try-it-out
+        .click("#operations-default-get_regularParams")
+        .waitForElementVisible("button.btn.try-out__btn", 5000)
+        .click("button.btn.try-out__btn")
+        .pause(200)
+
+      client // set parameter, to ensure an initial value is set
+        .setValue(inputSelector, "123")
+        .click("button.btn.execute.opblock-control__btn")
+        .pause(200)
+
+      client // remove initial value, execute again
+        .setValue(inputSelector, "\u0008\u0008\u0008") // backspaces
+        .pause(200)
+        .click("button.btn.execute.opblock-control__btn")
+        .expect.element("textarea.curl").text
+        .to.contain(`GET "http://localhost:3230/regularParams"`)
+    })
+    it("should set and unset a boolean value", function (client) {
+      const inputSelector = `tr[data-param-name="bool"] select`
+
+      client // open try-it-out
+        .click("#operations-default-get_regularParams")
+        .waitForElementVisible("button.btn.try-out__btn", 5000)
+        .click("button.btn.try-out__btn")
+        .pause(200)
+
+      client // set parameter, to ensure an initial value is set
+        .click(`${inputSelector} [value="true"]`)
+        .click("button.btn.execute.opblock-control__btn")
+        .pause(200)
+
+      client // remove initial value, execute again
+        .click(`${inputSelector} [value=""]`)
+        .pause(200)
+        .click("button.btn.execute.opblock-control__btn")
+        .expect.element("textarea.curl").text
+        .to.contain(`GET "http://localhost:3230/regularParams"`)
+    })
+    it("should set and unset an array value", function (client) {
+      const inputSelector = `tr[data-param-name="arr"]`
+
+      client // open try-it-out
+        .click("#operations-default-get_regularParams")
+        .waitForElementVisible("button.btn.try-out__btn", 5000)
+        .click("button.btn.try-out__btn")
+        .pause(200)
+
+      client // set parameter, to ensure an initial value is set
+        .click(`${inputSelector} .json-schema-form-item-add`)
+        .setValue(`${inputSelector} input`, "asdf")
+        .click("button.btn.execute.opblock-control__btn")
+        .pause(200)
+
+      client // remove initial value, execute again
+        .click(`${inputSelector} .json-schema-form-item-remove`)
+        .pause(200)
+        .click("button.btn.execute.opblock-control__btn")
+        .expect.element("textarea.curl").text
+        .to.contain(`GET "http://localhost:3230/regularParams"`)
+    })
+  })
+
+  describe("allowEmptyValue parameters", function () {
+    describe("normal behavior", function () {
+      it("should set and unset an integer value", function (client) {
+        const inputSelector = `tr[data-param-name="int"] input`
+
+        client // open try-it-out
+          .click("#operations-default-get_emptyValueParams")
+          .waitForElementVisible("button.btn.try-out__btn", 5000)
+          .click("button.btn.try-out__btn")
+          .pause(200)
+
+        client // set parameter, to ensure an initial value is set
+          .setValue(inputSelector, "123")
+          .click("button.btn.execute.opblock-control__btn")
+          .pause(200)
+
+        client // remove initial value, execute again
+          .setValue(inputSelector, "\u0008\u0008\u0008") // backspaces
+          .pause(200)
+          .click("button.btn.execute.opblock-control__btn")
+          .expect.element("textarea.curl").text
+          .to.contain(`GET "http://localhost:3230/emptyValueParams"`)
+      })
+      it("should set and unset a string value", function (client) {
+        const inputSelector = `tr[data-param-name="str"] input`
+
+        client // open try-it-out
+          .click("#operations-default-get_emptyValueParams")
+          .waitForElementVisible("button.btn.try-out__btn", 5000)
+          .click("button.btn.try-out__btn")
+          .pause(200)
+
+        client // set parameter, to ensure an initial value is set
+          .setValue(inputSelector, "123")
+          .click("button.btn.execute.opblock-control__btn")
+          .pause(200)
+
+        client // remove initial value, execute again
+          .setValue(inputSelector, "\u0008\u0008\u0008") // backspaces
+          .pause(200)
+          .click("button.btn.execute.opblock-control__btn")
+          .expect.element("textarea.curl").text
+          .to.contain(`GET "http://localhost:3230/emptyValueParams"`)
+      })
+      it("should set and unset a number value", function (client) {
+        const inputSelector = `tr[data-param-name="num"] input`
+
+        client // open try-it-out
+          .click("#operations-default-get_emptyValueParams")
+          .waitForElementVisible("button.btn.try-out__btn", 5000)
+          .click("button.btn.try-out__btn")
+          .pause(200)
+
+        client // set parameter, to ensure an initial value is set
+          .setValue(inputSelector, "123")
+          .click("button.btn.execute.opblock-control__btn")
+          .pause(200)
+
+        client // remove initial value, execute again
+          .setValue(inputSelector, "\u0008\u0008\u0008") // backspaces
+          .pause(200)
+          .click("button.btn.execute.opblock-control__btn")
+          .expect.element("textarea.curl").text
+          .to.contain(`GET "http://localhost:3230/emptyValueParams"`)
+      })
+      it("should set and unset a boolean value", function (client) {
+        const inputSelector = `tr[data-param-name="bool"] select`
+
+        client // open try-it-out
+          .click("#operations-default-get_emptyValueParams")
+          .waitForElementVisible("button.btn.try-out__btn", 5000)
+          .click("button.btn.try-out__btn")
+          .pause(200)
+
+        client // set parameter, to ensure an initial value is set
+          .click(`${inputSelector} [value="true"]`)
+          .click("button.btn.execute.opblock-control__btn")
+          .pause(200)
+
+        client // remove initial value, execute again
+          .click(`${inputSelector} [value=""]`)
+          .pause(200)
+          .click("button.btn.execute.opblock-control__btn")
+          .expect.element("textarea.curl").text
+          .to.contain(`GET "http://localhost:3230/emptyValueParams"`)
+      })
+      it("should set and unset an array value", function (client) {
+        const inputSelector = `tr[data-param-name="arr"]`
+
+        client // open try-it-out
+          .click("#operations-default-get_emptyValueParams")
+          .waitForElementVisible("button.btn.try-out__btn", 5000)
+          .click("button.btn.try-out__btn")
+          .pause(200)
+
+        client // set parameter, to ensure an initial value is set
+          .click(`${inputSelector} .json-schema-form-item-add`)
+          .setValue(`${inputSelector} input`, "asdf")
+          .click("button.btn.execute.opblock-control__btn")
+          .pause(200)
+
+        client // remove initial value, execute again
+          .click(`${inputSelector} .json-schema-form-item-remove`)
+          .pause(200)
+          .click("button.btn.execute.opblock-control__btn")
+          .expect.element("textarea.curl").text
+          .to.contain(`GET "http://localhost:3230/emptyValueParams"`)
+      })
+    })
+    describe("send empty inital value behavior", function () {
+      it("should send an empty integer value", function (client) {
+        const paramSelector = `tr[data-param-name="int"]`
+
+        client // open try-it-out
+          .click("#operations-default-get_emptyValueParams")
+          .waitForElementVisible("button.btn.try-out__btn", 5000)
+          .click("button.btn.try-out__btn")
+          .pause(200)
+
+        client // tick "send empty value" box and execute
+          .click(`${paramSelector} .parameter__empty_value_toggle input`)
+          .click("button.btn.execute.opblock-control__btn")
+          .expect.element("textarea.curl").text
+          .to.contain(`GET "http://localhost:3230/emptyValueParams?int="`)
+      })
+      it("should send an empty string value", function (client) {
+        const paramSelector = `tr[data-param-name="str"]`
+
+        client // open try-it-out
+          .click("#operations-default-get_emptyValueParams")
+          .waitForElementVisible("button.btn.try-out__btn", 5000)
+          .click("button.btn.try-out__btn")
+          .pause(200)
+
+        client // tick "send empty value" box and execute
+          .click(`${paramSelector} .parameter__empty_value_toggle input`)
+          .click("button.btn.execute.opblock-control__btn")
+          .expect.element("textarea.curl").text
+          .to.contain(`GET "http://localhost:3230/emptyValueParams?str="`)
+      })
+      it("should send an empty number value", function (client) {
+        const paramSelector = `tr[data-param-name="num"]`
+
+        client // open try-it-out
+          .click("#operations-default-get_emptyValueParams")
+          .waitForElementVisible("button.btn.try-out__btn", 5000)
+          .click("button.btn.try-out__btn")
+          .pause(200)
+
+        client // tick "send empty value" box and execute
+          .click(`${paramSelector} .parameter__empty_value_toggle input`)
+          .click("button.btn.execute.opblock-control__btn")
+          .expect.element("textarea.curl").text
+          .to.contain(`GET "http://localhost:3230/emptyValueParams?num="`)
+      })
+      it("should send an empty boolean value", function (client) {
+        const paramSelector = `tr[data-param-name="bool"]`
+
+        client // open try-it-out
+          .click("#operations-default-get_emptyValueParams")
+          .waitForElementVisible("button.btn.try-out__btn", 5000)
+          .click("button.btn.try-out__btn")
+          .pause(200)
+
+        client // tick "send empty value" box and execute
+          .click(`${paramSelector} .parameter__empty_value_toggle input`)
+          .click("button.btn.execute.opblock-control__btn")
+          .expect.element("textarea.curl").text
+          .to.contain(`GET "http://localhost:3230/emptyValueParams?bool="`)
+      })
+      it("should send an empty array value", function (client) {
+        const paramSelector = `tr[data-param-name="arr"]`
+
+        client // open try-it-out
+          .click("#operations-default-get_emptyValueParams")
+          .waitForElementVisible("button.btn.try-out__btn", 5000)
+          .click("button.btn.try-out__btn")
+          .pause(200)
+
+        client // tick "send empty value" box and execute
+          .click(`${paramSelector} .parameter__empty_value_toggle input`)
+          .click("button.btn.execute.opblock-control__btn")
+          .expect.element("textarea.curl").text
+          .to.contain(`GET "http://localhost:3230/emptyValueParams?arr="`)
+      })
+    })
+    describe("modify and send empty behavior", function () {
+      it("should set, unset and send an empty integer value", function (client) {
+        const paramSelector = `tr[data-param-name="int"]`
+        const inputSelector = `${paramSelector} input`
+
+        client // open try-it-out
+          .click("#operations-default-get_emptyValueParams")
+          .waitForElementVisible("button.btn.try-out__btn", 5000)
+          .click("button.btn.try-out__btn")
+          .pause(200)
+
+        client // set parameter, to ensure an initial value is set
+          .setValue(inputSelector, "123")
+          .click("button.btn.execute.opblock-control__btn")
+          .pause(200)
+
+        client // remove initial value, click "send empty", execute again, assert
+          .setValue(inputSelector, "\u0008\u0008\u0008") // backspaces
+          .pause(400)
+          .click(`${paramSelector} .parameter__empty_value_toggle input`)
+          .click("button.btn.execute.opblock-control__btn")
+          .expect.element("textarea.curl").text
+          .to.contain(`GET "http://localhost:3230/emptyValueParams?int="`)
+      })
+      it("should set, unset and send an empty string value", function (client) {
+        const paramSelector = `tr[data-param-name="str"]`
+        const inputSelector = `${paramSelector} input`
+
+        client // open try-it-out
+          .click("#operations-default-get_emptyValueParams")
+          .waitForElementVisible("button.btn.try-out__btn", 5000)
+          .click("button.btn.try-out__btn")
+          .pause(200)
+
+        client // set parameter, to ensure an initial value is set
+          .setValue(inputSelector, "123")
+          .click("button.btn.execute.opblock-control__btn")
+          .pause(200)
+
+        client // remove initial value, click "send empty", execute again, assert
+          .setValue(inputSelector, "\u0008\u0008\u0008") // backspaces
+          .pause(400)
+          .click(`${paramSelector} .parameter__empty_value_toggle input`)
+          .click("button.btn.execute.opblock-control__btn")
+          .expect.element("textarea.curl").text
+          .to.contain(`GET "http://localhost:3230/emptyValueParams?str="`)
+      })
+      it("should set, unset and send an empty number value", function (client) {
+        const paramSelector = `tr[data-param-name="num"]`
+        const inputSelector = `${paramSelector} input`
+
+        client // open try-it-out
+          .click("#operations-default-get_emptyValueParams")
+          .waitForElementVisible("button.btn.try-out__btn", 5000)
+          .click("button.btn.try-out__btn")
+          .pause(200)
+
+        client // set parameter, to ensure an initial value is set
+          .setValue(inputSelector, "123")
+          .click("button.btn.execute.opblock-control__btn")
+          .pause(200)
+
+        client // remove initial value, click "send empty", execute again, assert
+          .setValue(inputSelector, "\u0008\u0008\u0008") // backspaces
+          .pause(400)
+          .click(`${paramSelector} .parameter__empty_value_toggle input`)
+          .click("button.btn.execute.opblock-control__btn")
+          .expect.element("textarea.curl").text
+          .to.contain(`GET "http://localhost:3230/emptyValueParams?num="`)
+      })
+      it("should set, unset and send an empty boolean value", function (client) {
+        const paramSelector = `tr[data-param-name="bool"]`
+        const inputSelector = `${paramSelector} select`
+
+        client // open try-it-out
+          .click("#operations-default-get_emptyValueParams")
+          .waitForElementVisible("button.btn.try-out__btn", 5000)
+          .click("button.btn.try-out__btn")
+          .pause(200)
+
+        client // set parameter, to ensure an initial value is set
+          .click(`${inputSelector} option[value="true"]`)
+          .click("button.btn.execute.opblock-control__btn")
+          .pause(200)
+
+        client // remove initial value, click "send empty", execute again, assert
+          .click(`${inputSelector} option[value=""]`)
+          .pause(400)
+          .click(`${paramSelector} .parameter__empty_value_toggle input`)
+          .click("button.btn.execute.opblock-control__btn")
+          .expect.element("textarea.curl").text
+          .to.contain(`GET "http://localhost:3230/emptyValueParams?bool="`)
+      })
+      it("should set, unset and send an empty array value", function (client) {
+        const paramSelector = `tr[data-param-name="arr"]`
+
+        client // open try-it-out
+          .click("#operations-default-get_emptyValueParams")
+          .waitForElementVisible("button.btn.try-out__btn", 5000)
+          .click("button.btn.try-out__btn")
+          .pause(200)
+
+        client // set parameter, to ensure an initial value is set
+          .click(`${paramSelector} .json-schema-form-item-add`)
+          .setValue(`${paramSelector} input`, "asdf")
+          .click("button.btn.execute.opblock-control__btn")
+          .pause(200)
+
+        client // remove initial value, execute again
+          .click(`${paramSelector} .json-schema-form-item-remove`)
+          .pause(400)
+          .click(`${paramSelector} .parameter__empty_value_toggle input`)
+          .click("button.btn.execute.opblock-control__btn")
+          .expect.element("textarea.curl").text
+          .to.contain(`GET "http://localhost:3230/emptyValueParams?arr="`)
+      })
+    })
+  })
+})

test/e2e/specs/bugs/4587.yaml

@@ -0,0 +1,126 @@
+---
+swagger: '2.0'
+info:
+  version: 0.0.1
+  title: DDErl REST interface
+  description: RESTful access to IMEM DB and DDErl
+schemes:
+- http
+- https
+securityDefinitions:
+  basicAuth:
+    type: basic
+    description: HTTP Basic Authentication Username:Password
+basePath: "/dderlrest/0.0.1"
+paths:
+  "/sql/":
+    get:
+      tags:
+      - sql
+      security:
+      - basicAuth: []
+      summary: execute sql
+      operationId: execSql
+      description: Prepare and execute SQL statements
+      parameters:
+      - name: x-irest-conn
+        in: header
+        required: false
+        description: ErlImem connection identifier
+        type: string
+      produces:
+      - application/json
+      responses:
+        '200':
+          description: OK
+          schema:
+            type: object
+          headers:
+            x-irest-conn:
+              description: ErlImem connection identifier
+              type: string
+        '403':
+          description: Malformed/Invalid
+          schema:
+            "$ref": "#/definitions/ErrorResponse"
+definitions:
+  ErrorResponse:
+    readOnly: true
+    type: object
+    required:
+    - errorCode
+    - errorMessage
+    - errorDetails
+    properties:
+      errorCode:
+        description: Error Code
+        type: number
+        example: 1400
+      errorMessage:
+        description: Error Message
+        type: string
+        example: malformed
+      errorDetails:
+        description: Error Details
+        type: string
+        example: mandatory properties missing or bad type
+  ViewParams:
+    readOnly: true
+    type: array
+    items:
+      type: object
+      required:
+      - typ
+      - value
+      - name
+      properties:
+        name:
+          description: Name
+          type: string
+          example: ":atom_user"
+        value:
+          description: Value
+          type: string
+          example: system
+        typ:
+          description: Datatype
+          type: string
+          enum:
+          - atom
+          - binary
+          - raw
+          - blob
+          - rowid
+          - binstr
+          - clob
+          - nclob
+          - varchar2
+          - nvarchar2
+          - char
+          - nchar
+          - boolean
+          - datetime
+          - decimal
+          - float
+          - fun
+          - integer
+          - ipaddr
+          - list
+          - map
+          - number
+          - pid
+          - ref
+          - string
+          - term
+          - binterm
+          - timestamp
+          - tuple
+          - userid
+          example: atom
+        dir:
+          description: Direction
+          type: string
+          enum:
+          - in
+          - out
+          default: in

test/e2e/specs/features/allow-empty-value.openapi.yaml

@@ -0,0 +1,64 @@
+openapi: "3.0.0"
+
+paths:
+  /regularParams:
+    get:
+      parameters: 
+      - name: int
+        in: query
+        schema:
+          type: integer
+      - name: str
+        in: query
+        schema:
+          type: string
+      - name: num
+        in: query
+        schema:
+          type: number
+      - name: bool
+        in: query
+        schema:
+          type: boolean
+      - name: arr
+        in: query
+        schema:
+          type: array
+          items:
+            type: string
+      responses:
+        200:
+          description: ok
+  /emptyValueParams:
+    get:
+      parameters: 
+      - name: int
+        in: query
+        schema:
+          type: integer
+        allowEmptyValue: true 
+      - name: str
+        in: query
+        schema:
+          type: string
+        allowEmptyValue: true 
+      - name: num
+        in: query
+        schema:
+          type: number
+        allowEmptyValue: true 
+      - name: bool
+        in: query
+        schema:
+          type: boolean
+        allowEmptyValue: true 
+      - name: arr
+        in: query
+        schema:
+          type: array
+          items:
+            type: string
+        allowEmptyValue: true
+      responses:
+        200:
+          description: ok

test/e2e/specs/features/allow-empty-value.swagger.yaml

@@ -0,0 +1,57 @@
+swagger: "2.0"
+
+consumes: 
+- application/json
+- multipart/form-data
+paths:
+  /regularParams:
+    get:
+      parameters: 
+      - name: int
+        in: query
+        type: integer
+      - name: str
+        in: query
+        type: string
+      - name: num
+        in: query
+        type: number
+      - name: bool
+        in: query
+        type: boolean
+      - name: arr
+        in: query
+        type: array
+        items:
+          type: string
+      responses:
+        200:
+          description: ok
+  /emptyValueParams:
+    get:
+      parameters: 
+      - name: int
+        in: query
+        type: integer
+        allowEmptyValue: true 
+      - name: str
+        in: query
+        type: string
+        allowEmptyValue: true 
+      - name: num
+        in: query
+        type: number
+        allowEmptyValue: true 
+      - name: bool
+        in: query
+        type: boolean
+        allowEmptyValue: true 
+      - name: arr
+        in: query
+        type: array
+        items:
+          type: string
+        allowEmptyValue: true
+      responses:
+        200:
+          description: ok