ios/web/common/features.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_WEB_COMMON_FEATURES_H_
#define IOS_WEB_COMMON_FEATURES_H_

#include "base/feature_list.h"

namespace web {
namespace features {

// Used to crash the browser if unexpected URL change is detected.
// https://crbug.com/841105.
extern const base::Feature kCrashOnUnexpectedURLChange;

// Used to prevent native apps from being opened when a universal link is tapped
// and the user is browsing in off the record mode.
extern const base::Feature kBlockUniversalLinksInOffTheRecordMode;

// Used to ensure that the render is not suspended.
extern const base::Feature kKeepsRenderProcessAlive;

// Used to enable the workaround for a WKWebView WKNavigation leak.
// (crbug.com/1010765).  Clear older pending navigation records when a
// navigation finishes.
extern const base::Feature kClearOldNavigationRecordsWorkaround;

// Feature flag enabling persistent downloads.
extern const base::Feature kEnablePersistentDownloads;

// When enabled, preserves properties of the UIScrollView using CRWPropertyStore
// when the scroll view is recreated. When disabled, only preserve a small set
// of properties using hard coded logic.
extern const base::Feature kPreserveScrollViewProperties;

// Records snapshot size of image (IOS.Snapshots.ImageSize histogram) and PDF
// (IOS.Snapshots.PDFSize histogram) if enabled. Enabling this flag will
// generate PDF when Page Snapshot is taken just to record PDF size.
extern const base::Feature kRecordSnapshotSize;

// When enabled, the |attribution| property of NSMutableURLRequests passed to
// WKWebView is set as NSURLRequestAttributionUser on iOS 15.
extern const base::Feature kSetRequestAttribution;

// When enabled, the default context menu from WKWebView is used.
extern const base::Feature kDefaultWebViewContextMenu;

// Disables the screenshots of non-HTML pages on iOS15.
extern const base::Feature kDisableNonHTMLScreenshotOnIOS15;

// Feature flag that enable Shared Highlighting color change in iOS.
extern const base::Feature kIOSSharedHighlightingColorChange;

// Enable the new download API if available.
extern const base::Feature kEnableNewDownloadAPI;

// Feature flag that enables native session restoration with a synthesized
// interaction state.
extern const base::Feature kSynthesizedRestoreSession;

// Enable support for unrealized WebState upon session restoration.
// See //docs/ios/unrealized_web_state.md for more information.
extern const base::Feature kEnableUnrealizedWebStates;

// Enables user control for camera and/or microphone access for a specific site
// through site settings during its lifespan. When enabled, each web state will
// keep track of whether camera and/or microphone access is granted by the user
// for its current site.
extern const base::Feature kMediaPermissionsControl;

// Enables the Fullscreen API in WebKit (supported on iOS 16.0+). This API
// allows web sites to enter fullscreen mode, with all browser UI hidden.
extern const base::Feature kEnableFullscreenAPI;

// Feature flag enabling use of new iOS 15
// loadSimulatedRequest:responseHTMLString: API to display error pages in
// CRWWKNavigationHandler. The helper method IsLoadSimulatedRequestAPIEnabled()
// should be used instead of directly checking this feature.
extern const base::Feature kUseLoadSimulatedRequestForOfflinePage;

// When true, the native context menu for the web content are used.
bool UseWebViewNativeContextMenuWeb();

// When true, screenshots of non-HTML (e.g. PDF) pages should be taken.
bool ShouldTakeScreenshotOnNonHTMLContent();

// When true, the new download API should be used.
bool IsNewDownloadAPIEnabled();

// When true, user control for camera and/or microphone access should be
// enabled.
bool IsMediaPermissionsControlEnabled();

// When true, the new loadSimulatedRequest API should be used when displaying
// error pages.
bool IsLoadSimulatedRequestAPIEnabled();

}  // namespace features
}  // namespace web

#endif  // IOS_WEB_COMMON_FEATURES_H_