restore

function

Restore saved values of an Observe's properties.

`map.restore( [deep] )`

restore sets the properties of an Observe back to what they were the last time [can-map-backup.prototype.backup backup] was called. If deep is true, restore will also restore the properties of nested Observes.

restore will not remove properties that were added since the last backup, but it will re-add properties that have been removed.

Parameters

deep {bool}:
whether to restore properties in nested Observes

Returns

{can-map}:

The Observe, for chaining.

var CanMap = require('can-map');
require('can-map-backup')

var recipe = new CanMap("Recipe", {
title: 'Pancake Mix',
yields: '3 batches',
ingredients: [{
 ingredient: 'flour',
 quantity: '6 cups'
},{
 ingredient: 'baking soda',
 quantity: '1 1/2 teaspoons'
},{
 ingredient: 'baking powder',
 quantity: '3 teaspoons'
},{
 ingredient: 'salt',
 quantity: '1 tablespoon'
},{
 ingredient: 'sugar',
 quantity: '2 tablespoons'
}]
});

recipe.backup();

recipe.attr('title', 'Flapjack Mix');
recipe.restore();
recipe.attr('title'); // 'Pancake Mix'

recipe.attr('ingredients.0.quantity', '7 cups');
recipe.restore();
recipe.attr('ingredients.0.quantity'); // '7 cups'
recipe.restore(true);
recipe.attr('ingredients.0.quantity'); // '6 cups'

Events

When restore sets values or re-adds properties, the same events will be fired (including change, add, and set) as if the values of the properties had been set using attr.