		body, html {
		margin:0; padding: 0;
		height: 100%;
		}
		body {
		font-family: Helvetica Neue, Helvetica, Arial;
		font-size: 14px;
		color:#333;
		}
		.small { font-size: 12px; }
		, :after, *:before {
		-webkit-box-sizing:border-box;
		-moz-box-sizing:border-box;
		box-sizing:border-box;
		}
		h1 { font-size: 20px; margin: 0;}
		h2 { font-size: 14px; }
		pre {
		font: 12px/1.4 Consolas, "Liberation Mono", Menlo, Courier, monospace;
		margin: 0;
		padding: 0;
		-moz-tab-size: 2;
		-o-tab-size: 2;
		tab-size: 2;
		}
		a { color:#0074D9; text-decoration:none; }
		a:hover { text-decoration:underline; }
		.strong { font-weight: bold; }
		.space-top1 { padding: 10px 0 0 0; }
		.pad2y { padding: 20px 0; }
		.pad1y { padding: 10px 0; }
		.pad2x { padding: 0 20px; }
		.pad2 { padding: 20px; }
		.pad1 { padding: 10px; }
		.space-left2 { padding-left:55px; }
		.space-right2 { padding-right:20px; }
		.center { text-align:center; }
		.clearfix { display:block; }
		.clearfix:after {
		content:'';
		display:block;
		height:0;
		clear:both;
		visibility:hidden;
		}
		.fl { float: left; }
		@media only screen and (max-width:640px) {
		.col3 { width:100%; max-width:100%; }
		.hide-mobile { display:none!important; }
		}

		.quiet {
		color: #7f7f7f;
		color: rgba(0,0,0,0.5);
		}
		.quiet a { opacity: 0.7; }

		.fraction {
		font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace;
		font-size: 10px;
		color: #555;
		background: #E8E8E8;
		padding: 4px 5px;
		border-radius: 3px;
		vertical-align: middle;
		}

		div.path a:link, div.path a:visited { color: #333; }
		table.coverage {
		border-collapse: collapse;
		margin: 10px 0 0 0;
		padding: 0;
		}

		table.coverage td {
		margin: 0;
		padding: 0;
		vertical-align: top;
		}
		table.coverage td.line-count {
		text-align: right;
		padding: 0 5px 0 20px;
		}
		table.coverage td.line-coverage {
		text-align: right;
		padding-right: 10px;
		min-width:20px;
		}

		table.coverage td span.cline-any {
		display: inline-block;
		padding: 0 5px;
		width: 100%;
		}
		.missing-if-branch {
		display: inline-block;
		margin-right: 5px;
		border-radius: 3px;
		position: relative;
		padding: 0 4px;
		background: #333;
		color: yellow;
		}

		.skip-if-branch {
		display: none;
		margin-right: 10px;
		position: relative;
		padding: 0 4px;
		background: #ccc;
		color: white;
		}
		.missing-if-branch .typ, .skip-if-branch .typ {
		color: inherit !important;
		}
		.coverage-summary {
		border-collapse: collapse;
		width: 100%;
		}
		.coverage-summary tr { border-bottom: 1px solid #bbb; }
		.keyline-all { border: 1px solid #ddd; }
		.coverage-summary td, .coverage-summary th { padding: 10px; }
		.coverage-summary tbody { border: 1px solid #bbb; }
		.coverage-summary td { border-right: 1px solid #bbb; }
		.coverage-summary td:last-child { border-right: none; }
		.coverage-summary th {
		text-align: left;
		font-weight: normal;
		white-space: nowrap;
		}
		.coverage-summary th.file { border-right: none !important; }
		.coverage-summary th.pct { }
		.coverage-summary th.pic,
		.coverage-summary th.abs,
		.coverage-summary td.pct,
		.coverage-summary td.abs { text-align: right; }
		.coverage-summary td.file { white-space: nowrap; }
		.coverage-summary td.pic { min-width: 120px !important; }
		.coverage-summary tfoot td { }

		.coverage-summary .sorter {
		height: 10px;
		width: 7px;
		display: inline-block;
		margin-left: 0.5em;
		background: url(sort-arrow-sprite.png) no-repeat scroll 0 0 transparent;
		}
		.coverage-summary .sorted .sorter {
		background-position: 0 -20px;
		}
		.coverage-summary .sorted-desc .sorter {
		background-position: 0 -10px;
		}
		.status-line { height: 10px; }
		/* dark red */
		.red.solid, .status-line.low, .low .cover-fill { background:#C21F39 }
		.low .chart { border:1px solid #C21F39 }
		/* medium red */
		.cstat-no, .fstat-no, .cbranch-no, .cbranch-no { background:#F6C6CE }
		/* light red */
		.low, .cline-no { background:#FCE1E5 }
		/* light green */
		.high, .cline-yes { background:rgb(230,245,208) }
		/* medium green */
		.cstat-yes { background:rgb(161,215,106) }
		/* dark green */
		.status-line.high, .high .cover-fill { background:rgb(77,146,33) }
		.high .chart { border:1px solid rgb(77,146,33) }


		.medium .chart { border:1px solid #666; }
		.medium .cover-fill { background: #666; }

		.cbranch-no { background: yellow !important; color: #111; }

		.cstat-skip { background: #ddd; color: #111; }
		.fstat-skip { background: #ddd; color: #111 !important; }
		.cbranch-skip { background: #ddd !important; color: #111; }

		span.cline-neutral { background: #eaeaea; }
		.medium { background: #eaeaea; }

		.cover-fill, .cover-empty {
		display:inline-block;
		height: 12px;
		}
		.chart {
		line-height: 0;
		}
		.cover-empty {
		background: white;
		}
		.cover-full {
		border-right: none !important;
		}
		pre.prettyprint {
		border: none !important;
		padding: 0 !important;
		margin: 0 !important;
		}
		.com { color: #999 !important; }
		.ignore-none { color: #999; font-weight: normal; }

		.wrapper {
		min-height: 100%;
		height: auto !important;
		height: 100%;
		margin: 0 auto -48px;
		}
		.footer, .push {
		height: 48px;
		}

+93

coverage/lcov-report/index.html

		<!doctype html>
		<html lang="en">
		<head>
		<title>Code coverage report for All files</title>
		<meta charset="utf-8" />
		<link rel="stylesheet" href="prettify.css" />
		<link rel="stylesheet" href="base.css" />
		<meta name="viewport" content="width=device-width, initial-scale=1">
		<style type='text/css'>
		.coverage-summary .sorter {
		background-image: url(sort-arrow-sprite.png);
		}
		</style>
		</head>
		<body>
		<div class='wrapper'>
		<div class='pad1'>
		<h1>
		All files
		</h1>
		<div class='clearfix'>
		<div class='fl pad1y space-right2'>
		<span class="strong">100% </span>
		<span class="quiet">Statements</span>
		<span class='fraction'>9/9</span>
		</div>
		<div class='fl pad1y space-right2'>
		<span class="strong">100% </span>
		<span class="quiet">Branches</span>
		<span class='fraction'>9/9</span>
		</div>
		<div class='fl pad1y space-right2'>
		<span class="strong">100% </span>
		<span class="quiet">Functions</span>
		<span class='fraction'>5/5</span>
		</div>
		<div class='fl pad1y space-right2'>
		<span class="strong">100% </span>
		<span class="quiet">Lines</span>
		<span class='fraction'>9/9</span>
		</div>
		</div>
		</div>
		<div class='status-line high'></div>
		<div class="pad1">
		<table class="coverage-summary">
		<thead>
		<tr>
		<th data-col="file" data-fmt="html" data-html="true" class="file">File</th>
		<th data-col="pic" data-type="number" data-fmt="html" data-html="true" class="pic"></th>
		<th data-col="statements" data-type="number" data-fmt="pct" class="pct">Statements</th>
		<th data-col="statements_raw" data-type="number" data-fmt="html" class="abs"></th>
		<th data-col="branches" data-type="number" data-fmt="pct" class="pct">Branches</th>
		<th data-col="branches_raw" data-type="number" data-fmt="html" class="abs"></th>
		<th data-col="functions" data-type="number" data-fmt="pct" class="pct">Functions</th>
		<th data-col="functions_raw" data-type="number" data-fmt="html" class="abs"></th>
		<th data-col="lines" data-type="number" data-fmt="pct" class="pct">Lines</th>
		<th data-col="lines_raw" data-type="number" data-fmt="html" class="abs"></th>
		</tr>
		</thead>
		<tbody><tr>
		<td class="file high" data-value="object-utils.js"><a href="object-utils.js.html">object-utils.js</a></td>
		<td data-value="100" class="pic high"><div class="chart"><div class="cover-fill cover-full" style="width: 100%;"></div><div class="cover-empty" style="width:0%;"></div></div></td>
		<td data-value="100" class="pct high">100%</td>
		<td data-value="9" class="abs high">9/9</td>
		<td data-value="100" class="pct high">100%</td>
		<td data-value="9" class="abs high">9/9</td>
		<td data-value="100" class="pct high">100%</td>
		<td data-value="5" class="abs high">5/5</td>
		<td data-value="100" class="pct high">100%</td>
		<td data-value="9" class="abs high">9/9</td>
		</tr>

		</tbody>
		</table>
		</div><div class='push'></div><!-- for sticky footer -->
		</div><!-- /wrapper -->
		<div class='footer quiet pad2 space-top1 center small'>
		Code coverage
		generated by <a href="https://istanbul.js.org/" target="_blank">istanbul</a> at Thu Nov 02 2017 14:13:10 GMT+1300 (NZDT)
		</div>
		</div>
		<script src="prettify.js"></script>
		<script>
		window.onload = function () {
		if (typeof prettyPrint === 'function') {
		prettyPrint();
		}
		};
		</script>
		<script src="sorter.js"></script>
		</body>
		</html>

+266

coverage/lcov-report/object-utils.js.html

		<!doctype html>
		<html lang="en">
		<head>
		<title>Code coverage report for object-utils.js</title>
		<meta charset="utf-8" />
		<link rel="stylesheet" href="prettify.css" />
		<link rel="stylesheet" href="base.css" />
		<meta name="viewport" content="width=device-width, initial-scale=1">
		<style type='text/css'>
		.coverage-summary .sorter {
		background-image: url(sort-arrow-sprite.png);
		}
		</style>
		</head>
		<body>
		<div class='wrapper'>
		<div class='pad1'>
		<h1>
		<a href="index.html">All files</a> object-utils.js
		</h1>
		<div class='clearfix'>
		<div class='fl pad1y space-right2'>
		<span class="strong">100% </span>
		<span class="quiet">Statements</span>
		<span class='fraction'>9/9</span>
		</div>
		<div class='fl pad1y space-right2'>
		<span class="strong">100% </span>
		<span class="quiet">Branches</span>
		<span class='fraction'>9/9</span>
		</div>
		<div class='fl pad1y space-right2'>
		<span class="strong">100% </span>
		<span class="quiet">Functions</span>
		<span class='fraction'>5/5</span>
		</div>
		<div class='fl pad1y space-right2'>
		<span class="strong">100% </span>
		<span class="quiet">Lines</span>
		<span class='fraction'>9/9</span>
		</div>
		</div>
		</div>
		<div class='status-line high'></div>
		<pre><table class="coverage">
		<tr><td class="line-count quiet">1
		2
		3
		4
		5
		6
		7
		8
		9
		10
		11
		12
		13
		14
		15
		16
		17
		18
		19
		20
		21
		22
		23
		24
		25
		26
		27
		28
		29
		30
		31
		32
		33
		34
		35
		36
		37
		38
		39
		40
		41
		42
		43
		44
		45
		46
		47
		48
		49
		50
		51
		52
		53
		54
		55
		56
		57
		58
		59
		60
		61
		62
		63
		64
		65
		66
		67
		68</td><td class="line-coverage quiet"><span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-yes">6x</span>
		<span class="cline-any cline-yes">7x</span>
		<span class="cline-any cline-yes">5x</span>
		<span class="cline-any cline-yes">8x</span>
		<span class="cline-any cline-yes">8x</span>
		<span class="cline-any cline-yes">8x</span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-yes">6x</span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-yes">3x</span>
		<span class="cline-any cline-yes">5x</span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span>
		<span class="cline-any cline-neutral"> </span></td><td class="text"><pre class="prettyprint lang-js">/*
		* Copyright 2017, Emanuel Rabina (http://www.ultraq.net.nz/)
		*
		* Licensed under the Apache License, Version 2.0 (the "License");
		* you may not use this file except in compliance with the License.
		* You may obtain a copy of the License at
		*
		* http://www.apache.org/licenses/LICENSE-2.0
		*
		* Unless required by applicable law or agreed to in writing, software
		* distributed under the License is distributed on an "AS IS" BASIS,
		* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
		* See the License for the specific language governing permissions and
		* limitations under the License.
		*/

		/**
		* Deep-merges all of the properties of the objects in `sources` with `target`,
		* modifying the target object and returning it.
		*
		* @param {Object} target
		* @param {...Object} sources
		* @return {Object} The modified target object.
		*/
		export function merge(target = {}, ...sources) {

		sources.forEach(source => {
		if (source) {
		Object.keys(source).forEach(key => {
		let targetValue = target[key];
		let sourceValue = source[key];
		target[key] = targetValue instanceof Object && sourceValue instanceof Object ?
		merge(targetValue, sourceValue) :
		sourceValue;
		});
		}
		});
		return target;
		}

		/**
		* Returns a value from an object via a path string that describes the nesting
		* of objects to get to the value.
		*
		* eg:
		*
		* ```
		* let object = {
		* greeting: {
		* message: 'Hello!'
		* }
		* };
		* let pathToMessage = 'greeting.message';
		* ```
		*
		* @param {Object} object
		* @param {String} path A dot-separated string of paths to get to the desired
		* value within the object
		* @return {Object} The value at the given path within the object, or
		* `undefined` if the path doesn't resolve within the object.
		*/
		export function navigate(object, path) {

		return path.split('.').reduce((previousValue, pathToken) => {
		return previousValue && previousValue[pathToken];
		}, object);
		}
		</pre></td></tr>
		</table></pre>
		<div class='push'></div><!-- for sticky footer -->
		</div><!-- /wrapper -->
		<div class='footer quiet pad2 space-top1 center small'>
		Code coverage
		generated by <a href="https://istanbul.js.org/" target="_blank">istanbul</a> at Thu Nov 02 2017 14:13:10 GMT+1300 (NZDT)
		</div>
		</div>
		<script src="prettify.js"></script>
		<script>
		window.onload = function () {
		if (typeof prettyPrint === 'function') {
		prettyPrint();
		}
		};
		</script>
		<script src="sorter.js"></script>
		</body>
		</html>

+1

coverage/lcov-report/prettify.css

.pln{color:#000}@media screen{.str{color:#080}.kwd{color:#008}.com{color:#800}.typ{color:#606}.lit{color:#066}.pun,.opn,.clo{color:#660}.tag{color:#008}.atn{color:#606}.atv{color:#080}.dec,.var{color:#606}.fun{color:red}}@media print,projection{.str{color:#060}.kwd{color:#006;font-weight:bold}.com{color:#600;font-style:italic}.typ{color:#404;font-weight:bold}.lit{color:#044}.pun,.opn,.clo{color:#440}.tag{color:#006;font-weight:bold}.atn{color:#404}.atv{color:#060}}pre.prettyprint{padding:2px;border:1px solid #888}ol.linenums{margin-top:0;margin-bottom:0}li.L0,li.L1,li.L2,li.L3,li.L5,li.L6,li.L7,li.L8{list-style-type:none}li.L1,li.L3,li.L5,li.L7,li.L9{background:#eee}

+1

coverage/lcov-report/prettify.js

coverage/lcov-report/sort-arrow-sprite.png

Sorry, the diff of this file is not supported yet

+158

coverage/lcov-report/sorter.js

		var addSorting = (function () {
		"use strict";
		var cols,
		currentSort = {
		index: 0,
		desc: false
		};

		// returns the summary table element
		function getTable() { return document.querySelector('.coverage-summary'); }
		// returns the thead element of the summary table
		function getTableHeader() { return getTable().querySelector('thead tr'); }
		// returns the tbody element of the summary table
		function getTableBody() { return getTable().querySelector('tbody'); }
		// returns the th element for nth column
		function getNthColumn(n) { return getTableHeader().querySelectorAll('th')[n]; }

		// loads all columns
		function loadColumns() {
		var colNodes = getTableHeader().querySelectorAll('th'),
		colNode,
		cols = [],
		col,
		i;

		for (i = 0; i < colNodes.length; i += 1) {
		colNode = colNodes[i];
		col = {
		key: colNode.getAttribute('data-col'),
		sortable: !colNode.getAttribute('data-nosort'),
		type: colNode.getAttribute('data-type') \|\| 'string'
		};
		cols.push(col);
		if (col.sortable) {
		col.defaultDescSort = col.type === 'number';
		colNode.innerHTML = colNode.innerHTML + '<span class="sorter"></span>';
		}
		}
		return cols;
		}
		// attaches a data attribute to every tr element with an object
		// of data values keyed by column name
		function loadRowData(tableRow) {
		var tableCols = tableRow.querySelectorAll('td'),
		colNode,
		col,
		data = {},
		i,
		val;
		for (i = 0; i < tableCols.length; i += 1) {
		colNode = tableCols[i];
		col = cols[i];
		val = colNode.getAttribute('data-value');
		if (col.type === 'number') {
		val = Number(val);
		}
		data[col.key] = val;
		}
		return data;
		}
		// loads all row data
		function loadData() {
		var rows = getTableBody().querySelectorAll('tr'),
		i;

		for (i = 0; i < rows.length; i += 1) {
		rows[i].data = loadRowData(rows[i]);
		}
		}
		// sorts the table using the data for the ith column
		function sortByIndex(index, desc) {
		var key = cols[index].key,
		sorter = function (a, b) {
		a = a.data[key];
		b = b.data[key];
		return a < b ? -1 : a > b ? 1 : 0;
		},
		finalSorter = sorter,
		tableBody = document.querySelector('.coverage-summary tbody'),
		rowNodes = tableBody.querySelectorAll('tr'),
		rows = [],
		i;

		if (desc) {
		finalSorter = function (a, b) {
		return -1 * sorter(a, b);
		};
		}

		for (i = 0; i < rowNodes.length; i += 1) {
		rows.push(rowNodes[i]);
		tableBody.removeChild(rowNodes[i]);
		}

		rows.sort(finalSorter);

		for (i = 0; i < rows.length; i += 1) {
		tableBody.appendChild(rows[i]);
		}
		}
		// removes sort indicators for current column being sorted
		function removeSortIndicators() {
		var col = getNthColumn(currentSort.index),
		cls = col.className;

		cls = cls.replace(/ sorted$/, '').replace(/ sorted-desc$/, '');
		col.className = cls;
		}
		// adds sort indicators for current column being sorted
		function addSortIndicators() {
		getNthColumn(currentSort.index).className += currentSort.desc ? ' sorted-desc' : ' sorted';
		}
		// adds event listeners for all sorter widgets
		function enableUI() {
		var i,
		el,
		ithSorter = function ithSorter(i) {
		var col = cols[i];

		return function () {
		var desc = col.defaultDescSort;

		if (currentSort.index === i) {
		desc = !currentSort.desc;
		}
		sortByIndex(i, desc);
		removeSortIndicators();
		currentSort.index = i;
		currentSort.desc = desc;
		addSortIndicators();
		};
		};
		for (i =0 ; i < cols.length; i += 1) {
		if (cols[i].sortable) {
		// add the click event handler on the th so users
		// dont have to click on those tiny arrows
		el = getNthColumn(i).querySelector('.sorter').parentElement;
		if (el.addEventListener) {
		el.addEventListener('click', ithSorter(i));
		} else {
		el.attachEvent('onclick', ithSorter(i));
		}
		}
		}
		}
		// adds sorting functionality to the UI
		return function () {
		if (!getTable()) {
		return;
		}
		cols = loadColumns();
		loadData(cols);
		addSortIndicators();
		enableUI();
		};
		})();

		window.addEventListener('load', addSorting);

coverage/lcov.info

Sorry, the diff of this file is not supported yet

+9

jest.config.js

		/* eslint-env node */
		'use strict'; // eslint-disable-line

		module.exports = {
		collectCoverage: true,
		coverageReporters: [
		'lcov', 'text-summary'
		]
		};

+136

object-utils.test.js

		/*
		* Copyright 2017, Emanuel Rabina (http://www.ultraq.net.nz/)
		*
		* Licensed under the Apache License, Version 2.0 (the "License");
		* you may not use this file except in compliance with the License.
		* You may obtain a copy of the License at
		*
		* http://www.apache.org/licenses/LICENSE-2.0
		*
		* Unless required by applicable law or agreed to in writing, software
		* distributed under the License is distributed on an "AS IS" BASIS,
		* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
		* See the License for the specific language governing permissions and
		* limitations under the License.
		*/

		/* eslint-env jest */
		import {merge, navigate} from './object-utils';

		/**
		* Tests for the object utilities.
		*/
		describe('ObjectUtils', function() {

		describe('#merge', function() {

		test('Merge values from a source object into a target one', function() {
		let target = {
		prop1: 'some property',
		prop2: 'this one gets replaced'
		};
		let source = {
		prop2: 'replaced!',
		prop3: 'some other property'
		};
		target = merge(target, source);
		expect(target).toEqual({
		prop1: 'some property',
		prop2: 'replaced!',
		prop3: 'some other property'
		});
		});

		test('Deep-merge objects too', function() {
		let target = {
		obj1: {
		prop1: 'object property'
		}
		};
		let source = {
		obj1: {
		prop2: 'another object property'
		}
		};
		target = merge(target, source);
		expect(target).toEqual({
		obj1: {
		prop1: 'object property',
		prop2: 'another object property'
		}
		});
		});

		test('Deep-merge multiple source objects', function() {
		let target = {
		prop1: 'some property',
		prop2: "this one doesn't get replaced"
		};
		let source1 = {
		prop2: "I'm not replacing you!",
		prop3: 'some other property'
		};
		let source2 = {
		prop1: {
		deepProp: 'Hello!'
		},
		prop2: "I'm totally replacing you!"
		};
		target = merge(target, source1, source2);
		expect(target).toEqual({
		prop1: {
		deepProp: 'Hello!'
		},
		prop2: "I'm totally replacing you!",
		prop3: 'some other property'
		});
		});

		test('Falsey sources are treated as no-ops', function() {
		let target = {
		prop: 'Hi!'
		};
		target = merge(target, null, undefined);
		expect(target).toEqual({
		prop: 'Hi!'
		});
		});

		test('An undefined target is an empty object', function() {
		let target = undefined;
		target = merge(target);
		expect(target).toEqual({});
		});
		});

		describe('#navigate', function() {

		test('Returns a shallow value', function() {
		let object = {
		greeting: 'Hello!'
		};
		let result = navigate(object, 'greeting');
		expect(result).toBe(object.greeting);
		});

		test('Returns a nested value', function() {
		let object = {
		greetings: {
		morning: {
		informal: 'Morning!'
		}
		}
		};
		let result = navigate(object, 'greetings.morning.informal');
		expect(result).toBe(object.greetings.morning.informal);
		});

		test('Mismatched path returns `undefined`', function() {
		let object = {
		greeting: 'Hello!'
		};
		let result = navigate(object, 'nothing');
		expect(result).toBeUndefined();
		});
		});
		});

+28

-0

object-utils.js

		@@ -40,1 +40,29 @@ /*
		}

		/**
		* Returns a value from an object via a path string that describes the nesting
		* of objects to get to the value.
		*
		* eg:
		*
		* ```
		* let object = {
		* greeting: {
		* message: 'Hello!'
		* }
		* };
		* let pathToMessage = 'greeting.message';
		* ```
		*
		* @param {Object} object
		* @param {String} path A dot-separated string of paths to get to the desired
		* value within the object
		* @return {Object} The value at the given path within the object, or
		* `undefined` if the path doesn't resolve within the object.
		*/
		export function navigate(object, path) {

		return path.split('.').reduce((previousValue, pathToken) => {
		return previousValue && previousValue[pathToken];
		}, object);
		}

+42

-15

object-utils.node.js

		'use strict';

		Object.defineProperty(exports, '__esModule', { value: true });

		Object.defineProperty(exports, "__esModule", {
		value: true
		});
		exports.merge = merge;
		exports.navigate = navigate;
		/*
		@@ -31,16 +34,40 @@ * Copyright 2017, Emanuel Rabina (http://www.ultraq.net.nz/)

		sources.forEach(source => {
		if (source) {
		Object.keys(source).forEach(key => {
		let targetValue = target[key];
		let sourceValue = source[key];
		target[key] = targetValue instanceof Object && sourceValue instanceof Object ?
		merge(targetValue, sourceValue) :
		sourceValue;
		});
		}
		});
		return target;
		sources.forEach(source => {
		if (source) {
		Object.keys(source).forEach(key => {
		let targetValue = target[key];
		let sourceValue = source[key];
		target[key] = targetValue instanceof Object && sourceValue instanceof Object ? merge(targetValue, sourceValue) : sourceValue;
		});
		}
		});
		return target;
		}

		exports.merge = merge;
		/**
		* Returns a value from an object via a path string that describes the nesting
		* of objects to get to the value.
		*
		* eg:
		*
		* ```
		* let object = {
		* greeting: {
		* message: 'Hello!'
		* }
		* };
		* let pathToMessage = 'greeting.message';
		* ```
		*
		* @param {Object} object
		* @param {String} path A dot-separated string of paths to get to the desired
		* value within the object
		* @return {Object} The value at the given path within the object, or
		* `undefined` if the path doesn't resolve within the object.
		*/
		function navigate(object, path) {

		return path.split('.').reduce((previousValue, pathToken) => {
		return previousValue && previousValue[pathToken];
		}, object);
		}

+13

-12

package.json

		{
		"name": "@ultraq/object-utils",
		"version": "1.1.1",
		"version": "1.2.0",
		"description": "A collection of utilities for JavaScript objects",
		@@ -14,3 +14,4 @@ "author": "Emanuel Rabina <emanuelrabina@gmail.com> (http://www.ultraq.net.nz/)",
		"utilities",
		"merge"
		"merge",
		"navigate"
		],
		@@ -20,16 +21,16 @@ "main": "object-utils.node.js",
		"scripts": {
		"build": "rollup --input object-utils.js --format cjs --output object-utils.node.js",
		"lint": "eslint object-utils.js test",
		"test": "npm run lint && mocha --require babel-register",
		"lint": "eslint '*.js'",
		"test": "npm run lint && jest",
		"coverage": "cat ./coverage/lcov.info \| coveralls",
		"build": "babel object-utils.js --out-file object-utils.node.js",
		"prepublish": "npm run build"
		},
		"devDependencies": {
		"babel-plugin-transform-es2015-modules-umd": "^6.24.1",
		"babel-register": "^6.24.1",
		"chai": "^3.5.0",
		"eslint": "^3.19.0",
		"eslint-config-ultraq": "^1.0.1",
		"mocha": "^3.2.0",
		"rollup": "^0.41.6"
		"babel-cli": "^6.26.0",
		"babel-plugin-transform-es2015-modules-commonjs": "^6.26.0",
		"coveralls": "^2.13.1",
		"eslint": "^4.8.0",
		"eslint-config-ultraq": "^2.0.0",
		"jest": "^21.2.1"
		}
		}

+21

-0

README.md

		@@ -6,2 +6,3 @@
		[![Build Status](https://travis-ci.org/ultraq/object-utils.svg?branch=master)](https://travis-ci.org/ultraq/object-utils)
		[![Coverage Status](https://coveralls.io/repos/github/ultraq/object-utils/badge.svg?branch=master)](https://coveralls.io/github/ultraq/object-utils?branch=master)
		[![npm](https://img.shields.io/npm/v/@ultraq/object-utils.svg?maxAge=3600)](https://www.npmjs.com/package/@ultraq/object-utils)
		@@ -39,1 +40,21 @@ [![License](https://img.shields.io/github/license/ultraq/object-utils.svg?maxAge=2592000)](https://github.com/ultraq/object-utils/blob/master/LICENSE.txt)
		- sources: array of argument list of objects to copy values from

		### navigate(object, path)

		Returns a value from an object via a path string that describes the nesting of
		objects to get to the value, eg:

		```javascript
		let object = {
		greeting: {
		message: 'Hello!'
		}
		};
		let pathToMessage = 'greeting.message';
		```

		If the path doesn't resolve to anything, then `undefined` is returned.

		- object: object to search through
		- path: a dot-separated string of paths to get to the desired value within
		the object

@ultraq/object-utils - npm Package Compare versions

New alerts

Improved metrics

Worsened metrics