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.
26 * @brief A class WebEngineCookieManager to wrap ewk cookie manager.
28 class WebEngineCookieManager
32 * @brief Enumeration for the cookies accept policies.
34 enum class CookieAcceptPolicy
36 ALWAYS, ///< Accepts every cookie sent from any page.
37 NEVER, ///< Rejects all the cookies.
38 NO_THIRD_PARTY, ///< Accepts only cookies set by the main document that is loaded.
42 * @brief Enumeration for the cookie persistent storage type.
44 enum class CookiePersistentStorage
46 TEXT, ///< Cookies are stored in a text file in the Mozilla "cookies.txt" format.
47 SQLITE, ///< Cookies are stored in a SQLite file in the current Mozilla format.
53 WebEngineCookieManager() = default;
58 virtual ~WebEngineCookieManager() = default;
61 * @brief Sets @a policy as the cookie acceptance policy for @a manager.
62 * @details By default, only cookies set by the main document loaded are
65 * @param[in] policy A #Dali::WebEngineCookieManager::CookieAcceptPolicy
67 virtual void SetCookieAcceptPolicy(CookieAcceptPolicy policy) = 0;
70 * @brief Gets the cookie acceptance policy.
71 * The default is Toolkit::WebEngineCookieManager::CookieAcceptPolicy::NO_THIRD_PARTY.
72 * @see Toolkit::WebEngineCookieManager::CookieAcceptPolicy::Type
74 virtual CookieAcceptPolicy GetCookieAcceptPolicy() const = 0;
77 * @brief Deletes all the cookies of @a manager.
79 virtual void ClearCookies() = 0;
82 * @brief Sets the @a path where non-session cookies are stored persistently using
83 * @a storage as the format to read/write the cookies.
84 * @details Cookies are initially read from @a path/Cookies to create an initial
85 * set of cookies. Then, non-session cookies will be written to @a path/Cookies.
86 * By default, @a manager doesn't store the cookies persistently, so you need to
87 * call this method to keep cookies saved across sessions.
88 * If @a path does not exist it will be created.
89 * @param[in] path The path where to read/write Cookies
90 * @param[in] storage The type of storage
92 virtual void SetPersistentStorage(const std::string& path, CookiePersistentStorage storage) = 0;
97 #endif // DALI_WEB_ENGINE_COOKIE_MANAGER_H