First attempt at creating a first-run page

background.js

 importAll("filterClasses", this);
 importAll("subscriptionClasses", this);
 importAll("filterStorage", this);
 importAll("elemHide", this);
 importAll("filterListener", this);
 importAll("filterNotifier", this);
 importAll("matcher", this);
 importAll("prefs", this);
 importAll("synchronizer", this);
 importAll("utils", this);
 
 // Some types cannot be distinguished
 RegExpFilter.typeMap.OBJECT_SUBREQUEST = RegExpFilter.typeMap.OBJECT;
 RegExpFilter.typeMap.MEDIA = RegExpFilter.typeMap.FONT = RegExpFilter.typeMap.OTHER;
 
+var isFirstRun = false;
 FilterNotifier.addListener(function(action)
 {
   if (action == "load")
   {
     importOldData();
     if (!localStorage["currentVersion"])
+    {
+      isFirstRun = true;
       executeFirstRunActions();
+    }
     localStorage["currentVersion"] = require("info").addonVersion;
   }
 });
 
 // Special-case domains for which we cannot use style-based hiding rules.
 // See http://crbug.com/68705.
 var noStyleRulesHosts = ["mail.google.com", "mail.yahoo.com", "www.google.com"];
 
 // Sets options to defaults, upgrading old options from previous versions as necessary
 function setDefaultOptions()
 {
   function defaultOptionValue(opt, val)
   {
     if(!(opt in localStorage))
       localStorage[opt] = val;
   }
 
   defaultOptionValue("shouldShowIcon", "true");
   defaultOptionValue("shouldShowBlockElementMenu", "true");
   defaultOptionValue("disableInlineTextAds", "false");
 
   // If user had older version installed, get rid of old option
   if ("specialCaseYouTube" in localStorage)
     delete localStorage.specialCaseYouTube;
   if ("experimental" in localStorage)
     delete localStorage.experimental;
 }
 
 // Upgrade options before we do anything else.
-setDefaultOptions(); 
+setDefaultOptions();
 
 /**
  * Checks whether a page is whitelisted.
  * @param {String} url
  * @param {String} [type] content type to be checked, default is "DOCUMENT"
  * @return {Filter} filter that matched the URL or null if not whitelisted
  */
 function isWhitelisted(url, type)
 {
   // Ignore fragment identifier
@@ skipping 282 matching lines @@
     {
       chrome.contextMenus.create({'title': chrome.i18n.getMessage('block_element'), 'contexts': ['image', 'video', 'audio'], 'onclick': function(info, tab)
       {
         if(info.srcUrl)
             chrome.tabs.sendRequest(tab.id, {reqtype: "clickhide-new-filter", filter: info.srcUrl});
       }});
     }
   });
 }
 
+/**
+ * Opens Options window or focuses an existing one.
+ * @param {Function} callback  function to be called with the window object of
+ *                             the Options window
+ */
+function openOptions(callback)
+{
+  function findOptions(selectTab)
+  {
+    var views = chrome.extension.getViews({type: "tab"});
+    for (var i = 0; i < views.length; i++)
+      if ("startSubscriptionSelection" in views[i])
+        return views[i];
+
+    return null;
+  }
+
+  function selectOptionsTab()
+  {
+    chrome.windows.getAll({populate: true}, function(windows)
+    {
+      var url = chrome.extension.getURL("options.html");
+      for (var i = 0; i < windows.length; i++)
+        for (var j = 0; j < windows[i].tabs.length; j++)
+          if (windows[i].tabs[j].url == url)
+            chrome.tabs.update(windows[i].tabs[j].id, {selected: true});
+    });
+  }
+
+  var view = findOptions();
+  if (view)
+  {
+    selectOptionsTab();
+    callback(view);
+  }
+  else
+  {
+    var onLoad = function()
+    {
+      var view = findOptions();
+      if (view)
+        callback(view);
+    };
+
+    chrome.tabs.create({url: chrome.extension.getURL("options.html")}, function(tab)
+    {
+      if (tab.status == "complete")
+        onLoad();
+      else
+      {
+        var id = tab.id;
+        var listener = function(tabId, changeInfo, tab)
+        {
+          if (tabId == id && changeInfo.status == "complete")
+          {
+            chrome.tabs.onUpdated.removeListener(listener);
+            onLoad();
+          }
+        };
+        chrome.tabs.onUpdated.addListener(listener);
+      }
+    });
+  }
+}
+
 chrome.extension.onRequest.addListener(function(request, sender, sendResponse)
 {
   switch (request.reqtype)
   {
     case "get-settings":
       var hostDomain = null;
       var selectors = null;
 
       // HACK: We don't know which frame sent us the message, try to find it
       // in webRequest's frame data.
@@ skipping 52 matching lines @@
       }
       break;
     case "add-filters":
       if (request.filters && request.filters.length)
       {
         for (var i = 0; i < request.filters.length; i++)
           FilterStorage.addFilter(Filter.fromText(request.filters[i]));
       }
       break;
     case "add-subscription":
-      function doAddSubscription(selectTab)
+      openOptions(function(view)
       {
-        var views = chrome.extension.getViews({type: "tab"});
-        var view = null;
-        for (var i = 0; i < views.length; i++)
-          if ("startSubscriptionSelection" in views[i])
-            view = views[i];
-
-        if (view)
-        {
-          view.startSubscriptionSelection(request.title, request.url);
-          if (selectTab)
-          {
-            chrome.windows.getAll({populate: true}, function(windows)
-            {
-              var url = chrome.extension.getURL("options.html");
-              for (var i = 0; i < windows.length; i++)
-                for (var j = 0; j < windows[i].tabs.length; j++)
-                  if (windows[i].tabs[j].url == url)
-                    return chrome.tabs.update(windows[i].tabs[j].id, {selected: true});
-            });
-          }
-        }
-        return view;
-      }
-
-      if (!doAddSubscription(true))
-      {
-        chrome.tabs.create({url: chrome.extension.getURL("options.html")}, function(tab)
-        {
-          if (tab.status == "complete")
-            doAddSubscription()
-          else
-          {
-            var id = tab.id;
-            var listener = function(tabId, changeInfo, tab)
-            {
-              if (tabId == id && changeInfo.status == "complete")
-              {
-                chrome.tabs.onUpdated.removeListener(listener);
-                doAddSubscription();
-              }
-            };
-            chrome.tabs.onUpdated.addListener(listener);
-          }
-        });
-      }
+        view.startSubscriptionSelection(request.title, request.url);
+      });
       break;
     case "forward":
       chrome.tabs.sendRequest(sender.tab.id, request.request, sendResponse);
       break;
     default:
       sendResponse({});
       break;
   }
 });
 
 // Show icon as page action for all tabs that already exist
 chrome.windows.getAll({populate: true}, function(windows)
 {
   for (var i = 0; i < windows.length; i++)
     for (var j = 0; j < windows[i].tabs.length; j++)
       refreshIconAndContextMenu(windows[i].tabs[j]);
 });
 
 // Update icon if a tab changes location
 chrome.tabs.onUpdated.addListener(function(tabId, changeInfo, tab)
 {
   chrome.tabs.sendRequest(tabId, {reqtype: "clickhide-deactivate"})
   if(changeInfo.status == "loading")
     refreshIconAndContextMenu(tab);
 });