DoneJS StealJS jQuery++ FuncUnit DocumentJS
6.6.1
5.33.3 4.3.0 3.14.1 2.3.35
  • About
  • Guides
  • API Docs
  • Community
  • Contributing
  • Bitovi
    • Bitovi.com
    • Blog
    • Design
    • Development
    • Training
    • Open Source
    • About
    • Contact Us
  • About
  • Guides
  • API Docs
    • Observables
      • can-bind
      • can-compute
      • can-debug
      • can-deep-observable
      • can-define
      • can-define/list/list
      • can-define/map/map
      • can-define-backup
      • can-define-stream
      • can-define-stream-kefir
      • can-event-queue
      • can-kefir
      • can-list
      • can-map
      • can-map-compat
      • can-map-define
      • can-observable-array
      • can-observable-object
      • can-observation
      • can-observation-recorder
      • can-observe
      • can-simple-map
      • can-simple-observable
      • can-stream
      • can-stream-kefir
      • can-value
    • Views
      • can-attribute-observable
      • can-component
      • can-observable-bindings
      • can-stache
      • can-stache-bindings
      • can-stache-converters
      • can-stache-element
      • can-stache-route-helpers
      • can-view-autorender
      • can-view-callbacks
      • can-view-import
      • can-view-live
      • can-view-model
      • can-view-parser
      • can-view-scope
      • can-view-target
      • steal-stache
    • Data Modeling
      • can-connect
        • behaviors
          • ./base/
          • ./cache-requests/
          • ./can/constructor-hydrate/
          • ./can/map/
            • behavior options
              • List
              • Map
              • updateInstanceWithAssignDeep
            • map static methods
              • get
              • getList
            • map instance methods
              • destroy
              • isDestroying
              • isNew
              • isSaving
              • save
            • hydrators
              • instance
              • list
            • serializers
              • serializeInstance
              • serializeList
            • instance callbacks
              • createdInstance
              • destroyedInstance
              • updatedInstance
              • updatedList
            • behavior static methods
              • callbackInstanceEvents
          • ./can/ref/
          • ./can/session/
          • ./can-local-store
          • ./can-memory-store
          • ./constructor/callbacks-once/
          • ./constructor/
          • ./constructor/store/
          • ./data/callbacks/
          • ./data/callbacks-cache/
          • ./data/combine-requests/
          • ./data/parse/
          • ./data/url/
          • ./data/worker/
          • ./fall-through-cache/
          • ./real-time/
        • modules
          • ./can/tag/
          • ./helpers/map-deep-merge
          • ./helpers/weak-reference-map
        • data types
          • DataInterface
          • Instance
          • InstanceInterface
          • List
          • ListData
        • deprecated
          • ./can/base-map/
          • ./can/merge/
          • ./can/super-map/
          • ./data/localstorage-cache/
          • ./data/memory-cache/
      • can-connect-ndjson
      • can-connect-tag
      • can-define-realtime-rest-model
      • can-define-rest-model
      • can-fixture
      • can-fixture-socket
      • can-local-store
      • can-memory-store
      • can-ndjson-stream
      • can-query-logic
      • can-realtime-rest-model
      • can-rest-model
      • can-set-legacy
      • can-super-model
    • Routing
      • can-deparam
      • can-param
      • can-route
      • can-route-hash
      • can-route-mock
      • can-route-pushstate
    • JS Utilities
      • can-assign
      • can-define-lazy-value
      • can-diff
      • can-globals
      • can-join-uris
      • can-key
      • can-key-tree
      • can-make-map
      • can-parse-uri
      • can-queues
      • can-string
      • can-string-to-any
    • DOM Utilities
      • can-ajax
      • can-attribute-encoder
      • can-child-nodes
      • can-control
      • can-dom-data
      • can-dom-events
      • can-dom-mutate
      • can-event-dom-enter
      • can-event-dom-radiochange
      • can-fragment
    • Data Validation
      • can-type
      • can-validate
      • can-validate-interface
      • can-validate-legacy
      • can-validate-validatejs
    • Typed Data
      • can-cid
      • can-construct
      • can-construct-super
      • can-data-types
      • can-namespace
      • can-reflect
      • can-reflect-dependencies
      • can-reflect-promise
      • can-types
    • Polyfills
      • can-symbol
      • can-vdom
    • Core
    • Infrastructure
      • can-global
      • can-test-helpers
    • Ecosystem
    • Legacy
  • Community
  • Contributing
  • GitHub
  • Twitter
  • Chat
  • Forum
  • News
Bitovi

updateInstanceWithAssignDeep

Use the response from save() and destroy() to assign properties, never delete them.

Boolean

Setting updateInstanceWithAssignDeep to true changes how instances get updated. Instead of using can-diff/merge-deep/merge-deep, records will be updated with assignDeep.

The following example shows that the response from .save() only includes the id property. Normally, this would delete all other properties (name). But setting updateInstanceWithAssignDeep to true prevents this:

Usage:

import {DefineMap, restModel} from "can";

var Todo = DefineMap.extend({
  id: {type: "number", identity: true},
  name: "string"
});

// restModel uses `can-connect/can/map/map`
restModel({
  Map: Todo,
  url: "/todos",
  updateInstanceWithAssignDeep: true
});


var todo = new Todo({name: "learn canjs"})

var savePromise = todo.save()
// SERVER SENDS
// -> POST /todos {name: "learn canjs"}

// SERVER RESPONDS WITH:
// <- {id: 5}

savePromise.then(function(){
  // Name still exists even though the server did not
  // respond with it.
  todo.name //-> "learn canjs"
})

NOTE: can-diff/merge-deep/merge-deep is able to work MUCH better with nested data than assignDeep. Specifically, it is able to better prevent overwriting one instance's data with another. The Use section of can-diff/merge-deep/merge-deep goes over this ability. Make sure you understand its capabilities before turning it off.

CanJS is part of DoneJS. Created and maintained by the core DoneJS team and Bitovi. Currently 6.6.1.

On this page

Get help

  • Chat with us
  • File an issue
  • Ask questions
  • Read latest news