59b6df5878
Reference: https://google.github.io/styleguide/cppguide.html#Function_Comments > If function argument names are provided in backticks, then code-indexing tools may be able to present the documentation better. Bug: chromium:346952289 Change-Id: I9fa9538795e0e14814f2631d5b5e72a5a7a9fb87 Reviewed-on: https://chromium-review.googlesource.com/c/chromium/src/+/6497221 Commit-Queue: Solomon Kinard <solomonkinard@chromium.org> Reviewed-by: David Bertoni <dbertoni@chromium.org> Cr-Commit-Position: refs/heads/main@{#1453692}
85 lines
2.8 KiB
C++
85 lines
2.8 KiB
C++
// Copyright 2013 The Chromium Authors
|
|
// Use of this source code is governed by a BSD-style license that can be
|
|
// found in the LICENSE file.
|
|
|
|
#ifndef CHROME_BROWSER_EXTENSIONS_BROWSERTEST_UTIL_H_
|
|
#define CHROME_BROWSER_EXTENSIONS_BROWSERTEST_UTIL_H_
|
|
|
|
#include <string>
|
|
#include "base/run_loop.h"
|
|
#include "chrome/browser/extensions/extension_action_runner.h"
|
|
|
|
class Browser;
|
|
class GURL;
|
|
class Profile;
|
|
|
|
namespace base {
|
|
class RunLoop;
|
|
}
|
|
|
|
namespace content {
|
|
class WebContents;
|
|
}
|
|
|
|
namespace extensions {
|
|
|
|
class Extension;
|
|
|
|
namespace browsertest_util {
|
|
|
|
#if BUILDFLAG(IS_CHROMEOS)
|
|
// On chromeos, the extension cache directory must be initialized before
|
|
// extensions can be installed in some situations (e.g. policy force installs
|
|
// via update urls). The chromeos device setup scripts take care of this in
|
|
// actual production devices, but some tests need to do it manually.
|
|
void CreateAndInitializeLocalCache();
|
|
#endif
|
|
|
|
// Launches a new app window for `app` in `profile`.
|
|
Browser* LaunchAppBrowser(Profile* profile, const Extension* app);
|
|
|
|
// Adds a tab to `browser` and returns the newly added WebContents.
|
|
content::WebContents* AddTab(Browser* browser, const GURL& url);
|
|
|
|
// Returns the number of WindowControllers with the Profile `profile`.
|
|
size_t GetWindowControllerCountInProfile(Profile* profile);
|
|
|
|
// Returns whether the given `web_contents` has the associated
|
|
// `changed_title`. If the web contents has neither `changed_title`
|
|
// nor `original_title `, adds a failure to the test (for an unexpected
|
|
// title).
|
|
bool DidChangeTitle(content::WebContents& web_contents,
|
|
const std::u16string& original_title,
|
|
const std::u16string& changed_title);
|
|
|
|
// Can be used to wait for blocked actions (pending scripts, web requests, etc.)
|
|
// to be noticed in tests. Blocked actions recording initiates in the renderer
|
|
// so this helps when waiting from the browser side. This should be used on the
|
|
// stack for proper destruction.
|
|
class BlockedActionWaiter : public ExtensionActionRunner::TestObserver {
|
|
public:
|
|
// `runner` must outlive this object.
|
|
explicit BlockedActionWaiter(ExtensionActionRunner* runner);
|
|
BlockedActionWaiter(const BlockedActionWaiter&) = delete;
|
|
BlockedActionWaiter& operator=(const BlockedActionWaiter&) = delete;
|
|
~BlockedActionWaiter() override;
|
|
|
|
// Wait for the blocked action until the observer is called with the blocked
|
|
// action being added.
|
|
void Wait();
|
|
|
|
private:
|
|
// ExtensionActionRunner::TestObserver:
|
|
void OnBlockedActionAdded() override;
|
|
|
|
base::ScopedObservation<ExtensionActionRunner,
|
|
ExtensionActionRunner::TestObserver>
|
|
action_runner_observation_{this};
|
|
base::RunLoop run_loop_;
|
|
};
|
|
|
|
} // namespace browsertest_util
|
|
} // namespace extensions
|
|
|
|
#endif // CHROME_BROWSER_EXTENSIONS_BROWSERTEST_UTIL_H_
|