1 #ifndef DALI_WEB_ENGINE_COOKIE_MANAGER_H
2 #define DALI_WEB_ENGINE_COOKIE_MANAGER_H
5 * Copyright (c) 2021 Samsung Electronics Co., Ltd.
7 * Licensed under the Apache License, Version 2.0 (the "License");
8 * you may not use this file except in compliance with the License.
9 * You may obtain a copy of the License at
11 * http://www.apache.org/licenses/LICENSE-2.0
13 * Unless required by applicable law or agreed to in writing, software
14 * distributed under the License is distributed on an "AS IS" BASIS,
15 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16 * See the License for the specific language governing permissions and
17 * limitations under the License.
27 * @brief A class WebEngineCookieManager to wrap ewk cookie manager.
29 class WebEngineCookieManager
35 * @brief Enumeration for the cookies accept policies.
37 enum class CookieAcceptPolicy
39 ALWAYS, ///< Accepts every cookie sent from any page.
40 NEVER, ///< Rejects all the cookies.
41 NO_THIRD_PARTY, ///< Accepts only cookies set by the main document that is loaded.
45 * @brief Enumeration for the cookie persistent storage type.
47 enum class CookiePersistentStorage
49 TEXT, ///< Cookies are stored in a text file in the Mozilla "cookies.txt" format.
50 SQLITE, ///< Cookies are stored in a SQLite file in the current Mozilla format.
56 WebEngineCookieManager() = default;
61 virtual ~WebEngineCookieManager() = default;
64 * @brief Sets @a policy as the cookie acceptance policy for @a manager.
65 * @details By default, only cookies set by the main document loaded are
68 * @param[in] policy A #Dali::WebEngineCookieManager::CookieAcceptPolicy
70 virtual void SetCookieAcceptPolicy( CookieAcceptPolicy policy ) = 0;
73 * @brief Gets the cookie acceptance policy.
74 * The default is Toolkit::WebEngineCookieManager::CookieAcceptPolicy::NO_THIRD_PARTY.
75 * @see Toolkit::WebEngineCookieManager::CookieAcceptPolicy::Type
77 virtual CookieAcceptPolicy GetCookieAcceptPolicy() const = 0;
80 * @brief Deletes all the cookies of @a manager.
82 virtual void ClearCookies() = 0;
85 * @brief Sets the @a path where non-session cookies are stored persistently using
86 * @a storage as the format to read/write the cookies.
87 * @details Cookies are initially read from @a path/Cookies to create an initial
88 * set of cookies. Then, non-session cookies will be written to @a path/Cookies.
89 * By default, @a manager doesn't store the cookies persistently, so you need to
90 * call this method to keep cookies saved across sessions.
91 * If @a path does not exist it will be created.
92 * @param[in] path The path where to read/write Cookies
93 * @param[in] storage The type of storage
95 virtual void SetPersistentStorage( const std::string& path, CookiePersistentStorage storage ) = 0;
101 #endif // DALI_WEB_ENGINE_COOKIE_MANAGER_H