Chromium Embedded Framework (CEF)  126.2.0+g5c56e98+chromium-126.0.6478.62
cef_request_context_settings_t Struct Reference

Request context initialization settings. More...

#include "include/internal/cef_types.h"

Public Attributes

size_t size
 Size of this structure. More...
 
cef_string_t cache_path
 The directory where cache data for this request context will be stored on disk. More...
 
int persist_session_cookies
 To persist session cookies (cookies without an expiry date or validity interval) by default when using the global cookie manager set this value to true (1). More...
 
int persist_user_preferences
 To persist user preferences as a JSON file in the cache path directory set this value to true (1). More...
 
cef_string_t accept_language_list
 Comma delimited ordered list of language codes without any whitespace that will be used in the "Accept-Language" HTTP request header and "navigator.language" JS attribute. More...
 
cef_string_t cookieable_schemes_list
 Comma delimited list of schemes supported by the associated CefCookieManager. More...
 
int cookieable_schemes_exclude_defaults
 

Detailed Description

Request context initialization settings.

Specify NULL or 0 to get the recommended default values.

Member Data Documentation

◆ accept_language_list

cef_string_t cef_request_context_settings_t::accept_language_list

Comma delimited ordered list of language codes without any whitespace that will be used in the "Accept-Language" HTTP request header and "navigator.language" JS attribute.

Can be set globally using the CefSettings.accept_language_list value. If all values are empty then "en-US,en" will be used. This value will be ignored if |cache_path| matches the CefSettings.cache_path value.

◆ cache_path

cef_string_t cef_request_context_settings_t::cache_path

The directory where cache data for this request context will be stored on disk.

If this value is non-empty then it must be an absolute path that is either equal to or a child directory of CefSettings.root_cache_path. If this value is empty then browsers will be created in "incognito mode" where in-memory caches are used for storage and no profile-specific data is persisted to disk (installation-specific data will still be persisted in root_cache_path). HTML5 databases such as localStorage will only persist across sessions if a cache path is specified. To share the global browser cache and related configuration set this value to match the CefSettings.cache_path value.

◆ cookieable_schemes_exclude_defaults

int cef_request_context_settings_t::cookieable_schemes_exclude_defaults

◆ cookieable_schemes_list

cef_string_t cef_request_context_settings_t::cookieable_schemes_list

Comma delimited list of schemes supported by the associated CefCookieManager.

If |cookieable_schemes_exclude_defaults| is false (0) the default schemes ("http", "https", "ws" and "wss") will also be supported. Not specifying a |cookieable_schemes_list| value and setting |cookieable_schemes_exclude_defaults| to true (1) will disable all loading and saving of cookies. These values will be ignored if |cache_path| matches the CefSettings.cache_path value.

◆ persist_session_cookies

int cef_request_context_settings_t::persist_session_cookies

To persist session cookies (cookies without an expiry date or validity interval) by default when using the global cookie manager set this value to true (1).

Session cookies are generally intended to be transient and most Web browsers do not persist them. Can be set globally using the CefSettings.persist_session_cookies value. This value will be ignored if |cache_path| is empty or if it matches the CefSettings.cache_path value.

◆ persist_user_preferences

int cef_request_context_settings_t::persist_user_preferences

To persist user preferences as a JSON file in the cache path directory set this value to true (1).

Can be set globally using the CefSettings.persist_user_preferences value. This value will be ignored if |cache_path| is empty or if it matches the CefSettings.cache_path value.

◆ size

size_t cef_request_context_settings_t::size

Size of this structure.


The documentation for this struct was generated from the following file: