// Copyright (c) 2012 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. #ifndef CHROME_BROWSER_EXTENSIONS_EXTENSION_APITEST_H_ #define CHROME_BROWSER_EXTENSIONS_EXTENSION_APITEST_H_ #include #include #include "base/compiler_specific.h" #include "base/values.h" #include "chrome/browser/extensions/extension_browsertest.h" #include "content/public/browser/notification_registrar.h" namespace base { class FilePath; } namespace extensions { class Extension; } // The general flow of these API tests should work like this: // (1) Setup initial browser state (e.g. create some bookmarks for the // bookmark test) // (2) Call ASSERT_TRUE(RunExtensionTest(name)); // (3) In your extension code, run your test and call chrome.test.pass or // chrome.test.fail // (4) Verify expected browser state. // TODO(erikkay): There should also be a way to drive events in these tests. class ExtensionApiTest : public ExtensionBrowserTest { public: // Flags used to configure how the tests are run. // TODO(aa): Many of these are dupes of ExtensionBrowserTest::Flags. Combine // somehow? enum Flags { kFlagNone = 0, // Allow the extension to run in incognito mode. kFlagEnableIncognito = 1 << 0, // Launch the test page in an incognito window. kFlagUseIncognito = 1 << 1, // Allow file access for the extension. kFlagEnableFileAccess = 1 << 2, // Loads the extension with location COMPONENT. kFlagLoadAsComponent = 1 << 3, // Launch the extension as a platform app. kFlagLaunchPlatformApp = 1 << 4, // Don't fail when the loaded manifest has warnings. kFlagIgnoreManifestWarnings = 1 << 5, // Allow manifest versions older that Extension::kModernManifestVersion. // Used to test old manifest features. kFlagAllowOldManifestVersions = 1 << 6, }; ExtensionApiTest(); ~ExtensionApiTest() override; protected: // InProcessBrowserTest: void SetUpInProcessBrowserTestFixture() override; void TearDownInProcessBrowserTestFixture() override; // Load |extension_name| and wait for pass / fail notification. // |extension_name| is a directory in "test/data/extensions/api_test". bool RunExtensionTest(const std::string& extension_name); // Same as RunExtensionTest, but enables the extension for incognito mode. bool RunExtensionTestIncognito(const std::string& extension_name); // Same as RunExtensionTest, but ignores any warnings in the manifest. bool RunExtensionTestIgnoreManifestWarnings( const std::string& extension_name); // Same as RunExtensionTest, allow old manifest ersions. bool RunExtensionTestAllowOldManifestVersion( const std::string& extension_name); // Same as RunExtensionTest, but loads extension as component. bool RunComponentExtensionTest(const std::string& extension_name); // Same as RunExtensionTest, but disables file access. bool RunExtensionTestNoFileAccess(const std::string& extension_name); // Same as RunExtensionTestIncognito, but disables file access. bool RunExtensionTestIncognitoNoFileAccess(const std::string& extension_name); // Returns true if the Subtest and Page tests are being skipped. This is // will only be true for windows debug builds, see http://crbug.com/177163. // // Usually you won't need to check this, but if a test continues after // RunExtensionSubtest, you may. For example, if a test calls // RunExtensionSubtest then asserts that the Extension was installed, it will // fail on win debug builds. bool ExtensionSubtestsAreSkipped(); // If not empty, Load |extension_name|, load |page_url| and wait for pass / // fail notification from the extension API on the page. Note that if // |page_url| is not a valid url, it will be treated as a resource within // the extension. |extension_name| is a directory in // "test/data/extensions/api_test". bool RunExtensionSubtest(const std::string& extension_name, const std::string& page_url); // Same as RunExtensionSubtest, except run with the specific |flags| // (as defined in the Flags enum). bool RunExtensionSubtest(const std::string& extension_name, const std::string& page_url, int flags); // Load |page_url| and wait for pass / fail notification from the extension // API on the page. bool RunPageTest(const std::string& page_url); bool RunPageTest(const std::string& page_url, int flags); // Similar to RunExtensionTest, except used for running tests in platform app // shell windows. bool RunPlatformAppTest(const std::string& extension_name); // Similar to RunPlatformAppTest, except sets an additional string argument // |customArg| to the test config object. bool RunPlatformAppTestWithArg( const std::string& extension_name, const char* custom_arg); // Similar to RunPlatformAppTest, with custom |flags| (as defined in the Flags // enum). The kFlagLaunchPlatformApp flag is automatically added. bool RunPlatformAppTestWithFlags(const std::string& extension_name, int flags); // Start the test server, and store details of its state. Those details // will be available to javascript tests using chrome.test.getConfig(). bool StartEmbeddedTestServer(); // Start the test WebSocket server, and store details of its state. Those // details will be available to javascript tests using // chrome.test.getConfig(). bool StartWebSocketServer(const base::FilePath& root_directory); // Start the test FTP server, and store details of its state. Those // details will be available to JavaScript tests using // chrome.test.getConfig(). bool StartFTPServer(const base::FilePath& root_directory); // Test that exactly one extension loaded. If so, return a pointer to // the extension. If not, return NULL and set message_. const extensions::Extension* GetSingleLoadedExtension(); // All extensions tested by ExtensionApiTest are in the "api_test" dir. void SetUpCommandLine(base::CommandLine* command_line) override; // If it failed, what was the error message? std::string message_; private: bool RunExtensionTestImpl(const std::string& extension_name, const std::string& test_page, const char* custom_arg, int flags); // Hold details of the test, set in C++, which can be accessed by // javascript using chrome.test.getConfig(). scoped_ptr test_config_; // Hold the test WebSocket server. scoped_ptr websocket_server_; // Hold the test FTP server. scoped_ptr ftp_server_; }; #endif // CHROME_BROWSER_EXTENSIONS_EXTENSION_APITEST_H_