From 448f5e437577b87b74d4c846788a729e22d248c1 Mon Sep 17 00:00:00 2001
From: Kyle Shockey <shockey@users.noreply.github.com>
Date: Fri, 13 Jul 2018 19:46:55 -0700
Subject: [PATCH 01/11] add tests for example feature

---
 package-lock.json                            |  13 +-
 package.json                                 |   1 +
 src/core/components/param-body.jsx           |   2 +-
 src/core/components/parameter-row.jsx        |   2 +-
 src/core/components/response.jsx             |   2 +-
 test/e2e/nightwatch.json                     |   4 +-
 test/e2e/scenarios/features/example.js       | 240 +++++++++++++++++++
 test/e2e/specs/features/example.openapi.yaml | 156 ++++++++++++
 test/e2e/specs/features/example.swagger.yaml | 127 ++++++++++
 9 files changed, 540 insertions(+), 7 deletions(-)
 create mode 100644 test/e2e/scenarios/features/example.js
 create mode 100644 test/e2e/specs/features/example.openapi.yaml
 create mode 100644 test/e2e/specs/features/example.swagger.yaml

diff --git a/package-lock.json b/package-lock.json
index fdad7ea47fe..17a2715b085 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "swagger-ui",
-  "version": "3.17.2",
+  "version": "3.17.3",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
@@ -3755,6 +3755,12 @@
         "mimic-response": "^1.0.0"
       }
     },
+    "dedent": {
+      "version": "0.7.0",
+      "resolved": "https://registry.npmjs.org/dedent/-/dedent-0.7.0.tgz",
+      "integrity": "sha1-JJXduvbrh0q7Dhvp3yLS5aVEMmw=",
+      "dev": true
+    },
     "deep-eql": {
       "version": "0.1.3",
       "resolved": "https://registry.npmjs.org/deep-eql/-/deep-eql-0.1.3.tgz",
@@ -16494,6 +16500,11 @@
       "resolved": "https://registry.npmjs.org/requires-port/-/requires-port-1.0.0.tgz",
       "integrity": "sha1-kl0mAdOaxIXgkc8NpcbmlNw9yv8="
     },
