// 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. #include "base/utf_string_conversions.h" #include "chrome/app/chrome_command_ids.h" #include "chrome/browser/extensions/extension_browsertest.h" #include "chrome/browser/extensions/extension_service.h" #include "chrome/browser/extensions/extension_test_message_listener.h" #include "chrome/browser/profiles/profile.h" #include "chrome/browser/tab_contents/render_view_context_menu.h" #include "chrome/browser/ui/browser.h" #include "chrome/browser/ui/browser_list.h" #include "chrome/test/ui_test_utils.h" #include "content/browser/tab_contents/tab_contents.h" #include "net/base/mock_host_resolver.h" #include "third_party/WebKit/Source/WebKit/chromium/public/WebContextMenuData.h" #include "ui/base/models/menu_model.h" #include "webkit/glue/context_menu.h" using ui::MenuModel; using WebKit::WebContextMenuData; // This test class helps us sidestep platform-specific issues with popping up a // real context menu, while still running through the actual code in // RenderViewContextMenu where extension items get added and executed. class TestRenderViewContextMenu : public RenderViewContextMenu { public: TestRenderViewContextMenu(TabContents* tab_contents, const ContextMenuParams& params) : RenderViewContextMenu(tab_contents, params) {} virtual ~TestRenderViewContextMenu() {} bool HasExtensionItemWithLabel(const std::string& label) { string16 label16 = UTF8ToUTF16(label); std::map<int, ExtensionMenuItem::Id>::iterator i; for (i = extension_item_map_.begin(); i != extension_item_map_.end(); ++i) { const ExtensionMenuItem::Id& id = i->second; string16 tmp_label; EXPECT_TRUE(GetItemLabel(id, &tmp_label)); if (tmp_label == label16) return true; } return false; } // Looks in the menu for an extension item with |id|, and if it is found and // has a label, that is put in |result| and we return true. Otherwise returns // false. bool GetItemLabel(const ExtensionMenuItem::Id& id, string16* result) { int command_id = 0; if (!FindCommandId(id, &command_id)) return false; MenuModel* model = NULL; int index = -1; if (!GetMenuModelAndItemIndex(command_id, &model, &index)) { return false; } *result = model->GetLabelAt(index); return true; } // Searches for an menu item with |command_id|. If it's found, the return // value is true and the model and index where it appears in that model are // returned in |found_model| and |found_index|. Otherwise returns false. bool GetMenuModelAndItemIndex(int command_id, MenuModel** found_model, int *found_index) { std::vector<MenuModel*> models_to_search; models_to_search.push_back(&menu_model_); while (!models_to_search.empty()) { MenuModel* model = models_to_search.back(); models_to_search.pop_back(); for (int i = 0; i < model->GetItemCount(); i++) { if (model->GetCommandIdAt(i) == command_id) { *found_model = model; *found_index = i; return true; } else if (model->GetTypeAt(i) == MenuModel::TYPE_SUBMENU) { models_to_search.push_back(model->GetSubmenuModelAt(i)); } } } return false; } protected: // These two functions implement pure virtual methods of // RenderViewContextMenu. virtual bool GetAcceleratorForCommandId(int command_id, ui::Accelerator* accelerator) { // None of our commands have accelerators, so always return false. return false; } virtual void PlatformInit() {} // Given an extension menu item id, tries to find the corresponding command id // in the menu. bool FindCommandId(const ExtensionMenuItem::Id& id, int* command_id) { std::map<int, ExtensionMenuItem::Id>::const_iterator i; for (i = extension_item_map_.begin(); i != extension_item_map_.end(); ++i) { if (i->second == id) { *command_id = i->first; return true; } } return false; } }; class ExtensionContextMenuBrowserTest : public ExtensionBrowserTest { public: // Helper to load an extension from context_menus/|subdirectory| in the // extensions test data dir. bool LoadContextMenuExtension(std::string subdirectory) { FilePath extension_dir = test_data_dir_.AppendASCII("context_menus").AppendASCII(subdirectory); return LoadExtension(extension_dir); } bool LoadContextMenuExtensionIncognito(std::string subdirectory) { FilePath extension_dir = test_data_dir_.AppendASCII("context_menus").AppendASCII(subdirectory); return LoadExtensionIncognito(extension_dir); } TestRenderViewContextMenu* CreateMenu(Browser* browser, const GURL& page_url, const GURL& link_url, const GURL& frame_url) { TabContents* tab_contents = browser->GetSelectedTabContents(); WebContextMenuData data; ContextMenuParams params(data); params.page_url = page_url; params.link_url = link_url; params.frame_url = frame_url; TestRenderViewContextMenu* menu = new TestRenderViewContextMenu(tab_contents, params); menu->Init(); return menu; } // Shortcut to return the current ExtensionMenuManager. ExtensionMenuManager* menu_manager() { return browser()->profile()->GetExtensionService()->menu_manager(); } // Returns a pointer to the currently loaded extension with |name|, or null // if not found. const Extension* GetExtensionNamed(std::string name) { const ExtensionList* extensions = browser()->profile()->GetExtensionService()->extensions(); ExtensionList::const_iterator i; for (i = extensions->begin(); i != extensions->end(); ++i) { if ((*i)->name() == name) { return *i; } } return NULL; } // This gets all the items that any extension has registered for possible // inclusion in context menus. ExtensionMenuItem::List GetItems() { ExtensionMenuItem::List result; std::set<std::string> extension_ids = menu_manager()->ExtensionIds(); std::set<std::string>::iterator i; for (i = extension_ids.begin(); i != extension_ids.end(); ++i) { const ExtensionMenuItem::List* list = menu_manager()->MenuItems(*i); result.insert(result.end(), list->begin(), list->end()); } return result; } // This creates a test menu for a page with |page_url| and |link_url|, looks // for an extension item with the given |label|, and returns true if the item // was found. bool MenuHasItemWithLabel(const GURL& page_url, const GURL& link_url, const GURL& frame_url, const std::string& label) { scoped_ptr<TestRenderViewContextMenu> menu( CreateMenu(browser(), page_url, link_url, frame_url)); return menu->HasExtensionItemWithLabel(label); } }; // Tests adding a simple context menu item. IN_PROC_BROWSER_TEST_F(ExtensionContextMenuBrowserTest, Simple) { ExtensionTestMessageListener listener1("created item", false); ExtensionTestMessageListener listener2("onclick fired", false); ASSERT_TRUE(LoadContextMenuExtension("simple")); // Wait for the extension to tell us it's created an item. ASSERT_TRUE(listener1.WaitUntilSatisfied()); GURL page_url("http://www.google.com"); // Create and build our test context menu. scoped_ptr<TestRenderViewContextMenu> menu( CreateMenu(browser(), page_url, GURL(), GURL())); // Look for the extension item in the menu, and execute it. int command_id = IDC_EXTENSIONS_CONTEXT_CUSTOM_FIRST; ASSERT_TRUE(menu->IsCommandIdEnabled(command_id)); menu->ExecuteCommand(command_id); // Wait for the extension's script to tell us its onclick fired. ASSERT_TRUE(listener2.WaitUntilSatisfied()); } // Tests that setting "documentUrlPatterns" for an item properly restricts // those items to matching pages. IN_PROC_BROWSER_TEST_F(ExtensionContextMenuBrowserTest, Patterns) { ExtensionTestMessageListener listener("created items", false); ASSERT_TRUE(LoadContextMenuExtension("patterns")); // Wait for the js test code to create its two items with patterns. ASSERT_TRUE(listener.WaitUntilSatisfied()); // Check that a document url that should match the items' patterns appears. GURL google_url("http://www.google.com"); ASSERT_TRUE(MenuHasItemWithLabel(google_url, GURL(), GURL(), std::string("test_item1"))); ASSERT_TRUE(MenuHasItemWithLabel(google_url, GURL(), GURL(), std::string("test_item2"))); // Now check with a non-matching url. GURL test_url("http://www.test.com"); ASSERT_FALSE(MenuHasItemWithLabel(test_url, GURL(), GURL(), std::string("test_item1"))); ASSERT_FALSE(MenuHasItemWithLabel(test_url, GURL(), GURL(), std::string("test_item2"))); } // Tests registering an item with a very long title that should get truncated in // the actual menu displayed. IN_PROC_BROWSER_TEST_F(ExtensionContextMenuBrowserTest, LongTitle) { ExtensionTestMessageListener listener("created", false); // Load the extension and wait until it's created a menu item. ASSERT_TRUE(LoadContextMenuExtension("long_title")); ASSERT_TRUE(listener.WaitUntilSatisfied()); // Make sure we have an item registered with a long title. size_t limit = RenderViewContextMenu::kMaxExtensionItemTitleLength; ExtensionMenuItem::List items = GetItems(); ASSERT_EQ(1u, items.size()); ExtensionMenuItem* item = items.at(0); ASSERT_GT(item->title().size(), limit); // Create a context menu, then find the item's label. It should be properly // truncated. GURL url("http://foo.com/"); scoped_ptr<TestRenderViewContextMenu> menu( CreateMenu(browser(), url, GURL(), GURL())); string16 label; ASSERT_TRUE(menu->GetItemLabel(item->id(), &label)); ASSERT_TRUE(label.size() <= limit); } // Checks that in |menu|, the item at |index| has type |expected_type| and a // label of |expected_label|. static void ExpectLabelAndType(const char* expected_label, MenuModel::ItemType expected_type, const MenuModel& menu, int index) { EXPECT_EQ(expected_type, menu.GetTypeAt(index)); EXPECT_EQ(UTF8ToUTF16(expected_label), menu.GetLabelAt(index)); } // In the separators test we build a submenu with items and separators in two // different ways - this is used to verify the results in both cases. static void VerifyMenuForSeparatorsTest(const MenuModel& menu) { // We expect to see the following items in the menu: // radio1 // radio2 // --separator-- (automatically added) // normal1 // --separator-- // normal2 // --separator-- // radio3 // radio4 // --separator-- // normal3 int index = 0; ASSERT_EQ(11, menu.GetItemCount()); ExpectLabelAndType("radio1", MenuModel::TYPE_RADIO, menu, index++); ExpectLabelAndType("radio2", MenuModel::TYPE_RADIO, menu, index++); EXPECT_EQ(MenuModel::TYPE_SEPARATOR, menu.GetTypeAt(index++)); ExpectLabelAndType("normal1", MenuModel::TYPE_COMMAND, menu, index++); EXPECT_EQ(MenuModel::TYPE_SEPARATOR, menu.GetTypeAt(index++)); ExpectLabelAndType("normal2", MenuModel::TYPE_COMMAND, menu, index++); EXPECT_EQ(MenuModel::TYPE_SEPARATOR, menu.GetTypeAt(index++)); ExpectLabelAndType("radio3", MenuModel::TYPE_RADIO, menu, index++); ExpectLabelAndType("radio4", MenuModel::TYPE_RADIO, menu, index++); EXPECT_EQ(MenuModel::TYPE_SEPARATOR, menu.GetTypeAt(index++)); ExpectLabelAndType("normal3", MenuModel::TYPE_COMMAND, menu, index++); } // Tests a number of cases for auto-generated and explicitly added separators. IN_PROC_BROWSER_TEST_F(ExtensionContextMenuBrowserTest, Separators) { // Load the extension. ASSERT_TRUE(LoadContextMenuExtension("separators")); const Extension* extension = GetExtensionNamed("Separators Test"); ASSERT_TRUE(extension != NULL); // Navigate to test1.html inside the extension, which should create a bunch // of items at the top-level (but they'll get pushed into an auto-generated // parent). ExtensionTestMessageListener listener1("test1 create finished", false); ui_test_utils::NavigateToURL(browser(), GURL(extension->GetResourceURL("test1.html"))); listener1.WaitUntilSatisfied(); GURL url("http://www.google.com/"); scoped_ptr<TestRenderViewContextMenu> menu( CreateMenu(browser(), url, GURL(), GURL())); // The top-level item should be an "automagic parent" with the extension's // name. MenuModel* model = NULL; int index = 0; string16 label; ASSERT_TRUE(menu->GetMenuModelAndItemIndex( IDC_EXTENSIONS_CONTEXT_CUSTOM_FIRST, &model, &index)); EXPECT_EQ(UTF8ToUTF16(extension->name()), model->GetLabelAt(index)); ASSERT_EQ(MenuModel::TYPE_SUBMENU, model->GetTypeAt(index)); // Get the submenu and verify the items there. MenuModel* submenu = model->GetSubmenuModelAt(index); ASSERT_TRUE(submenu != NULL); VerifyMenuForSeparatorsTest(*submenu); // Now run our second test - navigate to test2.html which creates an explicit // parent node and populates that with the same items as in test1. ExtensionTestMessageListener listener2("test2 create finished", false); ui_test_utils::NavigateToURL(browser(), GURL(extension->GetResourceURL("test2.html"))); listener2.WaitUntilSatisfied(); menu.reset(CreateMenu(browser(), url, GURL(), GURL())); ASSERT_TRUE(menu->GetMenuModelAndItemIndex( IDC_EXTENSIONS_CONTEXT_CUSTOM_FIRST, &model, &index)); EXPECT_EQ(UTF8ToUTF16("parent"), model->GetLabelAt(index)); submenu = model->GetSubmenuModelAt(index); ASSERT_TRUE(submenu != NULL); VerifyMenuForSeparatorsTest(*submenu); } // Tests that targetUrlPattern keeps items from appearing when there is no // target url. IN_PROC_BROWSER_TEST_F(ExtensionContextMenuBrowserTest, TargetURLs) { ExtensionTestMessageListener listener("created items", false); ASSERT_TRUE(LoadContextMenuExtension("target_urls")); ASSERT_TRUE(listener.WaitUntilSatisfied()); GURL google_url("http://www.google.com"); GURL non_google_url("http://www.foo.com"); // No target url - the item should not appear. ASSERT_FALSE(MenuHasItemWithLabel( google_url, GURL(), GURL(), std::string("item1"))); // A matching target url - the item should appear. ASSERT_TRUE(MenuHasItemWithLabel(google_url, google_url, GURL(), std::string("item1"))); // A non-matching target url - the item should not appear. ASSERT_FALSE(MenuHasItemWithLabel(google_url, non_google_url, GURL(), std::string("item1"))); } // Tests adding of context menus in incognito mode. IN_PROC_BROWSER_TEST_F(ExtensionContextMenuBrowserTest, IncognitoSplit) { ExtensionTestMessageListener created("created item regular", false); ExtensionTestMessageListener created_incognito("created item incognito", false); ExtensionTestMessageListener onclick("onclick fired regular", false); ExtensionTestMessageListener onclick_incognito("onclick fired incognito", false); // Open an incognito window. ui_test_utils::OpenURLOffTheRecord(browser()->profile(), GURL("about:blank")); ASSERT_TRUE(LoadContextMenuExtensionIncognito("incognito")); // Wait for the extension's processes to tell us they've created an item. ASSERT_TRUE(created.WaitUntilSatisfied()); ASSERT_TRUE(created_incognito.WaitUntilSatisfied()); GURL page_url("http://www.google.com"); // Create and build our test context menu. Browser* browser_incognito = BrowserList::FindBrowserWithType( browser()->profile()->GetOffTheRecordProfile(), Browser::TYPE_NORMAL, false); ASSERT_TRUE(browser_incognito); scoped_ptr<TestRenderViewContextMenu> menu( CreateMenu(browser(), page_url, GURL(), GURL())); scoped_ptr<TestRenderViewContextMenu> menu_incognito( CreateMenu(browser_incognito, page_url, GURL(), GURL())); // Look for the extension item in the menu, and execute it. int command_id = IDC_EXTENSIONS_CONTEXT_CUSTOM_FIRST; ASSERT_TRUE(menu->IsCommandIdEnabled(command_id)); menu->ExecuteCommand(command_id); // Wait for the extension's script to tell us its onclick fired. Ensure // that the incognito version doesn't fire until we explicitly click the // incognito menu item. ASSERT_TRUE(onclick.WaitUntilSatisfied()); EXPECT_FALSE(onclick_incognito.was_satisfied()); ASSERT_TRUE(menu_incognito->IsCommandIdEnabled(command_id)); menu_incognito->ExecuteCommand(command_id); ASSERT_TRUE(onclick_incognito.WaitUntilSatisfied()); } // Tests that items with a context of frames only appear when the menu is // invoked in a frame. IN_PROC_BROWSER_TEST_F(ExtensionContextMenuBrowserTest, Frames) { ExtensionTestMessageListener listener("created items", false); ASSERT_TRUE(LoadContextMenuExtension("frames")); ASSERT_TRUE(listener.WaitUntilSatisfied()); GURL page_url("http://www.google.com"); GURL no_frame_url; GURL frame_url("http://www.google.com"); ASSERT_TRUE(MenuHasItemWithLabel( page_url, GURL(), no_frame_url, std::string("Page item"))); ASSERT_FALSE(MenuHasItemWithLabel( page_url, GURL(), no_frame_url, std::string("Frame item"))); ASSERT_TRUE(MenuHasItemWithLabel( page_url, GURL(), frame_url, std::string("Page item"))); ASSERT_TRUE(MenuHasItemWithLabel( page_url, GURL(), frame_url, std::string("Frame item"))); }