knockout-contrib

:metal: KnockoutJS Goodies Monorepo

View the Project on GitHub Profiscience/knockout-contrib

utils.assign

Version Dependency Status Peer Dependency Status Dev Dependency Status Downloads

This package is intended for consumption via the [@profiscience/knockout-contrib] metapackage

(Deep) Object.assign(), but updates existing observables instead of overwriting them. Simply put, updates an observable tree by merging in new values.

Usage

assign(dest, src[, options = { mapArrayElements: false, strict: false }])

For each enumerable property of src, if...
  ...value is not defined on dest and...
    ...`options.strict` is `false`, creates property as observable on `dest`
    ...`options.strict` is `true`, creates property as non-observable on `dest`
  ...value is defined and observable on `dest`
    ...`dest` observable is updated
  ...value is defined and non-observable on `dest`
    ...`dest` property is updated (not as observable)  

If mapArrayElements is true, array elements will be created as mapped observables, else bare objects/primitives. NOTE: Merging new arrays onto existing ones that have been mapped mapArrayElements will create new observable elements, not update the existing ones. No attempts are made to key elements, nor will they. If you need more, you probably want ko.mapping which is much more powerful, but far slower.

NOTE: Non-writable observables on the destination (computeds w/o write functions) will be silently ignored

import { assign } from '@profiscience/knockout-contrib'

const foos = {
  foo: ko.observable('foo'),
  bar: 'bar',
}

assign(foos, {
  foo: 'new foo',
  bar: 'new bar',
  baz: 'baz',
})
// {
//   foo: ko.observable('new foo'),
//   bar: 'new bar',
//   baz: ko.observable('baz')
// }

assign(
  foos,
  {
    foo: 'new foo',
    bar: 'new bar',
    baz: 'baz',
  },
  { strict: true }
)
// {
//   foo: ko.observable('new foo'),
//   bar: 'new bar',
//   baz: 'baz' <----------------------- When strict and observable is not pre-created on dest, property will NOT be observable
// }