Move array-check for the 'examples' property to the TypeMapper

lib/schema-manager.js

@@ -439,12 +439,18 @@ class SchemaManager {
    * @returns {string}
    */
   _getAttributeExamples(attributeName, attributeProperties) {
+    // skip if user has not defined examples
     if (!this.constructor._hasCustomAttributeProperty(attributeProperties, 'examples')) {
-      return null; // user has not defined examples
+      return null;
     }
 
     const { examples } = attributeProperties.jsonSchema;
 
+    // see https://json-schema.org/understanding-json-schema/reference/generic.html
+    if (!Array.isArray(examples)) {
+      throw new TypeError("The 'examples' property MUST be an array");
+    }
+
     return _strategy.get(this).getPropertyExamples(examples);
   }
 }

lib/strategies/openapi-v3.js

@@ -72,10 +72,6 @@ class OpenApi3Strategy extends StrategyInterface {
    * @returns {object}
    */
   getPropertyExamples(examples) {
-    if (!Array.isArray(examples)) {
-      throw new TypeError("OpenAPI 3.0 requires type 'array' for the 'example' property");
-    }
-
     return {
       example: examples,
     };

lib/strategy-interface.js

@@ -7,15 +7,6 @@
  * @license Licensed under the MIT License
  */
 class StrategyInterface {
-  /**
-   * Must return the full URI to the strategy-specific online json (validation) schema.
-   *
-   * @returns {string}
-   */
-  getOnlineSchemaUri() {
-    this.constructor._throwMissingImplementationError(this.constructor.name, 'getOnlineSchemaUri');
-  }
-
   /**
    * Must return the property used as "schema".
    *

test/strategy-interface.test.js

@@ -12,7 +12,7 @@ describe('StrategyInterface', function() {
     const methodCount = Object.getOwnPropertyNames(StrategyInterface.prototype).length - 1; // excluding the constructor
 
     it(`8 interface methods`, function() {
-      expect(methodCount).toEqual(9);
+      expect(methodCount).toEqual(8);
     });
   });