blob: 9954c089703832c014e1a6e876e9f34551a1eea9 [file] [log] [blame]
// Copyright 2013 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_WEB_APPLICATIONS_COMPONENTS_WEB_APP_ICON_DOWNLOADER_H_
#define CHROME_BROWSER_WEB_APPLICATIONS_COMPONENTS_WEB_APP_ICON_DOWNLOADER_H_
#include <map>
#include <set>
#include <vector>
#include "base/callback.h"
#include "base/gtest_prod_util.h"
#include "base/macros.h"
#include "base/memory/weak_ptr.h"
#include "chrome/browser/web_applications/components/web_app_install_utils.h"
#include "content/public/browser/web_contents_observer.h"
class SkBitmap;
namespace content {
struct FaviconURL;
}
namespace gfx {
class Size;
}
namespace web_app {
// Class to help download all icons (including favicons and web app manifest
// icons) for a tab.
class WebAppIconDownloader : public content::WebContentsObserver {
public:
enum class Histogram {
kForCreate,
kForSync,
kForUpdate,
};
using WebAppIconDownloaderCallback =
base::OnceCallback<void(bool success, IconsMap icons_map)>;
// |extra_favicon_urls| allows callers to provide icon urls that aren't
// provided by the renderer (e.g touch icons on non-android environments).
// |https_status_code_class_histogram_name| optionally specifies a histogram
// to use for logging http status code class results from fetch attempts.
WebAppIconDownloader(content::WebContents* web_contents,
const std::vector<GURL>& extra_favicon_urls,
Histogram histogram,
WebAppIconDownloaderCallback callback);
~WebAppIconDownloader() override;
// Instructs the downloader to not query the page for favicons (e.g. when a
// favicon URL has already been provided in the constructor's
// |extra_favicon_urls| argument).
void SkipPageFavicons();
void Start();
private:
friend class TestWebAppIconDownloader;
// Initiates a download of the image at |url| and returns the download id.
// This is overridden in testing.
virtual int DownloadImage(const GURL& url);
// Queries FaviconDriver for the page's current favicon URLs.
// This is overridden in testing.
virtual std::vector<content::FaviconURL> GetFaviconURLsFromWebContents();
// Fetches icons for the given urls.
// |callback_| is run when all downloads complete.
void FetchIcons(const std::vector<content::FaviconURL>& favicon_urls);
void FetchIcons(const std::vector<GURL>& urls);
// Icon download callback.
void DidDownloadFavicon(int id,
int http_status_code,
const GURL& image_url,
const std::vector<SkBitmap>& bitmaps,
const std::vector<gfx::Size>& original_bitmap_sizes);
// content::WebContentsObserver overrides:
void DidFinishNavigation(
content::NavigationHandle* navigation_handle) override;
void DidUpdateFaviconURL(
const std::vector<content::FaviconURL>& candidates) override;
// Whether we need to fetch favicons from the renderer.
bool need_favicon_urls_;
// URLs that aren't given by WebContentsObserver::DidUpdateFaviconURL() that
// should be used for this favicon. This is necessary in order to get touch
// icons on non-android environments.
std::vector<GURL> extra_favicon_urls_;
// The icons which were downloaded. Populated by FetchIcons().
IconsMap icons_map_;
// Request ids of in-progress requests.
std::set<int> in_progress_requests_;
// Urls for which a download has already been initiated. Used to prevent
// duplicate downloads of the same url.
std::set<GURL> processed_urls_;
// Callback to run on favicon download completion.
WebAppIconDownloaderCallback callback_;
// Which histogram to log individual fetch results under.
Histogram histogram_;
base::WeakPtrFactory<WebAppIconDownloader> weak_ptr_factory_{this};
DISALLOW_COPY_AND_ASSIGN(WebAppIconDownloader);
};
} // namespace web_app
#endif // CHROME_BROWSER_WEB_APPLICATIONS_COMPONENTS_WEB_APP_ICON_DOWNLOADER_H_