+    "reselect": {
+      "version": "2.5.4",
+      "resolved": "https://registry.npmjs.org/reselect/-/reselect-2.5.4.tgz",
+      "integrity": "sha1-t9I/3wC4P6etAnlUb427vXZccEc="
+    },
     "resolve": {
       "version": "1.7.1",
       "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.7.1.tgz",
diff --git a/package.json b/package.json
index 271a4897b0b..dac28bed0ca 100644
--- a/package.json
+++ b/package.json
@@ -98,6 +98,7 @@
     "chromedriver": "^2.38.3",
     "copy-webpack-plugin": "^4.0.1",
     "css-loader": "^0.28.11",
+    "dedent": "^0.7.0",
     "deepmerge": "^2.1.0",
     "enzyme": "^2.7.1",
     "eslint": "^4.1.1",
diff --git a/src/core/components/param-body.jsx b/src/core/components/param-body.jsx
index 7caed097971..9a0e62670ac 100644
--- a/src/core/components/param-body.jsx
+++ b/src/core/components/param-body.jsx
@@ -114,7 +114,7 @@ export default class ParamBody extends PureComponent {
     let { value, isEditBox } = this.state
 
     return (
-      <div className="body-param">
+      <div className="body-param" data-param-name={param.get("name")} data-param-in={param.get("in")}>
         {
           isEditBox && isExecute
             ? <TextArea className={ "body-param__text" + ( errors.count() ? " invalid" : "")} value={value} onChange={ this.handleOnChange }/>
diff --git a/src/core/components/parameter-row.jsx b/src/core/components/parameter-row.jsx
index ffdb300b0eb..e0a2f27d98f 100644
--- a/src/core/components/parameter-row.jsx
+++ b/src/core/components/parameter-row.jsx
@@ -161,7 +161,7 @@ export default class ParameterRow extends Component {
     }
 
     return (
-      <tr className="parameters">
+      <tr data-param-name={param.get("name")} data-param-in={param.get("in")}>
         <td className="col parameters-col_name">
           <div className={required ? "parameter__name required" : "parameter__name"}>
             { param.get("name") }
diff --git a/src/core/components/response.jsx b/src/core/components/response.jsx
index cb05c47b86f..fe5081a0c29 100644
--- a/src/core/components/response.jsx
+++ b/src/core/components/response.jsx
@@ -126,7 +126,7 @@ export default class Response extends React.Component {
     let example = getExampleComponent( sampleResponse, examples, HighlightCode )
 
     return (
-      <tr className={ "response " + ( className || "") }>
+      <tr className={ "response " + ( className || "") } data-code={code}>
         <td className="col response-col_status">
           { code }
         </td>
diff --git a/test/e2e/nightwatch.json b/test/e2e/nightwatch.json
index fb0fe76ca9b..57c1ddc3a98 100644
--- a/test/e2e/nightwatch.json
+++ b/test/e2e/nightwatch.json
@@ -1,7 +1,6 @@
 {
   "src_folders" : ["test/e2e/scenarios"],
   "output_folder" : "reports",
-  "live_output": true,
   "custom_commands_path" : "",
   "custom_assertions_path" : "",
   "page_objects_path" : "test/e2e/pages",
@@ -14,8 +13,7 @@
   "test_runner" : {
     "type" : "mocha",
     "options" : {
-      "ui" : "bdd",
-      "reporter" : "list"
+      "ui" : "bdd"
     }
   },
 
diff --git a/test/e2e/scenarios/features/example.js b/test/e2e/scenarios/features/example.js
new file mode 100644
index 00000000000..079d8402e84
--- /dev/null
+++ b/test/e2e/scenarios/features/example.js
@@ -0,0 +1,240 @@
+const dedent = require("dedent")
+
+describe("feature: `example` field support", function () {
+
+  describe("Swagger 2", 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/example.swagger.yaml")
+        .click("button.download-url-button")
+        .waitForElementVisible(".opblock", 10000)
+        .click("#operations-default-put_one")
+        .waitForElementVisible("#operations-default-put_one.is-open", 5000)
+
+      done()
+    })
+
+    afterEach(function (client, done) {
+      done()
+    })
+
+    // Parameters
+      // Supports complex root `example` values in Schema objects for bodies
+      // Supports nested `example` values in Schema objects for bodies
+
+    describe("primitive parameters", function() {
+      it("should respect a primitive x-example value", function (client) {
+        client
+          .click("button.try-out__btn")
+          .assert.value(
+            `tr[data-param-name="ValidParam"] input[type="text"]`,
+            `12345`
+          )
+      })
+      it("should ignore a primitive example value", function (client) {
+        client
+          .click("button.try-out__btn")
+          .assert.value(
+            `tr[data-param-name="NotValidParam"] input[type="text"]`,
+            ``
+          )
+      })
+    })
+
+    describe("object parameters", function() {
+      it("should correctly consider property-level schema examples", function(client) {
+        client.assert.containsText(`div[data-param-name="body"] pre`,
+          dedent(`
+            {
+              "one": "hello!",
+              "two": {
+                "uno": "wow!",
+                "dos": "hey there!"
+              }
+            }
+          `)
+        )
+      })
+      it("should correctly consider root schema-level schema examples", function(client) {
+        client.assert.containsText(`div[data-param-name="body2"] pre`,
+          dedent(`
+            {
+              "foo": "hey",
+              "bar": 123
+            }
+          `)
+        )
+      })
+      it("should correctly consider nested schema-level schema examples", function(client) {
+        client.assert.containsText(`div[data-param-name="body3"] pre`,
+          dedent(`
+            {
+              "one": {
+                "uno": "woohoo!",
+                "dos": "amazing!"
+              }
+            }
+          `)
+        )
+      })
+    })
+
+    describe("responses", function() {
+      it("should correctly consider schema-level examples", function (client) {
+        client.assert.containsText(`tr.response[data-code="201"] pre`,
+          dedent(`
+            {
+              "code": 201,
+              "payload": [
+                {
+                  "id": 1,
+                  "code": "AE2",
+                  "name": "Yono"
+                }
+              ]
+            }
+          `)
+        )
+      })
+      it("should correctly consider property-level examples", function (client) {
+        client.assert.containsText(`tr.response[data-code="202"] pre`,
+          dedent(`
+            {
+              "code": 202,
+              "payload": [
+                {
+                  "id": 1,
+                  "code": "AE2",
+                  "name": "Yono"
+                }
+              ]
+            }
+          `)
+        )
+      })
+    })
+  })
+  describe("OpenAPI 3.0", 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/example.openapi.yaml")
+        .click("button.download-url-button")
+        .waitForElementVisible(".opblock-summary-description", 10000)
+        .click("#operations-agent-editAgent")
+        .waitForElementVisible("#operations-agent-editAgent.is-open", 5000)
+
+      done()
+    })
+
+    describe("parameters", function() {
+      it("should respect a primitive example value", function(client) {
+        client
+          .click("button.try-out__btn")
+          .assert.value(
+            `div.parameters-container > div > table > tbody > tr > td.col.parameters-col_description > input[type="text"]`,
+            `12345`
+          )
+      })
+    })
+
+    describe("request bodies", function() {
+      it("should correctly consider media type-level examples", function (client) {
+        client
+          .click(`select.content-type option[value="application/json_media-type-level"]`)
+          .assert.containsText(`pre.body-param__example`,
+            dedent(`
+              {
+                "code": "AE1",
+                "name": "Andrew"
+              }
+            `)
+          )
+      })
+      it("should correctly consider schema-level examples", function (client) {
+        client
+          .click(`select.content-type option[value="application/json_schema-level"]`)
+          .assert.containsText(`pre.body-param__example`,
+            dedent(`
+              {
+                "code": "AE1",
+                "name": "Andrew"
+              }
+            `)
+          )
+      })
+      it("should correctly consider property-level examples", function (client) {
+        client
+          .click(`select.content-type option[value="application/json_property-level"]`)
+          .assert.containsText(`pre.body-param__example`,
+            dedent(`
+              {
+                "code": "AE1",
+                "name": "Andrew"
+              }
+            `)
+          )
+      })
+    })
+    describe("responses", function() {
+      it("should correctly consider media type-level examples", function (client) {
+        client.assert.containsText(`tr.response[data-code="200"] pre`,
+          dedent(`
+            {
+              "code": 200,
+              "payload": [
+                {
+                  "id": 1,
+                  "code": "AE2",
+                  "name": "Yono"
+                }
+              ]
+            }
+          `)
+        )
+      })
+      it("should correctly consider schema-level examples", function (client) {
+        client.assert.containsText(`tr.response[data-code="201"] pre`,
+          dedent(`
+            {
+              "code": 201,
+              "payload": [
+                {
+                  "id": 1,
+                  "code": "AE2",
+                  "name": "Yono"
+                }
+              ]
+            }
+          `)
+        )
+      })
+      it("should correctly consider property-level examples", function (client) {
+        client.assert.containsText(`tr.response[data-code="202"] pre`,
+          dedent(`
+            {
+              "code": 202,
+              "payload": [
+                {
+                  "id": 1,
+                  "code": "AE2",
+                  "name": "Yono"
+                }
+              ]
+            }
+          `)
+        )
+      })
+    })
+  })
+})
diff --git a/test/e2e/specs/features/example.openapi.yaml b/test/e2e/specs/features/example.openapi.yaml
new file mode 100644
index 00000000000..c016acaee5d
--- /dev/null
+++ b/test/e2e/specs/features/example.openapi.yaml
@@ -0,0 +1,156 @@
+openapi: 3.0.0
+servers:
+  - url: http://example.com/v1
+    description: Production server version 1
+  - url: http://staging-api.example.com
+    description: Staging server
+info:
+  description: |
+    This is an API documentation of example.
+  version: "0.1.0"
+  title: Example
+  termsOfService: 'http://www.example.com/terms/'
+  contact:
+    email: developer@example.com
+  license:
+    name: Proprietary license
+    url: 'http://www.example.com/license/'
+tags:
+  - name: agent
+    description: Access to example
+paths:
+  /agents/{agentId}:
+    put:
+      tags:
+        - agent
+      summary: Edit agent
+      operationId: editAgent
+      parameters:
+        - in: path
+          name: agentId
+          schema:
+            type: integer
+          example: 12345
+          required: true
+          description: Numeric ID of the paper agent to edit
+      requestBody:
+        required: true
+        content:
+          application/json_media-type-level:
+            schema:
+              type: object
+              properties:
+                code:
+                  type: string
+                name:
+                  type: string
+            example:
+              code: AE1
+              name: Andrew
+          application/json_schema-level:
+            schema:
+              type: object
+              properties:
+                code:
+                  type: string
+                name:
+                  type: string
+              example:
+                code: AE1
+                name: Andrew
+          application/json_property-level:
+            schema:
+              type: object
+              properties:
+                code:
+                  type: string
+                  example: AE1
+                name:
+                  type: string
+                  example: Andrew
+      responses:
+        '200':
+          description: media type-level example
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  code:
+                    type: integer
+                    format: int64
+                  payload:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: integer
+                          format: int64
+                          readOnly: true
+                        code:
+                          type: string
+                        name:
+                          type: string
+              example:
+                code: 200
+                payload:
+                - id: 1
+                  code: AE2
+                  name: Yono
+        '201':
+          description: schema-level example
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  code:
+                    type: integer
+                    format: int64
+                  payload:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: integer
+                          format: int64
+                          readOnly: true
+                        code:
+                          type: string
+                        name:
+                          type: string
+                example:
+                  code: 201
+                  payload:
+                  - id: 1
+                    code: AE2
+                    name: Yono
+        '202':
+          description: property-level example
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  code:
+                    type: integer
+                    format: int64
+                    example: 202
+                  payload:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: integer
+                          format: int64
+                          readOnly: true
+                          example: 1
+                        code:
+                          type: string
+                          example: AE2
+                        name:
+                          type: string
+                          example: Yono
\ No newline at end of file
diff --git a/test/e2e/specs/features/example.swagger.yaml b/test/e2e/specs/features/example.swagger.yaml
new file mode 100644
index 00000000000..7823d9ff25c
--- /dev/null
+++ b/test/e2e/specs/features/example.swagger.yaml
@@ -0,0 +1,127 @@
+swagger: "2.0"
+info:
+  description: |
+    This is an API documentation of example.
+  version: "0.1.0"
+  title: Example
+  termsOfService: 'http://www.example.com/terms/'
+  contact:
+    email: developer@example.com
+  license:
+    name: Proprietary license
+    url: 'http://www.example.com/license/'
+paths:
+  /one:
+    put:
+      parameters:
+        - in: query
+          name: NotValidParam
+          type: integer
+          example: 12345
+          required: true
+          description: This example **should not** have an effect
+        - in: query
+          name: ValidParam
+          type: integer
+          x-example: 12345
+          description: This example **should** have an effect
+        - in: body
+          name: body
+          description: property-level examples
+          schema:
+            type: object
+            properties:
+              one:
+                type: string
+                example: hello!
+              two:
+                type: object
+                properties:
+                  uno:
+                    type: string
+                    example: wow!
+                  dos:
+                    type: string
+                    example: hey there!
+        - in: body
+          name: body2
+          description: root schema-level example
+          schema:
+            type: object
+            properties:
+              foo:
+                type: string
+              bar:
+                type: integer
+            example: 
+              foo: hey
+              bar: 123
+        - in: body
+          name: body3
+          description: nested schema-level example
+          schema:
+            type: object
+            properties:
+              one:
+                type: object
+                properties:
+                  uno:
+                    type: string
+                  dos:
+                    type: string
+                example:
+                  uno: woohoo!
+                  dos: amazing!
+      responses:
+        '201':
+          description: schema-level example
+          schema:
+            type: object
+            properties:
+              code:
+                type: integer
+                format: int64
+              payload:
+                type: array
+                items:
+                  type: object
+                  properties:
+                    id:
+                      type: integer
+                      format: int64
+                      readOnly: true
+                    code:
+                      type: string
+                    name:
+                      type: string
+            x-example:
+              code: 201
+              payload:
+              - id: 1
+                code: AE2
+                name: Yono
+        '202':
+          description: property-level example
+          schema:
+            type: object
+            properties:
+              code:
+                type: integer
+                format: int64
+                example: 202
+              payload:
+                type: array
+                items:
+                  type: object
+                  properties:
+                    id:
+                      type: integer
+                      format: int64
+                      readOnly: true
+                      example: 1
+                    code:
+                      type: string
+                      example: AE2
+                    name:
+                      type: string
+                      example: Yono
\ No newline at end of file

From 4eeb480a8a3d562eb490880cda8a6d3c1e64c779 Mon Sep 17 00:00:00 2001
From: Kyle Shockey <shockey@users.noreply.github.com>
Date: Fri, 13 Jul 2018 20:42:29 -0700
Subject: [PATCH 02/11] refactor ParameterRow value setter logic

---
 src/core/components/parameter-row.jsx | 36 +++++++++++++++------------
 1 file changed, 20 insertions(+), 16 deletions(-)

diff --git a/src/core/components/parameter-row.jsx b/src/core/components/parameter-row.jsx
index e0a2f27d98f..e9b3c1898ab 100644
--- a/src/core/components/parameter-row.jsx
+++ b/src/core/components/parameter-row.jsx
@@ -30,8 +30,6 @@ export default class ParameterRow extends Component {
     let { specSelectors, pathMethod, rawParam } = props
     let { isOAS3 } = specSelectors
 
-    let example = rawParam.get("example")
-
     let parameterWithMeta = specSelectors.parameterWithMetaByIdentity(pathMethod, rawParam)
     // fallback, if the meta lookup fails
     parameterWithMeta = parameterWithMeta.isEmpty() ? rawParam : parameterWithMeta
@@ -50,15 +48,15 @@ export default class ParameterRow extends Component {
 
     if ( paramValue !== undefined ) {
       value = paramValue
-    } else if ( example !== undefined ) {
-      value = example
     } else if ( rawParam.get("required") && enumValue && enumValue.size ) {
       value = enumValue.first()
     }
 
-    if ( value !== undefined ) {
+    if ( value !== undefined && value !== paramValue ) {
       this.onChangeWrapper(value)
     }
+
+    this.setDefaultValue()
   }
 
   onChangeWrapper = (value, isXml = false) => {
@@ -69,22 +67,28 @@ export default class ParameterRow extends Component {
   setDefaultValue = () => {
     let { specSelectors, pathMethod, rawParam } = this.props
 
-    if (rawParam.get("value") !== undefined) {
+    let paramWithMeta = specSelectors.parameterWithMetaByIdentity(pathMethod, rawParam)
+
+
+    if (paramWithMeta.get("value") !== undefined) {
       return
     }
 
-    let schema = specSelectors.isOAS3() ? rawParam.get("schema", Map({})) : rawParam
+    let schema = specSelectors.isOAS3() ? paramWithMeta.get("schema", Map({})) : paramWithMeta
 
-    let defaultValue = schema.get("default")
-    let xExampleValue = rawParam.get("x-example") // Swagger 2 only
-    let parameter = specSelectors.parameterWithMetaByIdentity(pathMethod, rawParam)
-    let value = parameter ? parameter.get("value") : ""
+    if( paramWithMeta.get("in") !== "body" ) {
+      let newValue
+
+      if (specSelectors.isSwagger2()) {
+        newValue = paramWithMeta.getIn(["schema", "default"])
+          || paramWithMeta.get("x-example")
+      } else if (specSelectors.isOAS3()) {
+        newValue = paramWithMeta.get("default")
+          || paramWithMeta.get("example")
+      }
 
-    if( rawParam.get("in") !== "body" ) {
-      if ( xExampleValue !== undefined && value === undefined && specSelectors.isSwagger2() ) {
-        this.onChangeWrapper(xExampleValue)
-      } else if ( defaultValue !== undefined && value === undefined ) {
-        this.onChangeWrapper(defaultValue)
+      if(newValue !== undefined) {
+        this.onChangeWrapper(newValue)
       }
     }
   }

From af27cc3df8dd6a5cc981ec23009be1c7ac3ffb71 Mon Sep 17 00:00:00 2001
From: Kyle Shockey <shockey@users.noreply.github.com>
Date: Fri, 13 Jul 2018 20:44:14 -0700
Subject: [PATCH 03/11] aside: fix property access in sampleFromSchema

---
 src/core/plugins/samples/fn.js | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/core/plugins/samples/fn.js b/src/core/plugins/samples/fn.js
index feabcec4241..83b6c83fc54 100644
--- a/src/core/plugins/samples/fn.js
+++ b/src/core/plugins/samples/fn.js
@@ -52,10 +52,10 @@ export const sampleFromSchema = (schema, config={}) => {
     let props = objectify(properties)
     let obj = {}
     for (var name in props) {
-      if ( props[name].readOnly && !includeReadOnly ) {
+      if ( props[name] && props[name].readOnly && !includeReadOnly ) {
         continue
       }
-      if ( props[name].writeOnly && !includeWriteOnly ) {
+      if ( props[name] && props[name].writeOnly && !includeWriteOnly ) {
         continue
       }
       obj[name] = sampleFromSchema(props[name], config)

From 4eee1305b7c5617d1ef67ef74680b11ee6729c5d Mon Sep 17 00:00:00 2001
From: Kyle Shockey <shockey@users.noreply.github.com>
Date: Fri, 13 Jul 2018 21:37:02 -0700
Subject: [PATCH 04/11] prioritize media type examples for OAS3 responses

---
 src/core/components/response.jsx | 56 ++++++++++++++++++++++----------
 1 file changed, 39 insertions(+), 17 deletions(-)

diff --git a/src/core/components/response.jsx b/src/core/components/response.jsx
index fe5081a0c29..6e38ed67f80 100644
--- a/src/core/components/response.jsx
+++ b/src/core/components/response.jsx
@@ -2,21 +2,34 @@ import React from "react"
 import PropTypes from "prop-types"
 import ImPropTypes from "react-immutable-proptypes"
 import cx from "classnames"
-import { fromJS, Seq, Iterable, List } from "immutable"
+import { fromJS, Seq, Iterable, List, Map } from "immutable"
 import { getSampleSchema, fromJSOrdered } from "core/utils"
 
+const stringify = (thing) => {
+  if(typeof thing === "string") {
+    return thing
+  }
+
+  if (thing.toJS) {
+    thing = thing.toJS()
+  }
+
+  if(typeof thing === "object" && thing !== null) {
+    try {
+      return JSON.stringify(thing, null, 2)
+    }
+    catch (e) {
+      return String(thing)
+    }
+  }
+
+  return thing.toString()
+}
+
 const getExampleComponent = ( sampleResponse, examples, HighlightCode ) => {
   if ( examples && examples.size ) {
     return examples.entrySeq().map( ([ key, example ]) => {
-      let exampleValue = example
-      if ( example.toJS ) {
-        try {
-          exampleValue = JSON.stringify(example.toJS(), null, 2)
-        }
-        catch(e) {
-          exampleValue = String(example)
-        }
-      }
+      let exampleValue = stringify(example)
 
       return (<div key={ key }>
         <h5>{ key }</h5>
@@ -97,20 +110,29 @@ export default class Response extends React.Component {
     const ContentType = getComponent("contentType")
 
     var sampleResponse
+    var sampleSchema
     var schema, specPathWithPossibleSchema
 
+    const activeContentType = this.state.responseContentType || contentType
+
     if(isOAS3()) {
-      const schemaPath = List(["content", this.state.responseContentType, "schema"])
-      const oas3SchemaForContentType = response.getIn(schemaPath)
-      sampleResponse = oas3SchemaForContentType ? getSampleSchema(oas3SchemaForContentType.toJS(), this.state.responseContentType, {
-        includeReadOnly: true
-      }) : null
+      const mediaType = response.getIn(["content", activeContentType], Map({}))
+      const oas3SchemaForContentType = mediaType.get("schema")
+
+      if(mediaType.get("example") !== undefined) {
+        sampleSchema = stringify(mediaType.get("example"))
+      } else {
+        sampleSchema = getSampleSchema(oas3SchemaForContentType.toJS(), this.state.responseContentType, {
+          includeReadOnly: true
+        })
+      }
+      sampleResponse = oas3SchemaForContentType ? sampleSchema : null
       schema = oas3SchemaForContentType ? inferSchema(oas3SchemaForContentType.toJS()) : null
-      specPathWithPossibleSchema = oas3SchemaForContentType ? schemaPath : specPath
+      specPathWithPossibleSchema = oas3SchemaForContentType ? List(["content", this.state.responseContentType, "schema"]) : specPath
     } else {
       schema = inferSchema(response.toJS()) // TODO: don't convert back and forth. Lets just stick with immutable for inferSchema
       specPathWithPossibleSchema = response.has("schema") ? specPath.push("schema") : specPath
-      sampleResponse = schema ? getSampleSchema(schema, contentType, {
+      sampleResponse = schema ? getSampleSchema(schema, activeContentType, {
         includeReadOnly: true,
         includeWriteOnly: true // writeOnly has no filtering effect in swagger 2.0
        }) : null

From 3dc2620b2e9354114fcfa644114b279ff2fdcbc4 Mon Sep 17 00:00:00 2001
From: Kyle Shockey <shockey@users.noreply.github.com>
Date: Fri, 13 Jul 2018 21:43:24 -0700
Subject: [PATCH 05/11] use `example` in schema level example

---
 test/e2e/specs/features/example.swagger.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/test/e2e/specs/features/example.swagger.yaml b/test/e2e/specs/features/example.swagger.yaml
index 7823d9ff25c..12375993602 100644
--- a/test/e2e/specs/features/example.swagger.yaml
+++ b/test/e2e/specs/features/example.swagger.yaml
@@ -94,7 +94,7 @@ paths:
                       type: string
                     name:
                       type: string
-            x-example:
+            example:
               code: 201
               payload:
               - id: 1

From c5b5c04bed6f9cd18ad1c4cb0e6dae0adf11403e Mon Sep 17 00:00:00 2001
From: Kyle Shockey <shockey@users.noreply.github.com>
Date: Fri, 13 Jul 2018 22:03:24 -0700
Subject: [PATCH 06/11] refactor: move stringify to utils

---
 src/core/components/response.jsx | 23 +----------------------
 src/core/utils.js                | 21 +++++++++++++++++++++
 2 files changed, 22 insertions(+), 22 deletions(-)

diff --git a/src/core/components/response.jsx b/src/core/components/response.jsx
index 6e38ed67f80..286db3b02d2 100644
--- a/src/core/components/response.jsx
+++ b/src/core/components/response.jsx
@@ -3,28 +3,7 @@ import PropTypes from "prop-types"
 import ImPropTypes from "react-immutable-proptypes"
 import cx from "classnames"
 import { fromJS, Seq, Iterable, List, Map } from "immutable"
-import { getSampleSchema, fromJSOrdered } from "core/utils"
-
-const stringify = (thing) => {
-  if(typeof thing === "string") {
-    return thing
-  }
-
-  if (thing.toJS) {
-    thing = thing.toJS()
-  }
-
-  if(typeof thing === "object" && thing !== null) {
-    try {
-      return JSON.stringify(thing, null, 2)
-    }
-    catch (e) {
-      return String(thing)
-    }
-  }
-
-  return thing.toString()
-}
+import { getSampleSchema, fromJSOrdered, stringify } from "core/utils"
 
 const getExampleComponent = ( sampleResponse, examples, HighlightCode ) => {
   if ( examples && examples.size ) {
diff --git a/src/core/utils.js b/src/core/utils.js
index 9e4ddf9ef6e..248ef59406a 100644
--- a/src/core/utils.js
+++ b/src/core/utils.js
@@ -760,3 +760,24 @@ export function deeplyStripKey(input, keyToStrip, predicate = () => true) {
 
   return obj
 }
+
+export function stringify(thing) {
+  if (typeof thing === "string") {
+    return thing
+  }
+
+  if (thing.toJS) {
+    thing = thing.toJS()
+  }
+
+  if (typeof thing === "object" && thing !== null) {
+    try {
+      return JSON.stringify(thing, null, 2)
+    }
+    catch (e) {
+      return String(thing)
+    }
+  }
+
+  return thing.toString()
+}
\ No newline at end of file

From 172e2e59e06850dd93ccdffa75ceb7148961015d Mon Sep 17 00:00:00 2001
From: Kyle Shockey <shockey@users.noreply.github.com>
Date: Fri, 13 Jul 2018 22:05:12 -0700
Subject: [PATCH 07/11] prioritize media type examples in OAS3 request bodies

---
 src/core/plugins/oas3/components/request-body-editor.jsx | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/src/core/plugins/oas3/components/request-body-editor.jsx b/src/core/plugins/oas3/components/request-body-editor.jsx
index bb1364a2a94..c4af8096397 100644
--- a/src/core/plugins/oas3/components/request-body-editor.jsx
+++ b/src/core/plugins/oas3/components/request-body-editor.jsx
@@ -1,7 +1,7 @@
 import React, { PureComponent } from "react"
 import PropTypes from "prop-types"
 import { fromJS } from "immutable"
-import { getSampleSchema } from "core/utils"
+import { getSampleSchema, stringify } from "core/utils"
 
 const NOOP = Function.prototype
 
@@ -67,9 +67,11 @@ export default class RequestBodyEditor extends PureComponent {
 
   sample = (explicitMediaType) => {
     let { requestBody, mediaType } = this.props
-    let schema = requestBody.getIn(["content", explicitMediaType || mediaType, "schema"]).toJS()
+    let mediaTypeValue = requestBody.getIn(["content", explicitMediaType || mediaType])
+    let schema = mediaTypeValue.get("schema").toJS()
+    let mediaTypeExample = mediaTypeValue.get("example") !== undefined ? stringify(mediaTypeValue.get("example")) : null
 
-    return getSampleSchema(schema, explicitMediaType || mediaType, {
+    return mediaTypeExample || getSampleSchema(schema, explicitMediaType || mediaType, {
       includeWriteOnly: true
     })
   }

From b72e16f1a484e70252a2dc37e70cde854b2d085d Mon Sep 17 00:00:00 2001
From: Kyle Shockey <shockey@users.noreply.github.com>
Date: Fri, 13 Jul 2018 22:38:52 -0700
Subject: [PATCH 08/11] modify nightwatch config

---
 test/e2e/nightwatch.json | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/test/e2e/nightwatch.json b/test/e2e/nightwatch.json
index 57c1ddc3a98..37f943aa244 100644
--- a/test/e2e/nightwatch.json
+++ b/test/e2e/nightwatch.json
@@ -1,19 +1,17 @@
 {
   "src_folders" : ["test/e2e/scenarios"],
   "output_folder" : "reports",
+  "live_output": true,
   "custom_commands_path" : "",
   "custom_assertions_path" : "",
   "page_objects_path" : "test/e2e/pages",
   "globals_path" : "",
-  "test_workers" : {
-    "enabled" : true,
-    "workers" : "auto"
-  },
 
   "test_runner" : {
     "type" : "mocha",
     "options" : {
-      "ui" : "bdd"
+      "ui" : "bdd",
+      "reporter" : "list"
     }
   },
 

From 17b3514261ba582a4200b0e1d4b7c156b2d1ac10 Mon Sep 17 00:00:00 2001
From: Kyle Shockey <shockey@users.noreply.github.com>
Date: Fri, 13 Jul 2018 22:39:08 -0700
Subject: [PATCH 09/11] fix parameter/response regressions

---
 src/core/components/parameter-row.jsx | 4 +---
 src/core/components/response.jsx      | 2 +-
 2 files changed, 2 insertions(+), 4 deletions(-)

diff --git a/src/core/components/parameter-row.jsx b/src/core/components/parameter-row.jsx
index e9b3c1898ab..da2788c154a 100644
--- a/src/core/components/parameter-row.jsx
+++ b/src/core/components/parameter-row.jsx
@@ -37,7 +37,7 @@ export default class ParameterRow extends Component {
     let enumValue
 
     if(isOAS3()) {
-      let schema = rawParam.get("schema") || Map()
+      let schema = parameterWithMeta.get("schema") || Map()
       enumValue = schema.get("enum")
     } else {
       enumValue = parameterWithMeta ? parameterWithMeta.get("enum") : undefined
@@ -74,8 +74,6 @@ export default class ParameterRow extends Component {
       return
     }
 
-    let schema = specSelectors.isOAS3() ? paramWithMeta.get("schema", Map({})) : paramWithMeta
-
     if( paramWithMeta.get("in") !== "body" ) {
       let newValue
 
diff --git a/src/core/components/response.jsx b/src/core/components/response.jsx
index 286db3b02d2..58af705ec79 100644
--- a/src/core/components/response.jsx
+++ b/src/core/components/response.jsx
@@ -96,7 +96,7 @@ export default class Response extends React.Component {
 
     if(isOAS3()) {
       const mediaType = response.getIn(["content", activeContentType], Map({}))
-      const oas3SchemaForContentType = mediaType.get("schema")
+      const oas3SchemaForContentType = mediaType.get("schema", Map({}))
 
       if(mediaType.get("example") !== undefined) {
         sampleSchema = stringify(mediaType.get("example"))

From cec1b79995d1af87080f9284b23d7a301a7fa062 Mon Sep 17 00:00:00 2001
From: Kyle Shockey <shockey@users.noreply.github.com>
Date: Sat, 14 Jul 2018 00:04:40 -0700
Subject: [PATCH 10/11] reorder and broaden default value sources

---
 src/core/components/parameter-row.jsx      | 12 +++++++-----
 test/bugs/4557-default-parameter-values.js |  6 ++++--
 2 files changed, 11 insertions(+), 7 deletions(-)

diff --git a/src/core/components/parameter-row.jsx b/src/core/components/parameter-row.jsx
index da2788c154a..fe171f6acca 100644
--- a/src/core/components/parameter-row.jsx
+++ b/src/core/components/parameter-row.jsx
@@ -78,13 +78,15 @@ export default class ParameterRow extends Component {
       let newValue
 
       if (specSelectors.isSwagger2()) {
-        newValue = paramWithMeta.getIn(["schema", "default"])
-          || paramWithMeta.get("x-example")
+        newValue = paramWithMeta.get("x-example")
+          || paramWithMeta.getIn(["default"])
+          || paramWithMeta.getIn(["schema", "example"])
+          || paramWithMeta.getIn(["schema", "default"])
       } else if (specSelectors.isOAS3()) {
-        newValue = paramWithMeta.get("default")
-          || paramWithMeta.get("example")
+        newValue = paramWithMeta.get("example")
+          || paramWithMeta.getIn(["schema", "example"])
+          || paramWithMeta.getIn(["schema", "default"])
       }
-
       if(newValue !== undefined) {
         this.onChangeWrapper(newValue)
       }
diff --git a/test/bugs/4557-default-parameter-values.js b/test/bugs/4557-default-parameter-values.js
index aba5a7af215..ab63cf192a8 100644
--- a/test/bugs/4557-default-parameter-values.js
+++ b/test/bugs/4557-default-parameter-values.js
@@ -19,7 +19,8 @@ describe("bug #4557: default parameter values", function(){
       specSelectors: {
         security(){},
         parameterWithMetaByIdentity(){ return paramValue },
-        isOAS3(){ return false }
+        isOAS3(){ return false },
+        isSwagger2(){ return true }
       },
       fn: {},
       operation: {get: ()=>{}},
@@ -52,7 +53,8 @@ describe("bug #4557: default parameter values", function(){
       specSelectors: {
         security(){},
         parameterWithMetaByIdentity(){ return paramValue },
-        isOAS3(){ return true }
+        isOAS3(){ return true },
+        isSwagger2() { return false }
       },
       fn: {},
       operation: {get: ()=>{}},

From 991c32b2069c693955b942539b6aa5fb3a440a31 Mon Sep 17 00:00:00 2001
From: Kyle Shockey <shockey@users.noreply.github.com>
Date: Sat, 14 Jul 2018 00:04:58 -0700
Subject: [PATCH 11/11] update lockfile

---
 package-lock.json | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/package-lock.json b/package-lock.json
index 17a2715b085..0b4147e6ae9 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -4549,6 +4549,36 @@
         }
       }
     },
+    "eslint-plugin-import": {
+      "version": "2.13.0",
+      "resolved": "https://registry.npmjs.org/eslint-plugin-import/-/eslint-plugin-import-2.13.0.tgz",
+      "integrity": "sha512-t6hGKQDMIt9N8R7vLepsYXgDfeuhp6ZJSgtrLEDxonpSubyxUZHjhm6LsAaZX8q6GYVxkbT3kTsV9G5mBCFR6A==",
+      "dev": true,
+      "requires": {
+        "contains-path": "^0.1.0",
+        "debug": "^2.6.8",
+        "doctrine": "1.5.0",
+        "eslint-import-resolver-node": "^0.3.1",
+        "eslint-module-utils": "^2.2.0",
+        "has": "^1.0.1",
+        "lodash": "^4.17.4",
+        "minimatch": "^3.0.3",
+        "read-pkg-up": "^2.0.0",
+        "resolve": "^1.6.0"
+      },
+      "dependencies": {
+        "doctrine": {
+          "version": "1.5.0",
+          "resolved": "https://registry.npmjs.org/doctrine/-/doctrine-1.5.0.tgz",
+          "integrity": "sha1-N53Ocw9hZvds76TmcHoVmwLFpvo=",
+          "dev": true,
+          "requires": {
+            "esutils": "^2.0.2",
+            "isarray": "^1.0.0"
+          }
+        }
+      }
+    },
     "eslint-plugin-mocha": {
       "version": "4.12.1",
       "resolved": "https://registry.npmjs.org/eslint-plugin-mocha/-/eslint-plugin-mocha-4.12.1.tgz",