blob: c74ae817262142dcf7807808a11efb92545cce1f [file] [log] [blame]
// Copyright 2014 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_WEB_PUBLIC_WEB_CLIENT_H_
#define IOS_WEB_PUBLIC_WEB_CLIENT_H_
#include <map>
#include <memory>
#include <string>
#include <vector>
#include "base/callback.h"
#include "base/optional.h"
#include "base/strings/string16.h"
#include "base/strings/string_piece.h"
#include "base/task/thread_pool/thread_pool_instance.h"
#include "base/values.h"
#include "ios/web/common/user_agent.h"
#include "mojo/public/cpp/bindings/generic_pending_receiver.h"
#include "ui/base/layout.h"
namespace base {
class RefCountedMemory;
}
class GURL;
@class UIWebView;
@class NSString;
namespace net {
class SSLInfo;
}
namespace web {
class BrowserState;
class BrowserURLRewriter;
class SerializableUserDataManager;
class WebClient;
class WebMainParts;
class WebState;
// Setter and getter for the client. The client should be set early, before any
// web code is called.
void SetWebClient(WebClient* client);
WebClient* GetWebClient();
// Interface that the embedder of the web layer implements.
class WebClient {
public:
WebClient();
virtual ~WebClient();
// Allows the embedder to set a custom WebMainParts implementation for the
// browser startup code.
virtual std::unique_ptr<WebMainParts> CreateWebMainParts();
// Gives the embedder a chance to perform tasks before a web view is created.
virtual void PreWebViewCreation() const {}
// An embedder may support schemes that are otherwise unknown to lower-level
// components. To control how /net/url and other components interpret urls of
// such schemes, the embedder overrides |AddAdditionalSchemes| and adds to the
// vectors inside the |Schemes| structure.
struct Schemes {
Schemes();
~Schemes();
// "Standard" (RFC3986 syntax) schemes.
std::vector<std::string> standard_schemes;
// See https://www.w3.org/TR/powerful-features/#is-origin-trustworthy.
std::vector<std::string> secure_schemes;
};
// Gives the embedder a chance to register its own standard and secure url
// schemes early on in the startup sequence.
virtual void AddAdditionalSchemes(Schemes* schemes) const {}
// Returns the embedding application locale string.
virtual std::string GetApplicationLocale() const;
// Returns true if URL has application specific schema. Embedder must return
// true for every custom app specific schema it supports. For example Chromium
// browser would return true for "chrome://about" URL.
virtual bool IsAppSpecificURL(const GURL& url) const;
// Returns true if URL should not be restored.
virtual bool ShouldBlockUrlDuringRestore(const GURL& url,
WebState* web_state) const;
// Allow embedder to inject data.
virtual void AddSerializableData(
web::SerializableUserDataManager* user_data_manager,
web::WebState* web_state);
// Returns text to be displayed for an unsupported plugin.
virtual base::string16 GetPluginNotSupportedText() const;
// Returns the user agent string for the specified type.
virtual std::string GetUserAgent(UserAgentType type) const;
// Returns a string resource given its id.
virtual base::string16 GetLocalizedString(int message_id) const;
// Returns the contents of a resource in a StringPiece given the resource id.
virtual base::StringPiece GetDataResource(int resource_id,
ui::ScaleFactor scale_factor) const;
// Returns the raw bytes of a scale independent data resource.
virtual base::RefCountedMemory* GetDataResourceBytes(int resource_id) const;
// Returns a list of additional WebUI schemes, if any. These additional
// schemes act as aliases to the about: scheme. The additional schemes may or
// may not serve specific WebUI pages depending on the particular
// URLDataSourceIOS and its override of
// URLDataSourceIOS::ShouldServiceRequest. For all schemes returned here,
// view-source is allowed.
virtual void GetAdditionalWebUISchemes(
std::vector<std::string>* additional_schemes) {}
// Gives the embedder a chance to add url rewriters to the BrowserURLRewriter
// singleton.
virtual void PostBrowserURLRewriterCreation(BrowserURLRewriter* rewriter) {}
// Gives the embedder a chance to provide the JavaScript to be injected into
// the web view as early as possible. Result must not be nil.
// The script returned will be injected in all frames (main and subframes).
//
// TODO(crbug.com/703964): Change the return value to NSArray<NSString*> to
// improve performance.
virtual NSString* GetDocumentStartScriptForAllFrames(
BrowserState* browser_state) const;
// Gives the embedder a chance to provide the JavaScript to be injected into
// the web view as early as possible. Result must not be nil.
// The script returned will only be injected in the main frame.
//
// TODO(crbug.com/703964): Change the return value to NSArray<NSString*> to
// improve performance.
virtual NSString* GetDocumentStartScriptForMainFrame(
BrowserState* browser_state) const;
// Allows the embedder to bind an interface request for a WebState-scoped
// interface that originated from the main frame of |web_state|. Called if
// |web_state| could not bind the receiver itself.
virtual void BindInterfaceReceiverFromMainFrame(
WebState* web_state,
mojo::GenericPendingReceiver receiver) {}
// Informs the embedder that a certificate error has occurred. |cert_error| is
// a network error code defined in //net/base/net_error_list.h. If
// |overridable| is true, the user can ignore the error and continue.
// |navigation_id| is retrieved from NavigationContext::GetNavigationId() and
// indicates which navigation triggered the certificate error. The embedder
// can call the |callback| asynchronously (an argument of true means that
// |cert_error| should be ignored and web// should load the page).
virtual void AllowCertificateError(WebState* web_state,
int cert_error,
const net::SSLInfo& ssl_info,
const GURL& request_url,
bool overridable,
int64_t navigation_id,
base::OnceCallback<void(bool)> callback);
// Allows the embedder to specify legacy TLS enforcement on a per-host basis,
// for example to allow users to bypass interstitial warnings on affected
// hosts.
virtual bool IsLegacyTLSAllowedForHost(WebState* web_state,
const std::string& hostname);
// Calls the given |callback| with the contents of an error page to display
// when a navigation error occurs. |error| is always a valid pointer. The
// string passed to |callback| will be nil if no error page should be
// displayed. Otherwise, this string will contain the details of the error
// and maybe links to more info. |info| will have a value for SSL cert errors
// and otherwise be nullopt. |navigation_id| is passed into this method so
// that in the case of an SSL cert error, the blocking page can be associated
// with the tab.
virtual void PrepareErrorPage(WebState* web_state,
const GURL& url,
NSError* error,
bool is_post,
bool is_off_the_record,
const base::Optional<net::SSLInfo>& info,
int64_t navigation_id,
base::OnceCallback<void(NSString*)> callback);
// Instructs the embedder to return a container that is attached to a window.
virtual UIView* GetWindowedContainer();
// Enables the logic to handle long press and force
// touch through action sheet. Should return false to use the context menu
// API. Defaults to return true.
virtual bool EnableLongPressAndForceTouchHandling() const;
// Enables the logic to handle long press context menu with UIContextMenu.
virtual bool EnableLongPressUIContextMenu() const;
// This method is used when the user didn't express any preference for the
// version of |url|. Returning true allows to make sure that for |url|, the
// mobile version will be used, unless the user explicitly requested the
// desktop version. This method can be overriden to avoid having specific URL
// being requested in desktop mode when the default mode is desktop.
virtual bool ForceMobileVersionByDefault(const GURL& url);
// Returns the UserAgentType that should be used by default for the web
// content, based on the size class of |web_view| and the |url|.
virtual UserAgentType GetDefaultUserAgent(id<UITraitEnvironment> web_view,
const GURL& url);
// Returns whether the embedders could block restore urls.
virtual bool IsEmbedderBlockRestoreUrlEnabled();
};
} // namespace web
#endif // IOS_WEB_PUBLIC_WEB_CLIENT_H_