feature/setMany

README.md

@@ -151,6 +151,17 @@ dotProp.set(obj, 'foo.$end', 'platin-unicorn')
 
 ```
 
+### setMany
+
+Set multiple nested values by passing a map of path: value
+
+```javascript
+// Setter
+var obj = { foo: { bar: 'a' } };
+// var obj2 = dotProp.set(dotProp.set(obj, 'foo.bar', 'b') , 'foo.baz', 'x');
+var obj2 = dotProp.setMany(obj, { 'foo.bar': 'b', 'foo.baz': 'x' });
+//obj2 => {foo: {bar: 'b', baz: 'x'}}
+```
 
 ### delete
 

index.d.ts

@@ -1,9 +1,12 @@
+type Path = number | string | (string | number)[];
+
 interface DotPropImmutable {
-  get<I, T = any>(source: I, path: number | string | (string | number)[], defaultValue?: any): T;
-  set<I, T = any>(source: I, path: number | string | (string | number)[], value: any): T;
-  delete<I, T = any>(source: I, path: number | string | (string | number)[]): Partial<T>;
-  toggle<I, T = any>(source: I, path: number | string | (string | number)[]): T;
-  merge<I, T = any>(source: I, path: number | string | (string | number)[], value: any): T;
+  get<I, T = any>(source: I, path: Path, defaultValue?: any): T;
+  set<I, T = any>(source: I, path: Path, value: any): T;
+  setMany<I, T = any>(source, paths: Path[]): T;
+  delete<I, T = any>(source: I, path: Path): Partial<T>;
+  toggle<I, T = any>(source: I, path: Path): T;
+  merge<I, T = any>(source: I, path: Path, value: any): T;
 }
 
 declare const dotPropImmutable: DotPropImmutable;

lib/index.js

@@ -27,6 +27,18 @@ function set(obj, prop, value) {
 	return setPropImmutableRec(obj, prop, value, 0);
 }
 
+
+/**
+ * Set many values defined in a map on the obj
+ * @param obj
+ * @param map
+ */
+function setMany(obj, map) {
+	return Object.keys(map).reduce((acc, path) => {
+		return set(acc, path, map[path]);
+	}, obj);
+}
+
 /**
  * Get a value by a dot path.
  * @param obj The object to evaluate.
@@ -169,5 +181,6 @@ module.exports = {
 	get,
 	delete: _delete,
 	toggle,
-	merge
+	merge,
+	setMany
 };

test/dot-prop-immutable.spec.js

@@ -307,6 +307,21 @@ describe('dot-prop-immutable.spec.js', () => {
 		});
 	});
 
+	describe('when setMany', () => {
+
+		it('Sets a map of elements', () => {
+			expect(dotProp.setMany({ foo: 0, bar: { baz: 1 } }, { foo: 2, 'bar.baz': 3 })).to.eql(
+				{ foo: 2, bar: { baz: 3 } }
+			);
+		});
+
+		it('Sets a map of elements un existent', () => {
+			expect(dotProp.setMany({}, { foo: 2, 'bar.baz': 3 })).to.eql(
+				{ foo: 2, bar: { baz: 3 } }
+			);
+		});
+	});
+
 	describe('when get', () => {
 
 		describe('when have an object', () => {