servo_config/
prefs.rs

1/* This Source Code Form is subject to the terms of the Mozilla Public
2 * License, v. 2.0. If a copy of the MPL was not distributed with this
3 * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
4
5use std::env::consts::ARCH;
6use std::sync::{RwLock, RwLockReadGuard};
7
8use serde::{Deserialize, Serialize};
9use servo_config_macro::ServoPreferences;
10
11pub use crate::pref_util::PrefValue;
12
13static PREFERENCES: RwLock<Preferences> = RwLock::new(Preferences::const_default());
14
15pub trait PreferencesObserver: Send + Sync {
16    fn prefs_changed(&self, _changes: &[(&'static str, PrefValue)]) {}
17}
18
19static OBSERVERS: RwLock<Vec<Box<dyn PreferencesObserver>>> = RwLock::new(Vec::new());
20
21#[inline]
22/// Get the current set of global preferences for Servo.
23pub fn get() -> RwLockReadGuard<'static, Preferences> {
24    PREFERENCES.read().unwrap()
25}
26
27pub fn add_observer(observer: Box<dyn PreferencesObserver>) {
28    OBSERVERS.write().unwrap().push(observer);
29}
30
31pub fn set(preferences: Preferences) {
32    // Map between Stylo preference names and Servo preference names as the This should be
33    // kept in sync with components/script/dom/bindings/codegen/run.py which generates the
34    // DOM CSS style accessors.
35    stylo_config::set_bool("layout.unimplemented", preferences.layout_unimplemented);
36    stylo_config::set_i32("layout.threads", preferences.layout_threads as i32);
37    stylo_config::set_bool("layout.flexbox.enabled", preferences.layout_flexbox_enabled);
38    stylo_config::set_bool("layout.columns.enabled", preferences.layout_columns_enabled);
39    stylo_config::set_bool("layout.grid.enabled", preferences.layout_grid_enabled);
40    stylo_config::set_bool(
41        "layout.css.transition-behavior.enabled",
42        preferences.layout_css_transition_behavior_enabled,
43    );
44    stylo_config::set_bool(
45        "layout.writing-mode.enabled",
46        preferences.layout_writing_mode_enabled,
47    );
48    stylo_config::set_bool(
49        "layout.container-queries.enabled",
50        preferences.layout_container_queries_enabled,
51    );
52    stylo_config::set_bool(
53        "layout.variable_fonts.enabled",
54        preferences.layout_variable_fonts_enabled,
55    );
56
57    let changed = preferences.diff(&PREFERENCES.read().unwrap());
58
59    *PREFERENCES.write().unwrap() = preferences;
60
61    for observer in &*OBSERVERS.read().unwrap() {
62        observer.prefs_changed(&changed);
63    }
64}
65
66/// A convenience macro for accessing a preference value using its static path.
67/// Passing an invalid path is a compile-time error.
68#[macro_export]
69macro_rules! pref {
70    ($name: ident) => {
71        $crate::prefs::get().$name.clone()
72    };
73}
74
75#[derive(Clone, Deserialize, Serialize, ServoPreferences)]
76pub struct Preferences {
77    pub fonts_default: String,
78    pub fonts_serif: String,
79    pub fonts_sans_serif: String,
80    pub fonts_monospace: String,
81    pub fonts_default_size: i64,
82    pub fonts_default_monospace_size: i64,
83    pub css_animations_testing_enabled: bool,
84    /// Start the devtools server at startup
85    pub devtools_server_enabled: bool,
86    /// Port number to start a server to listen to remote Firefox devtools connections.
87    /// 0 for random port.
88    pub devtools_server_port: i64,
89    // feature: WebGPU | #24706 | Web/API/WebGPU_API
90    pub dom_webgpu_enabled: bool,
91    /// List of comma-separated backends to be used by wgpu.
92    pub dom_webgpu_wgpu_backend: String,
93    // feature: AbortController | #34866 | Web/API/AbortController
94    pub dom_abort_controller_enabled: bool,
95    // feature: Adopted Stylesheet | #38132 | Web/API/Document/adoptedStyleSheets
96    pub dom_adoptedstylesheet_enabled: bool,
97    // feature: Clipboard API | #36084 | Web/API/Clipboard_API
98    pub dom_async_clipboard_enabled: bool,
99    pub dom_bluetooth_enabled: bool,
100    pub dom_bluetooth_testing_enabled: bool,
101    pub dom_allow_scripts_to_close_windows: bool,
102    // feature: Media Capture and Streams API | #26861 | Web/API/Media_Capture_and_Streams_API
103    pub dom_canvas_capture_enabled: bool,
104    pub dom_canvas_text_enabled: bool,
105    /// Selects canvas backend
106    ///
107    /// Available values:
108    /// - ` `/`auto`
109    /// - vello
110    /// - vello_cpu
111    pub dom_canvas_backend: String,
112    pub dom_clipboardevent_enabled: bool,
113    pub dom_command_invokers_enabled: bool,
114    pub dom_composition_event_enabled: bool,
115    // feature: CookieStore | #37674 | Web/API/CookieStore
116    pub dom_cookiestore_enabled: bool,
117    // feature: Credential Management API | #38788 | Web/API/Credential_Management_API
118    pub dom_credential_management_enabled: bool,
119    // feature: WebCrypto API | #40687 | Web/API/Web_Crypto_API
120    pub dom_crypto_subtle_enabled: bool,
121    pub dom_document_dblclick_timeout: i64,
122    pub dom_document_dblclick_dist: i64,
123    // feature: CSS Font Loading API | #29376 | Web/API/CSS_Font_Loading_API
124    pub dom_fontface_enabled: bool,
125    pub dom_fullscreen_test: bool,
126    // feature: Gamepad API | #10977 | Web/API/Gamepad_API
127    pub dom_gamepad_enabled: bool,
128    // feature: Geolocation API | #38903 | Web/API/Geolocation_API
129    pub dom_geolocation_enabled: bool,
130    // feature: IndexedDB | #6963 | Web/API/IndexedDB_API
131    pub dom_indexeddb_enabled: bool,
132    // feature: IntersectionObserver | #35767 | Web/API/Intersection_Observer_API
133    pub dom_intersection_observer_enabled: bool,
134    pub dom_microdata_testing_enabled: bool,
135    pub dom_uievent_which_enabled: bool,
136    // feature: MutationObserver | #6633 | Web/API/MutationObserver
137    pub dom_mutation_observer_enabled: bool,
138    // feature: Navigator.registerProtocolHandler() | #40615 | Web/API/Navigator/registerProtocolHandler
139    pub dom_navigator_protocol_handlers_enabled: bool,
140    // feature: Notification API | #34841 | Web/API/Notifications_API
141    pub dom_notification_enabled: bool,
142    // feature: OffscreenCanvas | #34111 | Web/API/OffscreenCanvas
143    pub dom_offscreen_canvas_enabled: bool,
144    pub dom_parallel_css_parsing_enabled: bool,
145    // feature: Permissions API | #31235 | Web/API/Permissions_API
146    pub dom_permissions_enabled: bool,
147    pub dom_permissions_testing_allowed_in_nonsecure_contexts: bool,
148    // feature: ResizeObserver | #39790 | Web/API/ResizeObserver
149    pub dom_resize_observer_enabled: bool,
150    pub dom_script_asynch: bool,
151    // feature: ServiceWorker | #36538 | Web/API/Service_Worker_API
152    pub dom_serviceworker_enabled: bool,
153    pub dom_serviceworker_timeout_seconds: i64,
154    pub dom_servo_helpers_enabled: bool,
155    pub dom_servoparser_async_html_tokenizer_enabled: bool,
156    pub dom_testable_crash_enabled: bool,
157    pub dom_testbinding_enabled: bool,
158    pub dom_testbinding_prefcontrolled_enabled: bool,
159    pub dom_testbinding_prefcontrolled2_enabled: bool,
160    pub dom_testbinding_preference_value_falsy: bool,
161    pub dom_testbinding_preference_value_quote_string_test: String,
162    pub dom_testbinding_preference_value_space_string_test: String,
163    pub dom_testbinding_preference_value_string_empty: String,
164    pub dom_testbinding_preference_value_string_test: String,
165    pub dom_testbinding_preference_value_truthy: bool,
166    pub dom_testing_element_activation_enabled: bool,
167    pub dom_testing_html_input_element_select_files_enabled: bool,
168    pub dom_testperf_enabled: bool,
169    // https://testutils.spec.whatwg.org#availability
170    pub dom_testutils_enabled: bool,
171    /// Enable WebGL2 APIs.
172    // feature: WebGL2 | #41394 | Web/API/WebGL2RenderingContext
173    pub dom_webgl2_enabled: bool,
174    // feature: WebRTC | #41396 | Web/API/WebRTC_API
175    pub dom_webrtc_enabled: bool,
176    // feature: WebRTC Transceiver | #41396 | Web/API/RTCRtpTransceiver
177    pub dom_webrtc_transceiver_enabled: bool,
178    // feature: WebVTT | #22312 | Web/API/WebVTT_API
179    pub dom_webvtt_enabled: bool,
180    pub dom_webxr_enabled: bool,
181    pub dom_webxr_test: bool,
182    pub dom_webxr_first_person_observer_view: bool,
183    pub dom_webxr_glwindow_enabled: bool,
184    pub dom_webxr_glwindow_left_right: bool,
185    pub dom_webxr_glwindow_red_cyan: bool,
186    pub dom_webxr_glwindow_spherical: bool,
187    pub dom_webxr_glwindow_cubemap: bool,
188    pub dom_webxr_hands_enabled: bool,
189    // feature: WebXR Layers | #27468 | Web/API/XRCompositionLayer
190    pub dom_webxr_layers_enabled: bool,
191    pub dom_webxr_openxr_enabled: bool,
192    pub dom_webxr_sessionavailable: bool,
193    pub dom_webxr_unsafe_assume_user_intent: bool,
194    pub dom_worklet_enabled: bool,
195    pub dom_worklet_blockingsleep: bool,
196    pub dom_worklet_testing_enabled: bool,
197    pub dom_worklet_timeout_ms: i64,
198    /// <https://drafts.csswg.org/cssom-view/#the-visualviewport-interface>
199    // feature: VisualViewport | #41341 | Web/API/VisualViewport
200    pub dom_visual_viewport_enabled: bool,
201    /// True to compile all WebRender shaders when Servo initializes. This is mostly
202    /// useful when modifying the shaders, to ensure they all compile after each change is
203    /// made.
204    pub gfx_precache_shaders: bool,
205    /// Whether or not antialiasing is enabled for text rendering.
206    pub gfx_text_antialiasing_enabled: bool,
207    /// Whether or not subpixel antialiasing is enabled for text rendering.
208    pub gfx_subpixel_text_antialiasing_enabled: bool,
209    pub gfx_texture_swizzling_enabled: bool,
210    /// The amount of image keys we request per batch for the image cache.
211    pub image_key_batch_size: i64,
212    /// Whether or not the DOM inspector should show shadow roots of user-agent shadow trees
213    pub inspector_show_servo_internal_shadow_roots: bool,
214    pub js_asmjs_enabled: bool,
215    pub js_asyncstack: bool,
216    pub js_baseline_interpreter_enabled: bool,
217    /// Whether to disable the jit within SpiderMonkey
218    pub js_disable_jit: bool,
219    pub js_baseline_jit_enabled: bool,
220    pub js_baseline_jit_unsafe_eager_compilation_enabled: bool,
221    pub js_discard_system_source: bool,
222    pub js_dump_stack_on_debuggee_would_run: bool,
223    pub js_ion_enabled: bool,
224    pub js_ion_offthread_compilation_enabled: bool,
225    pub js_ion_unsafe_eager_compilation_enabled: bool,
226    pub js_mem_gc_allocation_threshold_mb: i64,
227    pub js_mem_gc_allocation_threshold_factor: i64,
228    pub js_mem_gc_allocation_threshold_avoid_interrupt_factor: i64,
229    pub js_mem_gc_compacting_enabled: bool,
230    pub js_mem_gc_decommit_threshold_mb: i64,
231    pub js_mem_gc_dynamic_heap_growth_enabled: bool,
232    pub js_mem_gc_dynamic_mark_slice_enabled: bool,
233    pub js_mem_gc_empty_chunk_count_min: i64,
234    pub js_mem_gc_high_frequency_heap_growth_max: i64,
235    pub js_mem_gc_high_frequency_heap_growth_min: i64,
236    pub js_mem_gc_high_frequency_high_limit_mb: i64,
237    pub js_mem_gc_high_frequency_low_limit_mb: i64,
238    pub js_mem_gc_high_frequency_time_limit_ms: i64,
239    pub js_mem_gc_incremental_enabled: bool,
240    pub js_mem_gc_incremental_slice_ms: i64,
241    pub js_mem_gc_low_frequency_heap_growth: i64,
242    pub js_mem_gc_per_zone_enabled: bool,
243    pub js_mem_gc_zeal_frequency: i64,
244    pub js_mem_gc_zeal_level: i64,
245    pub js_mem_max: i64,
246    pub js_native_regex_enabled: bool,
247    pub js_offthread_compilation_enabled: bool,
248    pub js_shared_memory: bool,
249    pub js_throw_on_asmjs_validation_failure: bool,
250    pub js_throw_on_debuggee_would_run: bool,
251    pub js_timers_minimum_duration: i64,
252    pub js_wasm_baseline_enabled: bool,
253    pub js_wasm_enabled: bool,
254    pub js_wasm_ion_enabled: bool,
255    pub js_werror_enabled: bool,
256    // feature: Largest Contentful Paint | #42000 | Web/API/LargestContentfulPaint
257    pub largest_contentful_paint_enabled: bool,
258    pub layout_animations_test_enabled: bool,
259    // feature: CSS Multicol | #22397 | Web/CSS/Guides/Multicol_layout
260    pub layout_columns_enabled: bool,
261    // feature: CSS Grid | #34479 | Web/CSS/Guides/Grid_layout
262    pub layout_grid_enabled: bool,
263    pub layout_container_queries_enabled: bool,
264    pub layout_css_transition_behavior_enabled: bool,
265    // feature: CSS Flexbox | #12453 | Web/CSS/Guides/Flexible_box_layout
266    pub layout_flexbox_enabled: bool,
267    pub layout_style_sharing_cache_enabled: bool,
268    pub layout_threads: i64,
269    pub layout_unimplemented: bool,
270    // feature: Variable fonts | #38800 | Web/CSS/Guides/Fonts/Variable_fonts
271    pub layout_variable_fonts_enabled: bool,
272    // feature: CSS writing modes | #2560 | Web/CSS/Guides/Writing_modes
273    pub layout_writing_mode_enabled: bool,
274    /// Enable hardware acceleration for video playback.
275    pub media_glvideo_enabled: bool,
276    /// Enable a non-standard event handler for verifying behavior of media elements during tests.
277    pub media_testing_enabled: bool,
278    /// The default timeout set for establishing a network connection in seconds. This amount
279    /// if for the entire process of connecting to an address. For instance, if a particular host is
280    /// associated with multiple IP addresses, this timeout will be divided equally among
281    /// each IP address.
282    pub network_connection_timeout: u64,
283    pub network_enforce_tls_enabled: bool,
284    pub network_enforce_tls_localhost: bool,
285    pub network_enforce_tls_onion: bool,
286    pub network_http_cache_disabled: bool,
287    /// A url for a http proxy. We treat an empty string as no proxy.
288    pub network_http_proxy_uri: String,
289    /// A url for a https proxy. We treat an empty string as no proxy.
290    pub network_https_proxy_uri: String,
291    /// The domains for which we will not have a proxy. No effect if `network_http_proxy_uri` is not set.
292    /// The exact behavior is given by
293    /// <https://docs.rs/hyper-util/latest/hyper_util/client/proxy/matcher/struct.Builder.html#method.no>
294    pub network_http_no_proxy: String,
295    /// The weight of the http memory cache
296    /// Notice that this is not equal to the number of different urls in the cache.
297    pub network_http_cache_size: u64,
298    pub network_local_directory_listing_enabled: bool,
299    pub network_mime_sniff: bool,
300    /// Force the use of `rust-webpki` verification for CA roots. If this is false (the
301    /// default), then `rustls-platform-verifier` will be used, except on Android where
302    /// `rust-webpki` is always used.
303    pub network_use_webpki_roots: bool,
304    pub session_history_max_length: i64,
305    /// The background color of shell's viewport. This will be used by OpenGL's `glClearColor`.
306    pub shell_background_color_rgba: [f64; 4],
307    pub webgl_testing_context_creation_error: bool,
308    /// Number of workers per threadpool, if we fail to detect how much
309    /// parallelism is available at runtime.
310    pub threadpools_fallback_worker_num: i64,
311    /// Maximum number of workers for the Image Cache thread pool
312    pub threadpools_image_cache_workers_max: i64,
313    /// Maximum number of workers for the IndexedDB thread pool
314    pub threadpools_indexeddb_workers_max: i64,
315    /// Maximum number of workers for the Web Storage thread pool
316    pub threadpools_webstorage_workers_max: i64,
317    /// Maximum number of workers for the Networking async runtime thread pool
318    pub threadpools_async_runtime_workers_max: i64,
319    /// Maximum number of workers for webrender
320    pub threadpools_webrender_workers_max: i64,
321    /// The user-agent to use for Servo. This can also be set via [`UserAgentPlatform`] in
322    /// order to set the value to the default value for the given platform.
323    pub user_agent: String,
324    /// Whether or not the viewport meta tag is enabled.
325    pub viewport_meta_enabled: bool,
326    pub log_filter: String,
327}
328
329impl Preferences {
330    const fn const_default() -> Self {
331        Self {
332            css_animations_testing_enabled: false,
333            devtools_server_enabled: false,
334            devtools_server_port: 0,
335            dom_abort_controller_enabled: true,
336            dom_adoptedstylesheet_enabled: false,
337            dom_allow_scripts_to_close_windows: false,
338            dom_async_clipboard_enabled: false,
339            dom_bluetooth_enabled: false,
340            dom_bluetooth_testing_enabled: false,
341            dom_canvas_capture_enabled: false,
342            dom_canvas_text_enabled: true,
343            dom_canvas_backend: String::new(),
344            dom_clipboardevent_enabled: true,
345            dom_command_invokers_enabled: false,
346            dom_composition_event_enabled: false,
347            dom_cookiestore_enabled: false,
348            dom_credential_management_enabled: false,
349            dom_crypto_subtle_enabled: true,
350            dom_document_dblclick_dist: 1,
351            dom_document_dblclick_timeout: 300,
352            dom_fontface_enabled: false,
353            dom_fullscreen_test: false,
354            dom_gamepad_enabled: true,
355            dom_geolocation_enabled: false,
356            dom_indexeddb_enabled: false,
357            dom_intersection_observer_enabled: false,
358            dom_microdata_testing_enabled: false,
359            dom_uievent_which_enabled: true,
360            dom_mutation_observer_enabled: true,
361            dom_navigator_protocol_handlers_enabled: false,
362            dom_notification_enabled: false,
363            dom_parallel_css_parsing_enabled: true,
364            dom_offscreen_canvas_enabled: false,
365            dom_permissions_enabled: false,
366            dom_permissions_testing_allowed_in_nonsecure_contexts: false,
367            dom_resize_observer_enabled: true,
368            dom_script_asynch: true,
369            dom_serviceworker_enabled: false,
370            dom_serviceworker_timeout_seconds: 60,
371            dom_servo_helpers_enabled: false,
372            dom_servoparser_async_html_tokenizer_enabled: false,
373            dom_testable_crash_enabled: false,
374            dom_testbinding_enabled: false,
375            dom_testbinding_prefcontrolled2_enabled: false,
376            dom_testbinding_prefcontrolled_enabled: false,
377            dom_testbinding_preference_value_falsy: false,
378            dom_testbinding_preference_value_quote_string_test: String::new(),
379            dom_testbinding_preference_value_space_string_test: String::new(),
380            dom_testbinding_preference_value_string_empty: String::new(),
381            dom_testbinding_preference_value_string_test: String::new(),
382            dom_testbinding_preference_value_truthy: false,
383            dom_testing_element_activation_enabled: false,
384            dom_testing_html_input_element_select_files_enabled: false,
385            dom_testperf_enabled: false,
386            dom_testutils_enabled: false,
387            dom_webgl2_enabled: false,
388            dom_webgpu_enabled: false,
389            dom_webgpu_wgpu_backend: String::new(),
390            dom_webrtc_enabled: false,
391            dom_webrtc_transceiver_enabled: false,
392            dom_webvtt_enabled: false,
393            dom_webxr_enabled: true,
394            dom_webxr_first_person_observer_view: false,
395            dom_webxr_glwindow_cubemap: false,
396            dom_webxr_glwindow_enabled: true,
397            dom_webxr_glwindow_left_right: false,
398            dom_webxr_glwindow_red_cyan: false,
399            dom_webxr_glwindow_spherical: false,
400            dom_webxr_hands_enabled: true,
401            dom_webxr_layers_enabled: false,
402            dom_webxr_openxr_enabled: true,
403            dom_webxr_sessionavailable: false,
404            dom_webxr_test: false,
405            dom_webxr_unsafe_assume_user_intent: false,
406            dom_worklet_blockingsleep: false,
407            dom_worklet_enabled: false,
408            dom_worklet_testing_enabled: false,
409            dom_worklet_timeout_ms: 10,
410            dom_visual_viewport_enabled: false,
411            fonts_default: String::new(),
412            fonts_default_monospace_size: 13,
413            fonts_default_size: 16,
414            fonts_monospace: String::new(),
415            fonts_sans_serif: String::new(),
416            fonts_serif: String::new(),
417            gfx_precache_shaders: false,
418            gfx_text_antialiasing_enabled: true,
419            gfx_subpixel_text_antialiasing_enabled: true,
420            gfx_texture_swizzling_enabled: true,
421            image_key_batch_size: 10,
422            inspector_show_servo_internal_shadow_roots: false,
423            js_asmjs_enabled: true,
424            js_asyncstack: false,
425            js_baseline_interpreter_enabled: true,
426            js_baseline_jit_enabled: true,
427            js_baseline_jit_unsafe_eager_compilation_enabled: false,
428            js_disable_jit: false,
429            js_discard_system_source: false,
430            js_dump_stack_on_debuggee_would_run: false,
431            js_ion_enabled: true,
432            js_ion_offthread_compilation_enabled: true,
433            js_ion_unsafe_eager_compilation_enabled: false,
434            js_mem_gc_allocation_threshold_avoid_interrupt_factor: 100,
435            js_mem_gc_allocation_threshold_factor: 100,
436            js_mem_gc_allocation_threshold_mb: 30,
437            js_mem_gc_compacting_enabled: true,
438            js_mem_gc_decommit_threshold_mb: 32,
439            js_mem_gc_dynamic_heap_growth_enabled: true,
440            js_mem_gc_dynamic_mark_slice_enabled: true,
441            js_mem_gc_empty_chunk_count_min: 1,
442            js_mem_gc_high_frequency_heap_growth_max: 300,
443            js_mem_gc_high_frequency_heap_growth_min: 150,
444            js_mem_gc_high_frequency_high_limit_mb: 500,
445            js_mem_gc_high_frequency_low_limit_mb: 100,
446            js_mem_gc_high_frequency_time_limit_ms: 1000,
447            js_mem_gc_incremental_enabled: true,
448            js_mem_gc_incremental_slice_ms: 10,
449            js_mem_gc_low_frequency_heap_growth: 150,
450            js_mem_gc_per_zone_enabled: false,
451            js_mem_gc_zeal_frequency: 100,
452            js_mem_gc_zeal_level: 0,
453            js_mem_max: -1,
454            js_native_regex_enabled: true,
455            js_offthread_compilation_enabled: true,
456            js_shared_memory: true,
457            js_throw_on_asmjs_validation_failure: false,
458            js_throw_on_debuggee_would_run: false,
459            js_timers_minimum_duration: 1000,
460            js_wasm_baseline_enabled: true,
461            js_wasm_enabled: true,
462            js_wasm_ion_enabled: true,
463            js_werror_enabled: false,
464            largest_contentful_paint_enabled: false,
465            layout_animations_test_enabled: false,
466            layout_columns_enabled: false,
467            layout_container_queries_enabled: false,
468            layout_css_transition_behavior_enabled: true,
469            layout_flexbox_enabled: true,
470            layout_grid_enabled: false,
471            layout_style_sharing_cache_enabled: true,
472            // TODO(mrobinson): This should likely be based on the number of processors.
473            layout_threads: 3,
474            layout_unimplemented: false,
475            layout_variable_fonts_enabled: false,
476            layout_writing_mode_enabled: false,
477            media_glvideo_enabled: false,
478            media_testing_enabled: false,
479            network_connection_timeout: 15,
480            network_enforce_tls_enabled: false,
481            network_enforce_tls_localhost: false,
482            network_enforce_tls_onion: false,
483            network_http_cache_disabled: false,
484            network_http_proxy_uri: String::new(),
485            network_https_proxy_uri: String::new(),
486            network_http_no_proxy: String::new(),
487            network_http_cache_size: 5000,
488            network_local_directory_listing_enabled: true,
489            network_mime_sniff: false,
490            network_use_webpki_roots: false,
491            session_history_max_length: 20,
492            shell_background_color_rgba: [1.0, 1.0, 1.0, 1.0],
493            threadpools_async_runtime_workers_max: 6,
494            threadpools_fallback_worker_num: 3,
495            threadpools_image_cache_workers_max: 4,
496            threadpools_indexeddb_workers_max: 4,
497            threadpools_webstorage_workers_max: 4,
498            threadpools_webrender_workers_max: 4,
499            webgl_testing_context_creation_error: false,
500            user_agent: String::new(),
501            viewport_meta_enabled: false,
502            log_filter: String::new(),
503        }
504    }
505}
506
507impl Default for Preferences {
508    fn default() -> Self {
509        let mut preferences = Self::const_default();
510        preferences.user_agent = UserAgentPlatform::default().to_user_agent_string();
511        if let Ok(proxy_uri) = std::env::var("http_proxy").or_else(|_| std::env::var("HTTP_PROXY"))
512        {
513            preferences.network_http_proxy_uri = proxy_uri;
514        }
515        if let Ok(proxy_uri) =
516            std::env::var("https_proxy").or_else(|_| std::env::var("HTTPS_PROXY"))
517        {
518            preferences.network_https_proxy_uri = proxy_uri;
519        }
520        if let Ok(no_proxy) = std::env::var("no_proxy").or_else(|_| std::env::var("NO_PROXY")) {
521            preferences.network_http_no_proxy = no_proxy
522        }
523
524        preferences
525    }
526}
527
528pub enum UserAgentPlatform {
529    Desktop,
530    Android,
531    OpenHarmony,
532    Ios,
533}
534
535impl UserAgentPlatform {
536    /// Return the default `UserAgentPlatform` for this platform. This is
537    /// not an implementation of `Default` so that it can be `const`.
538    pub const fn default() -> Self {
539        if cfg!(target_os = "android") {
540            Self::Android
541        } else if cfg!(target_env = "ohos") {
542            Self::OpenHarmony
543        } else if cfg!(target_os = "ios") {
544            Self::Ios
545        } else {
546            Self::Desktop
547        }
548    }
549}
550
551impl UserAgentPlatform {
552    /// Convert this [`UserAgentPlatform`] into its corresponding `String` value, ie the
553    /// default user-agent to use for this platform.
554    pub fn to_user_agent_string(&self) -> String {
555        const SERVO_VERSION: &str = env!("CARGO_PKG_VERSION");
556        match self {
557            UserAgentPlatform::Desktop
558                if cfg!(all(target_os = "windows", target_arch = "x86_64")) =>
559            {
560                format!(
561                    "Mozilla/5.0 (Windows NT 10.0; Win64; {ARCH}rv:140.0) Servo/{SERVO_VERSION} Firefox/140.0"
562                )
563            },
564            UserAgentPlatform::Desktop if cfg!(target_os = "macos") => {
565                format!(
566                    "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:140.0) Servo/{SERVO_VERSION} Firefox/140.0"
567                )
568            },
569            UserAgentPlatform::Desktop => {
570                format!(
571                    "Mozilla/5.0 (X11; Linux {ARCH}; rv:140.0) Servo/{SERVO_VERSION} Firefox/140.0"
572                )
573            },
574            UserAgentPlatform::Android => {
575                format!(
576                    "Mozilla/5.0 (Android 10; Mobile; rv:140.0) Servo/{SERVO_VERSION} Firefox/140.0"
577                )
578            },
579            UserAgentPlatform::OpenHarmony => format!(
580                "Mozilla/5.0 (OpenHarmony; Mobile; rv:140.0) Servo/{SERVO_VERSION} Firefox/140.0"
581            ),
582            UserAgentPlatform::Ios => format!(
583                "Mozilla/5.0 (iPhone; CPU iPhone OS 18_6 like Mac OS X; rv:140.0) Servo/{SERVO_VERSION} Firefox/140.0"
584            ),
585        }
586    }
587}
servo_config/prefs.rs

servo_config/
prefs.rs
