DevTools: Implement undo, redo operations for the DOMStorage views.

Source/devtools/front_end/DOMStorage.js

 /*
  * Copyright (C) 2008 Nokia Inc.  All rights reserved.
  * Copyright (C) 2013 Samsung Electronics. All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
  * are met:
  *
  * 1.  Redistributions of source code must retain the above copyright
  *     notice, this list of conditions and the following disclaimer.
@@ skipping 18 matching lines @@
 
 /**
  * @constructor
  * @param {string} securityOrigin
  * @param {boolean} isLocalStorage
  */
 WebInspector.DOMStorage = function(securityOrigin, isLocalStorage)
 {
     this._securityOrigin = securityOrigin;
     this._isLocalStorage = isLocalStorage;
+    this._storageHistory = new WebInspector.DOMStorageHistory(this);
 }
 
 /**
  * @param {string} securityOrigin
  * @param {boolean} isLocalStorage
  * @return {DOMStorageAgent.StorageId}
  */
 WebInspector.DOMStorage.storageId = function(securityOrigin, isLocalStorage)
 {
     return { securityOrigin: securityOrigin, isLocalStorage: isLocalStorage };
@@ skipping 26 matching lines @@
     {
         DOMStorageAgent.getDOMStorageItems(this.id, callback);
     },
 
     /**
      * @param {string} key
      * @param {string} value
      */
     setItem: function(key, value)
     {
-        DOMStorageAgent.setDOMStorageItem(this.id, key, value);
+        this._storageHistory.perform(new WebInspector.DOMStorageSetItemAction(this, key, value));
     },
 
     /**
      * @param {string} key
      */
     removeItem: function(key)
     {
-        DOMStorageAgent.removeDOMStorageItem(this.id, key);
+        this._storageHistory.perform(new WebInspector.DOMStorageRemoveItemAction(this, key));
+    },
+
+    undo: function()
+    {
+        this._storageHistory.undo();
+    },
+
+    redo: function()
+    {
+        this._storageHistory.redo();
     }
 }
 
