blob: 44dcd3ed415c20de9425b89122cda6f562d2398f [file] [log] [blame]
// Copyright 2018 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 EXTENSIONS_BROWSER_BROWSERTEST_UTIL_H_
#define EXTENSIONS_BROWSER_BROWSERTEST_UTIL_H_
#include <string>
#include "base/callback_forward.h"
namespace base {
class Value;
} // namespace base
namespace content {
class BrowserContext;
} // namespace content
namespace extensions {
namespace browsertest_util {
// Determine if a user activation notification should be triggered before
// executing a script
enum class ScriptUserActivation {
kActivate,
kDontActivate,
};
// Waits until |script| calls "window.domAutomationController.send(result)",
// where |result| is a string, and returns |result|. Fails the test and returns
// an empty string if |extension_id| isn't installed in |context| or doesn't
// have a background page, or if executing the script fails. The argument
// |script_user_activation| determines if the script should be executed after a
// user activation.
std::string ExecuteScriptInBackgroundPage(
content::BrowserContext* context,
const std::string& extension_id,
const std::string& script,
ScriptUserActivation script_user_activation =
ScriptUserActivation::kActivate);
// Same as ExecuteScriptInBackgroundPage, but doesn't wait for the script
// to return a result. Fails the test and returns false if |extension_id|
// isn't installed in |context| or doesn't have a background page, or if
// executing the script fails.
bool ExecuteScriptInBackgroundPageNoWait(content::BrowserContext* context,
const std::string& extension_id,
const std::string& script);
// Executes the given `script` in the context of the background service worker
// registered by the extension with the given `extension_id`. If non-empty,
// `callback` is invoked with the result of the execution.
void ExecuteScriptInServiceWorker(
content::BrowserContext* browser_context,
const std::string& extension_id,
const std::string& script,
base::OnceCallback<void(base::Value)> callback);
} // namespace browsertest_util
} // namespace extensions
#endif // EXTENSIONS_BROWSER_BROWSERTEST_UTIL_H_