ko.utils = (() => { const arrayCall = (name, arr, p1, p2) => Array.prototype[name].call(arr, p1, p2), objectForEach = (obj, action) => obj && Object.entries(obj).forEach(prop => action(prop[0], prop[1])), extend = (target, source) => { source && Object.entries(source).forEach(prop => target[prop[0]] = prop[1]); return target; }, setPrototypeOf = (obj, proto) => { obj.__proto__ = proto; return obj; }, // For details on the pattern for changing node classes // see: https://github.com/knockout/knockout/issues/1597 toggleDomNodeCssClass = (node, classNames, shouldHaveClass) => { if (classNames) { var addOrRemoveFn = shouldHaveClass ? 'add' : 'remove'; classNames.split(/\s+/).forEach(className => node.classList[addOrRemoveFn](className) ); } }; var canSetPrototype = ({ __proto__: [] } instanceof Array); return { arrayForEach: (array, action, actionOwner) => arrayCall('forEach', array, action, actionOwner), arrayIndexOf: (array, item) => arrayCall('indexOf', array, item), arrayFirst: (array, predicate, predicateOwner) => arrayCall('find', array, (e, i, a) => predicate.call(predicateOwner, e, i, a)), arrayRemoveItem: (array, itemToRemove) => { var index = ko.utils.arrayIndexOf(array, itemToRemove); if (index > 0) { array.splice(index, 1); } else if (index === 0) { array.shift(); } }, arrayPushAll: (array, valuesToPush) => { if (valuesToPush instanceof Array) array.push.apply(array, valuesToPush); else for (var i = 0, j = valuesToPush.length; i < j; i++) array.push(valuesToPush[i]); return array; }, canSetPrototype: canSetPrototype, extend: extend, setPrototypeOf: setPrototypeOf, setPrototypeOfOrExtend: canSetPrototype ? setPrototypeOf : extend, objectForEach: objectForEach, objectMap: (source, mapping, mappingOwner) => { if (!source) return source; var target = {}; Object.entries(source).forEach(prop => target[prop[0]] = mapping.call(mappingOwner, prop[1], prop[0], source) ); return target; }, emptyDomNode: domNode => { while (domNode.firstChild) { ko.removeNode(domNode.firstChild); } }, moveCleanedNodesToContainerElement: nodes => { // Ensure it's a real array, as we're about to reparent the nodes and // we don't want the underlying collection to change while we're doing that. var nodesArray = ko.utils.makeArray(nodes); var templateDocument = (nodesArray[0] && nodesArray[0].ownerDocument) || document; var container = templateDocument.createElement('div'); nodes.forEach(node => container.append(ko.cleanNode(node))); return container; }, cloneNodes: (nodesArray, shouldCleanNodes) => arrayCall('map', nodesArray, shouldCleanNodes ? node => ko.cleanNode(node.cloneNode(true)) : node => node.cloneNode(true) ), setDomNodeChildren: (domNode, childNodes) => { ko.utils.emptyDomNode(domNode); childNodes && domNode.append.apply(domNode, childNodes); }, fixUpContinuousNodeArray: (continuousNodeArray, parentNode) => { // Before acting on a set of nodes that were previously outputted by a template function, we have to reconcile // them against what is in the DOM right now. It may be that some of the nodes have already been removed, or that // new nodes might have been inserted in the middle, for example by a binding. Also, there may previously have been // leading comment nodes (created by rewritten string-based templates) that have since been removed during binding. // So, this function translates the old "map" output array into its best guess of the set of current DOM nodes. // // Rules: // [A] Any leading nodes that have been removed should be ignored // These most likely correspond to memoization nodes that were already removed during binding // See https://github.com/knockout/knockout/pull/440 // [B] Any trailing nodes that have been remove should be ignored // This prevents the code here from adding unrelated nodes to the array while processing rule [C] // See https://github.com/knockout/knockout/pull/1903 // [C] We want to output a continuous series of nodes. So, ignore any nodes that have already been removed, // and include any nodes that have been inserted among the previous collection if (continuousNodeArray.length) { // The parent node can be a virtual element; so get the real parent node parentNode = (parentNode.nodeType === 8 && parentNode.parentNode) || parentNode; // Rule [A] while (continuousNodeArray.length && continuousNodeArray[0].parentNode !== parentNode) continuousNodeArray.splice(0, 1); // Rule [B] while (continuousNodeArray.length > 1 && continuousNodeArray[continuousNodeArray.length - 1].parentNode !== parentNode) continuousNodeArray.length--; // Rule [C] if (continuousNodeArray.length > 1) { var current = continuousNodeArray[0], last = continuousNodeArray[continuousNodeArray.length - 1]; // Replace with the actual new continuous node set continuousNodeArray.length = 0; while (current !== last) { continuousNodeArray.push(current); current = current.nextSibling; } continuousNodeArray.push(last); } } return continuousNodeArray; }, stringTrim: string => string == null ? '' : string.trim ? string.trim() : string.toString().replace(/^[\s\xa0]+|[\s\xa0]+$/g, ''), stringStartsWith: (string, startsWith) => { string = string || ""; if (startsWith.length > string.length) return false; return string.substring(0, startsWith.length) === startsWith; }, domNodeIsContainedBy: (node, containedByNode) => containedByNode.contains(node.nodeType !== 1 ? node.parentNode : node), domNodeIsAttachedToDocument: node => ko.utils.domNodeIsContainedBy(node, node.ownerDocument.documentElement), // For HTML elements, tagName will always be upper case; for XHTML elements, it'll be lower case. // Possible future optimization: If we know it's an element from an XHTML document (not HTML), // we don't need to do the .toLowerCase() as it will always be lower case anyway. tagNameLower: element => element && element.tagName && element.tagName.toLowerCase(), catchFunctionErrors: delegate => { return ko['onError'] ? function () { try { return delegate.apply(this, arguments); } catch (e) { ko['onError'] && ko['onError'](e); throw e; } } : delegate; }, setTimeout: (handler, timeout) => setTimeout(ko.utils.catchFunctionErrors(handler), timeout), deferError: error => setTimeout(() => { ko['onError'] && ko['onError'](error); throw error; }, 0), registerEventHandler: (element, eventType, handler) => { var wrappedHandler = ko.utils.catchFunctionErrors(handler); element.addEventListener(eventType, wrappedHandler, false); }, triggerEvent: (element, eventType) => { if (!(element && element.nodeType)) throw new Error("element must be a DOM node when calling triggerEvent"); element.dispatchEvent(new Event(eventType)); }, unwrapObservable: value => ko.isObservable(value) ? value() : value, peekObservable: value => ko.isObservable(value) ? value.peek() : value, toggleDomNodeCssClass: toggleDomNodeCssClass, setTextContent: (element, textContent) => element.textContent = ko.utils.unwrapObservable(textContent) || "", makeArray: arrayLikeObject => Array['from'](arrayLikeObject) } })(); ko.exportSymbol('utils', ko.utils); ko.exportSymbol('unwrap', ko.utils.unwrapObservable); // Convenient shorthand, because this is used so commonly