Download favicon from server for suggested articles

ios/chrome/browser/ui/content_suggestions/content_suggestions_data_source.h

 // Copyright 2017 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 IOS_CHROME_BROWSER_UI_CONTENT_SUGGESTIONS_CONTENT_SUGGESTIONS_DATA_SOURCE_H_
 #define IOS_CHROME_BROWSER_UI_CONTENT_SUGGESTIONS_CONTENT_SUGGESTIONS_DATA_SOURCE_H_
 
 @class ContentSuggestion;
 @class ContentSuggestionIdentifier;
 @class ContentSuggestionsSectionInformation;
@@ skipping 22 matching lines @@
 
 // Returns an image updater for the suggestions provided by this data source.
 - (nullable id<ContentSuggestionsImageFetcher>)imageFetcher;
 
 // Fetches favicon attributes and calls the completion block.
 - (void)fetchFaviconAttributesForURL:(const GURL&)URL
                           completion:
                               (void (^_Nonnull)(FaviconAttributes* _Nonnull))
                                   completion;
 
+// Fetches favicon image associated with this |suggestion| in history. If it is
+// not present in the history, tries to download it. Calls the completion block
+// if an image has been found.
+// This can only be used for public URL.
+- (void)
+fetchFaviconImageForSuggestion:(nonnull ContentSuggestionIdentifier*)suggestion
+                    completion:(void (^_Nonnull)(UIImage* _Nonnull))completion;
+
 // Fetches additional content. All the |knownSuggestions| must come from the
 // same |sectionInfo|. If the fetch was completed, the given |callback| is
 // called with the new content.
 - (void)fetchMoreSuggestionsKnowing:
             (nullable NSArray<ContentSuggestionIdentifier*>*)knownSuggestions
                     fromSectionInfo:
                         (nonnull ContentSuggestionsSectionInformation*)
                             sectionInfo
                            callback:(nullable MoreSuggestionsFetched)callback;
 
 @end
 
 #endif  // IOS_CHROME_BROWSER_UI_CONTENT_SUGGESTIONS_CONTENT_SUGGESTIONS_DATA_SOURCE_H_