AX: AOM: respect the accessibility setting for dispatching the accessible events
[WebKit-https.git] / Source / WebCore / testing / InternalSettings.h
1 /*
2  * Copyright (C) 2012 Google Inc. All rights reserved.
3  * Copyright (C) 2013-2016 Apple Inc. All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  *
9  * 1.  Redistributions of source code must retain the above copyright
10  *     notice, this list of conditions and the following disclaimer.
11  * 2.  Redistributions in binary form must reproduce the above copyright
12  *     notice, this list of conditions and the following disclaimer in the
13  *     documentation and/or other materials provided with the distribution.
14  *
15  * THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "AS IS" AND ANY
16  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
17  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
18  * DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS CONTRIBUTORS BE LIABLE FOR ANY
19  * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
20  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
21  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
22  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
23  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
24  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
25  */
26
27 #pragma once
28
29 // FIXME (121927): This include should not be needed.
30 #include <wtf/text/AtomicStringHash.h>
31
32 #include "EditingBehaviorTypes.h"
33 #include "ExceptionOr.h"
34 #include "FontGenericFamilies.h"
35 #include "IntSize.h"
36 #include "InternalSettingsGenerated.h"
37 #include "SecurityOrigin.h"
38 #include "Settings.h"
39 #include "WritingMode.h"
40
41 namespace WebCore {
42
43 class Page;
44 class Settings;
45
46 class InternalSettings : public InternalSettingsGenerated {
47 public:
48     static Ref<InternalSettings> create(Page*);
49     static InternalSettings* from(Page*);
50     void hostDestroyed();
51     void resetToConsistentState();
52
53     ExceptionOr<void> setUsesOverlayScrollbars(bool);
54     ExceptionOr<void> setTouchEventEmulationEnabled(bool);
55     ExceptionOr<void> setStandardFontFamily(const String& family, const String& script);
56     ExceptionOr<void> setSerifFontFamily(const String& family, const String& script);
57     ExceptionOr<void> setSansSerifFontFamily(const String& family, const String& script);
58     ExceptionOr<void> setFixedFontFamily(const String& family, const String& script);
59     ExceptionOr<void> setCursiveFontFamily(const String& family, const String& script);
60     ExceptionOr<void> setFantasyFontFamily(const String& family, const String& script);
61     ExceptionOr<void> setPictographFontFamily(const String& family, const String& script);
62     ExceptionOr<void> setTextAutosizingEnabled(bool);
63     ExceptionOr<void> setTextAutosizingWindowSizeOverride(int width, int height);
64     ExceptionOr<void> setTextAutosizingFontScaleFactor(float);
65     ExceptionOr<void> setMediaTypeOverride(const String&);
66     ExceptionOr<void> setCanStartMedia(bool);
67     ExceptionOr<void> setAllowsAirPlayForMediaPlayback(bool);
68     ExceptionOr<void> setMediaCaptureRequiresSecureConnection(bool);
69
70     ExceptionOr<void> setEditingBehavior(const String&);
71     ExceptionOr<void> setPreferMIMETypeForImages(bool);
72     ExceptionOr<void> setPDFImageCachingPolicy(const String&);
73     ExceptionOr<void> setShouldDisplayTrackKind(const String& kind, bool enabled);
74     ExceptionOr<bool> shouldDisplayTrackKind(const String& kind);
75     ExceptionOr<void> setStorageBlockingPolicy(const String&);
76     ExceptionOr<void> setImagesEnabled(bool);
77     ExceptionOr<void> setMinimumTimerInterval(double intervalInSeconds);
78     ExceptionOr<void> setDefaultVideoPosterURL(const String&);
79     ExceptionOr<void> setForcePendingWebGLPolicy(bool);
80     ExceptionOr<void> setTimeWithoutMouseMovementBeforeHidingControls(double);
81     ExceptionOr<void> setUseLegacyBackgroundSizeShorthandBehavior(bool);
82     ExceptionOr<void> setAutoscrollForDragAndDropEnabled(bool);
83     ExceptionOr<void> setFontFallbackPrefersPictographs(bool);
84     enum class FontLoadTimingOverride { Block, Swap, Failure };
85     ExceptionOr<void> setFontLoadTimingOverride(const FontLoadTimingOverride&);
86     ExceptionOr<void> setShouldIgnoreFontLoadCompletions(bool);
87     ExceptionOr<void> setQuickTimePluginReplacementEnabled(bool);
88     ExceptionOr<void> setYouTubeFlashPluginReplacementEnabled(bool);
89     ExceptionOr<void> setBackgroundShouldExtendBeyondPage(bool);
90     ExceptionOr<void> setShouldConvertPositionStyleOnCopy(bool);
91     ExceptionOr<void> setScrollingTreeIncludesFrames(bool);
92     ExceptionOr<void> setAllowUnclampedScrollPosition(bool);
93     ExceptionOr<void> setAllowsInlineMediaPlayback(bool);
94     ExceptionOr<void> setAllowsInlineMediaPlaybackAfterFullscreen(bool);
95     ExceptionOr<void> setInlineMediaPlaybackRequiresPlaysInlineAttribute(bool);
96     ExceptionOr<String> userInterfaceDirectionPolicy();
97     ExceptionOr<void> setUserInterfaceDirectionPolicy(const String&);
98     ExceptionOr<String> systemLayoutDirection();
99     ExceptionOr<void> setSystemLayoutDirection(const String&);
100     ExceptionOr<void> setShouldMockBoldSystemFontForAccessibility(bool);
101     ExceptionOr<void> setShouldManageAudioSessionCategory(bool);
102     ExceptionOr<void> setCustomPasteboardDataEnabled(bool);
103     ExceptionOr<void> setAccessibilityEventsEnabled(bool);
104
105     using FrameFlatteningValue = FrameFlattening;
106     ExceptionOr<void> setFrameFlattening(FrameFlatteningValue);
107     
108     static void setAllowsAnySSLCertificate(bool);
109
110     ExceptionOr<bool> deferredCSSParserEnabled();
111     ExceptionOr<void> setDeferredCSSParserEnabled(bool);
112
113     enum class ForcedAccessibilityValue { System, On, Off };
114     ForcedAccessibilityValue forcedColorsAreInvertedAccessibilityValue() const;
115     void setForcedColorsAreInvertedAccessibilityValue(ForcedAccessibilityValue);
116     ForcedAccessibilityValue forcedDisplayIsMonochromeAccessibilityValue() const;
117     void setForcedDisplayIsMonochromeAccessibilityValue(ForcedAccessibilityValue);
118     ForcedAccessibilityValue forcedPrefersReducedMotionAccessibilityValue() const;
119     void setForcedPrefersReducedMotionAccessibilityValue(ForcedAccessibilityValue);
120
121     // RuntimeEnabledFeatures.
122     static void setIndexedDBWorkersEnabled(bool);
123     static void setWebGL2Enabled(bool);
124     static void setWebGPUEnabled(bool);
125     static void setWebVREnabled(bool);
126     static void setScreenCaptureEnabled(bool);
127
128     static bool cssAnimationsAndCSSTransitionsBackedByWebAnimationsEnabled();
129
130 private:
131     explicit InternalSettings(Page*);
132
133     Settings& settings() const;
134     static const char* supplementName();
135
136     class Backup {
137     public:
138         explicit Backup(Settings&);
139         void restoreTo(Settings&);
140
141         EditingBehaviorType m_originalEditingBehavior;
142
143         // Initially empty, only used if changed by a test.
144         ScriptFontFamilyMap m_standardFontFamilies;
145         ScriptFontFamilyMap m_fixedFontFamilies;
146         ScriptFontFamilyMap m_serifFontFamilies;
147         ScriptFontFamilyMap m_sansSerifFontFamilies;
148         ScriptFontFamilyMap m_cursiveFontFamilies;
149         ScriptFontFamilyMap m_fantasyFontFamilies;
150         ScriptFontFamilyMap m_pictographFontFamilies;
151
152 #if ENABLE(TEXT_AUTOSIZING)
153         bool m_originalTextAutosizingEnabled;
154         IntSize m_originalTextAutosizingWindowSizeOverride;
155 #endif
156
157         String m_originalMediaTypeOverride;
158         bool m_originalCanvasUsesAcceleratedDrawing;
159         bool m_originalMockScrollbarsEnabled;
160         bool m_originalUsesOverlayScrollbars;
161         bool m_imagesEnabled;
162         bool m_preferMIMETypeForImages;
163         Seconds m_minimumDOMTimerInterval;
164 #if ENABLE(VIDEO_TRACK)
165         bool m_shouldDisplaySubtitles;
166         bool m_shouldDisplayCaptions;
167         bool m_shouldDisplayTextDescriptions;
168 #endif
169         String m_defaultVideoPosterURL;
170         bool m_forcePendingWebGLPolicy;
171         Seconds m_originalTimeWithoutMouseMovementBeforeHidingControls;
172         bool m_useLegacyBackgroundSizeShorthandBehavior;
173         bool m_autoscrollForDragAndDropEnabled;
174         bool m_quickTimePluginReplacementEnabled;
175         bool m_youTubeFlashPluginReplacementEnabled;
176         bool m_shouldConvertPositionStyleOnCopy;
177         bool m_fontFallbackPrefersPictographs;
178         bool m_shouldIgnoreFontLoadCompletions;
179         bool m_backgroundShouldExtendBeyondPage;
180         SecurityOrigin::StorageBlockingPolicy m_storageBlockingPolicy;
181         bool m_scrollingTreeIncludesFrames;
182 #if ENABLE(TOUCH_EVENTS)
183         bool m_touchEventEmulationEnabled;
184 #endif
185 #if ENABLE(WIRELESS_PLAYBACK_TARGET)
186         bool m_allowsAirPlayForMediaPlayback;
187 #endif
188         bool m_allowsInlineMediaPlayback;
189         bool m_allowsInlineMediaPlaybackAfterFullscreen;
190         bool m_inlineMediaPlaybackRequiresPlaysInlineAttribute;
191         bool m_deferredCSSParserEnabled;
192         bool m_inputEventsEnabled;
193 #if ENABLE(ACCESSIBILITY_EVENTS)
194         bool m_accessibilityEventsEnabled;
195 #endif
196         UserInterfaceDirectionPolicy m_userInterfaceDirectionPolicy;
197         TextDirection m_systemLayoutDirection;
198         PDFImageCachingPolicy m_pdfImageCachingPolicy;
199         Settings::ForcedAccessibilityValue m_forcedColorsAreInvertedAccessibilityValue;
200         Settings::ForcedAccessibilityValue m_forcedDisplayIsMonochromeAccessibilityValue;
201         Settings::ForcedAccessibilityValue m_forcedPrefersReducedMotionAccessibilityValue;
202         Settings::FontLoadTimingOverride m_fontLoadTimingOverride;
203         FrameFlattening m_frameFlattening;
204
205         // Runtime enabled settings.
206         bool m_indexedDBWorkersEnabled;
207         bool m_webGL2Enabled;
208         bool m_webGPUEnabled;
209         bool m_webVREnabled;
210         bool m_setScreenCaptureEnabled;
211         
212         bool m_shouldMockBoldSystemFontForAccessibility;
213 #if USE(AUDIO_SESSION)
214         bool m_shouldManageAudioSessionCategory;
215 #endif
216         bool m_customPasteboardDataEnabled;
217     };
218
219     Page* m_page;
220     Backup m_backup;
221 };
222
223 } // namespace WebCore