Add sample extension that allows setting plugin-specific content settings.

chrome/common/extensions/docs/examples/extensions/plugin_settings/js/plugin_settings.js

Index: chrome/common/extensions/docs/examples/extensions/plugin_settings/js/plugin_settings.js
diff --git a/chrome/common/extensions/docs/examples/extensions/plugin_settings/js/plugin_settings.js b/chrome/common/extensions/docs/examples/extensions/plugin_settings/js/plugin_settings.js
new file mode 100644
index 0000000000000000000000000000000000000000..9929e892184129b16be90c0898a046bb98c8f6f5
--- /dev/null
+++ b/chrome/common/extensions/docs/examples/extensions/plugin_settings/js/plugin_settings.js
@@ -0,0 +1,188 @@
+// Copyright (c) 2011 The Chromium Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+cr.define('pluginSettings', function() {
+  const EventTarget = cr.EventTarget;
+  const Event = cr.Event;
+
+  /**
+   * Creates a new content settings model.
+   * @param {string} plugin Identifies the plug-in for which this object stores
+   *     settings.
+   * @constructor
+   * @extends {cr.EventTarget}
+   */
+  function Settings(plugin) {
+    this.plugin_ = plugin;
+  }
+
+  Settings.prototype = {
+    __proto__: cr.EventTarget.prototype,
+
+    /**
+     * Identifies the plug-in for which this object stores settings.
+     * @type {string}
+     * @private
+     */
+    plugin_: null,
+
+    /**
+     * Clears all content settings, and recreates them from local storage. If a
+     * content setting can't be set (which shouldn't really happen, as it has
+     * been successfully set previously), it is removed from local storage as
+     * well.
+     * @param {function()} callback Called when the content settings have been
+     *     recreated, or on error.
+     * @private
+     */
+    recreateRules_: function(callback) {
+      chrome.contentSettings.plugins.clear({}, function() {
+        if (chrome.extension.lastError) {
+          console.error("Error clearing rules");
+          callback();
+          return;
+        }
+        var length = window.localStorage.length;
+        if (length == 0) {
+          callback();
+          return;
+        }
+        var count = length;
+        var errors = [];
+        for (var i = 0; i < length; i++) {
+          var key = window.localStorage.key(i);
+          var keyArray = JSON.parse(key);
+          var plugin = keyArray[0];
+          var pattern = keyArray[1];
+          var setting = window.localStorage.getItem(key);
+          chrome.contentSettings.plugins.set({
+              'primaryPattern': pattern,
+              'resourceIdentifier': { 'id': plugin },
+              'setting': setting,
+          }, function() {
+            if (chrome.extension.lastError) {
+              console.error('Error restoring [' + plugin_ + ', ' +
+                            pattern + setting + ']: ' +
+                            chrome.extension.lastError.message);
+              window.localStorage.removeItem(key);
+            }
+            count--;
+            if (count == 0)
+              callback();
+          });
+        }
+      });
+    },
+
+    /**
+     * Creates a content setting rule and calls the passed in callback with the
+     *     result.
+     * @param {string} pattern The content setting pattern for the rule.
+     * @param {string} setting The setting for the rule.
+     * @param {function(?string)} callback Called when the content settings have
+     *     been updated, or on error.
+     */
+    set: function(pattern, setting, callback) {
+      var plugin = this.plugin_;
+      chrome.contentSettings.plugins.set({
+          'primaryPattern': pattern,
+          'resourceIdentifier': { 'id': plugin },
+          'setting': setting,
+      }, function() {
+        if (chrome.extension.lastError) {
+          callback(chrome.extension.lastError.message);
+        } else {
+          window.localStorage.setItem(JSON.stringify([plugin, pattern]),
+                                      setting);
+          callback();
+        }
+      });
+    },
+
+    /**
+     * Removes the content setting rule with a given pattern, and calls the
+     *     passed in callback afterwards.
+     * @param {string} pattern The content setting pattern for the rule.
+     * @param {function()?} callback Called when the content settings have
+     *     been updated.
+     */
+    clear: function(pattern, callback) {
+      window.localStorage.removeItem(
+          JSON.stringify([this.plugin_, pattern]));
+      this.recreateRules_(callback);
+    },
+
+    /**
+     * Updates the content setting rule with a given pattern to a new pattern
+     *     and setting and calls the passed in callback with the result.
+     * @param {string} oldPattern The old content setting pattern for the rule.
+     * @param {string} newPattern The new content setting pattern for the rule.
+     * @param {string} setting The setting for the rule.
+     * @param {function(?string)} callback Called when the content settings have
+     *     been updated, or on error.
+     */
+    update: function(oldPattern, newPattern, setting, callback) {
+      if (oldPattern == newPattern) {
+        // Avoid recreating all rules if only the setting changed.
+        this.set(newPattern, setting, callback);
+        return;
+      }
+      var oldSetting = this.get(oldPattern);
+      var settings = this;
+      // Remove the old rule.
+      this.clear(oldPattern, function() {
+        // Try to set the new rule.
+        settings.set(newPattern, setting, function(error) {
+          if (error) {
+            // If setting the new rule failed, restore the old rule.
+            settings.setInternal_(oldPattern, oldSetting,
+                                  function(restoreError) {
+              if (restoreError) {
+                console.error('Error restoring [' + settings.plugin_ + ', ' +
+                              oldPattern + oldSetting + ']: ' + restoreError);
+              }
+              callback(error);
+            });
+          } else {
+            callback();
+          }
+        });
+      });
+    },
+
+    /**
+     * Returns the content setting for a given pattern.
+     * @param {string} pattern The content setting pattern for the rule.
+     * @return {string} The setting for the rule.
+     */
+    get: function(primaryPattern) {
+      return window.localStorage.getItem(
+          JSON.stringify([this.plugin_, primaryPattern]));
+    },
+
+    /**
+     * @return {array} A list of all content setting rules for this plug-in.
+     */
+    getAll: function() {
+      var length = window.localStorage.length;
+      var rules = [];
+      for (var i = 0; i < length; i++) {
+        var key = window.localStorage.key(i);
+        var keyArray = JSON.parse(key);
+        if (keyArray[0] == this.plugin_) {
+          rules.push({
+            'primaryPattern': keyArray[1],
+            'setting': window.localStorage.getItem(key),
+          });
+        }
+      }
+      return rules;
+    }
+  };
+
+  return {
+    Settings: Settings,
+  }
+});
+