+/**
+ * @constructor
+ * @param {WebInspector.DOMStorage} domStorage
+ */
+WebInspector.DOMStorageAction = function(domStorage)
+{
+    this._domStorage = domStorage;
+}
+
+WebInspector.DOMStorageAction.prototype = {
+    /**
+     * @param {function(): void} callback

[apavlov, 2013/08/01 09:19:16]

we typically omit "void" in signatures. In fact, it is not mandatory for a
callback to be void...

+     */
+    perform: function(callback)
+    {
+    },
+
+    undo: function()
+    {
+    },
+
+    redo: function()
+    {
+    }
+}
+
+/**
+ * @constructor
+ * @param {!WebInspector.DOMStorage} domStorage
+ * @param {!string} key
+ * @extends {WebInspector.DOMStorageAction}

[apavlov, 2013/08/01 09:19:16]

@extends should immediately follow @constructor for clarity (this is a
constructor of a class that extends this other class)

+ */
+WebInspector.DOMStorageRemoveItemAction = function(domStorage, key)
+{
+    WebInspector.DOMStorageAction.call(this, domStorage);
+    this._key = key;
+}
+
+WebInspector.DOMStorageRemoveItemAction.prototype = {
+    /**
+     * @override
+     * @param {function(): void} callback

[apavlov, 2013/08/01 09:19:16]

ditto re void (and more below)

+     */
+    perform: function(callback)
+    {
+        /**
+         * @param {?Protocol.Error} error
+         * @param {string=} value
+         */
+        function valueReceived(error, value)
+        {
+            this._value = value;
+            this.redo();
+            callback();
+        }
+        DOMStorageAgent.getDOMStorageItem(this._domStorage.id, this._key, valueReceived.bind(this));
+    },
+
+    /*

[apavlov, 2013/08/01 09:19:16]

/**

+     * @override
+     */
+    undo: function()
+    {
+        DOMStorageAgent.setDOMStorageItem(this._domStorage.id, this._key, this._value);
+    },
+
+    /*

[apavlov, 2013/08/01 09:19:16]

/**

+     * @override
+     */
+    redo: function()
+    {
+        DOMStorageAgent.removeDOMStorageItem(this._domStorage.id, this._key);
+    },
+
+    __proto__: WebInspector.DOMStorageAction.prototype
+}
+
+/**
+ * @constructor
+ * @param {WebInspector.DOMStorage} domStorage
+ * @param {string} key
+ * @extends {WebInspector.DOMStorageAction}

[apavlov, 2013/08/01 09:19:16]

Please move next to @constructor

+ */
+WebInspector.DOMStorageSetItemAction = function(domStorage, key, value)
+{
+    WebInspector.DOMStorageAction.call(this, domStorage);
+    this._key = key;
+    this._value = value;
+}
+
+WebInspector.DOMStorageSetItemAction.prototype = {
+    /**
+     * @override
+     * @param {function(): void} callback
+     */
+    perform: function(callback)
+    {
+        /**
+         * @param {?Protocol.Error} error
+         * @param {string=} value
+         */
+        function valueReceived(error, value)
+        {
+            if (typeof value === 'undefined' || value === null)
+                this._exists = false;
+            else {
+                this._exists = true;
+                this._oldValue = value;
+            }
+            this.redo();
+            callback();
+        }
+        DOMStorageAgent.getDOMStorageItem(this._domStorage.id, this._key, valueReceived.bind(this));
+    },
+
+    /*

[apavlov, 2013/08/01 09:19:16]

/**

+     * @override
+     */
+    undo: function()
+    {
+        if (!this._exists)
+            DOMStorageAgent.removeDOMStorageItem(this._domStorage.id, this._key);
+        else
+            DOMStorageAgent.setDOMStorageItem(this._domStorage.id, this._key, this._oldValue);
+    },
+
+    /*

[apavlov, 2013/08/01 09:19:16]

/**

+     * @override
+     */
+    redo: function()
+    {
+        DOMStorageAgent.setDOMStorageItem(this._domStorage.id, this._key, this._value);
+    },
+
+    __proto__: WebInspector.DOMStorageAction.prototype
+}
+
+/**
+ * @constructor
+ * @param {WebInspector.DOMStorage} domStorage
+ */
+WebInspector.DOMStorageHistory = function(domStorage)
+{
+    this._domStorage = domStorage;
+    this._actions = [];
+    this._currentActionIndex = -1;
+}
+
+WebInspector.DOMStorageHistory.prototype = {
+    /*

[apavlov, 2013/08/01 09:19:16]

/**

+     * @param {WebInspector.DOMStorageAction} action
+     */
+    perform: function(action)
+    {
+        if (!action)
+            return;
+
+        function completed()
+        {
+            this._actions.push(action);
+            ++this._currentActionIndex;
+        }
+
+        action.perform(completed.bind(this));
+    },
+
+    undo: function()
+    {
+        if (this._currentActionIndex < 0)
+            return;
+
+        var action = this._actions[this._currentActionIndex];
+        console.assert(action);
+        action.undo();
+        --this._currentActionIndex;
+    },
+
+    redo: function()
+    {
+        if (this._currentActionIndex >= this._actions.length - 1)
+            return;
+
+        var action = this._actions[++this._currentActionIndex];
+        console.assert(action);
+        action.redo();
+    }
+}
+
 /**
  * @constructor
  * @extends {WebInspector.Object}
  */
 WebInspector.DOMStorageModel = function()
 {
     this._storages = {};
     InspectorBackend.registerDOMStorageDispatcher(new WebInspector.DOMStorageDispatcher(this));
     DOMStorageAgent.enable();
     WebInspector.resourceTreeModel.addEventListener(WebInspector.ResourceTreeModel.EventTypes.SecurityOriginAdded, this._securityOriginAdded, this);
@@ skipping 190 matching lines @@
     domStorageItemUpdated: function(storageId, key, oldValue, newValue)
     {
         this._model._domStorageItemUpdated(storageId, key, oldValue, newValue);
     },
 }
 
 /**
  * @type {WebInspector.DOMStorageModel}
  */
 WebInspector.domStorageModel = null;