Added configuration option to turn off unmapped warnings, globally.

Author: cdibbs

package.json

@@ -1,7 +1,7 @@
 {
   "name": "simple-mapper",
   "description": "Angular 2+ object-to-view-model mapper. Intended to facilitate working with JSON from web API endpoints.",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "license": "MIT",
   "repository": "https://github.com/cdibbs/simple-mapper",
   "scripts": {

src/app/services/i/i-config.ts

@@ -9,4 +9,7 @@ export interface IConfig {
 
     /** Validate mapping configuration on startup. Default: false. */
     validateOnStartup?: boolean;
+
+    /** Turn off unmapped warnings globally. Can be overridden at the method level. */
+    noUnmappedWarnings?: boolean;
 }

src/app/services/mapper.service.spec.ts

@@ -120,12 +120,9 @@ describe('MapperService', () => {
             Two: 6.53, // ignored
         };
         var result = mapper.MapJsonToVM(vm.MineMinusTwo, json, false);
-        expect(result.Id).toBe(3);
-        expect(result.One).toBe(json.One);
-        expect(result["Two"]).toBeUndefined();
         expect(warned).toBeNull();
     }));
-    it('should warn when extraneous source properties.',
+    it('should warn when extraneous source properties, by default.',
     inject([MapperService], (mapper: MapperService) => {
         var warned = null;
         mapper["log"].warn = function(yep) { warned = yep; };
@@ -135,9 +132,45 @@ describe('MapperService', () => {
             Two: 6.53, // ignored
         };
         var result = mapper.MapJsonToVM(vm.MineMinusTwo, json);
-        expect(result.Id).toBe(3);
-        expect(result.One).toBe(json.One);
-        expect(result["Two"]).toBeUndefined();
+        expect(warned).toBeTruthy();
+    }));
+    it('should warn when extraneous source properties when global=off, method=on (overrides global).',
+    inject([MapperService], (mapper: MapperService) => {
+        var warned = null;
+        mapper["noUnmappedWarnings"] = true;
+        mapper["log"].warn = function(yep) { warned = yep; };
+        var json = {
+            Id: 3,
+            One: "something else",
+            Two: 6.53, // ignored
+        };
+        var result = mapper.MapJsonToVM(vm.MineMinusTwo, json, true);
+        expect(warned).toBeTruthy();
+    }));
+    it('should not warn when extraneous source properties when global=on, method=off (overrides global).',
+    inject([MapperService], (mapper: MapperService) => {
+        var warned = null;
+        mapper["noUnmappedWarnings"] = false;
+        mapper["log"].warn = function(yep) { warned = yep; };
+        var json = {
+            Id: 3,
+            One: "something else",
+            Two: 6.53, // ignored
+        };
+        var result = mapper.MapJsonToVM(vm.MineMinusTwo, json, false);
+        expect(warned).toBeFalsy();
+    }));
+    it('should warn when extraneous source properties when global=on, method=on (overrides global).',
+    inject([MapperService], (mapper: MapperService) => {
+        var warned = null;
+        mapper["noUnmappedWarnings"] = false;
+        mapper["log"].warn = function(yep) { warned = yep; };
+        var json = {
+            Id: 3,
+            One: "something else",
+            Two: 6.53, // ignored
+        };
+        var result = mapper.MapJsonToVM(vm.MineMinusTwo, json, true);
         expect(warned).toBeTruthy();
     }));
     it('should not warn when not extraneous source properties.',

src/app/services/mapper.service.ts

@@ -11,11 +11,13 @@ export let MapperConfiguration = new InjectionToken<IConfig>("MapperConfiguratio
 export class MapperService implements IMapperService {
     private viewModels: { [key: string]: any };
     private log: ILogService;
+    private noUnmappedWarnings: boolean;
 
     public constructor(@Inject(MapperConfiguration) private config: IConfig)
     {
         this.viewModels = config.viewModels || {};
         this.log = config.logger || console;
+        this.noUnmappedWarnings = !!config.noUnmappedWarnings; 
         if (config.validateOnStartup) {
             this.validate();
         }
@@ -30,12 +32,12 @@ export class MapperService implements IMapperService {
      * @return {T} The constructed view model with all of its properties mapped from the source json.
      * @example MapJsonToVM(UserViewModel, userJson);
      */
-    public MapJsonToVM<T extends { [key: string]: any }>(t: { new (): T }, json: any, unmappedWarning = true): T {
+    public MapJsonToVM<T extends { [key: string]: any }>(t: { new (): T }, json: any, unmappedWarning = undefined): T {
         let vm = new t();
         let tprops = getMappableProperties(vm);
         let keys = Object.keys(json || {});
 
-        if (unmappedWarning) {
+        if (unmappedWarning === true || (unmappedWarning === undefined && ! this.noUnmappedWarnings)) {
             let t2props = Object.keys(vm);
             let unmapped = keys.filter(k => Object.keys(tprops).indexOf(k) < 0 && t2props.indexOf(k) < 0);
             if (unmapped.length)