| Name | Date | Size | #Lines | LOC | ||
|---|---|---|---|---|---|---|
| .. | - | - | ||||
| AppScope/ | 22-Oct-2025 | - | 35 | 32 | ||
| entry/ | 22-Oct-2025 | - | 1,769 | 1,540 | ||
| hvigor/ | 22-Oct-2025 | - | 38 | 36 | ||
| screenshots/ | 22-Oct-2025 | - | ||||
| .gitignore | D | 22-Oct-2025 | 133 | 12 | 12 | |
| README.md | D | 22-Oct-2025 | 11.6 KiB | 315 | 194 | |
| build-profile.json5 | D | 22-Oct-2025 | 1.3 KiB | 52 | 51 | |
| code-linter.json5 | D | 22-Oct-2025 | 958 | 35 | 34 | |
| hvigorfile.ts | D | 22-Oct-2025 | 843 | 22 | 5 | |
| oh-package.json5 | D | 22-Oct-2025 | 834 | 26 | 24 | |
| ohosTest.md | D | 22-Oct-2025 | 6.1 KiB | 85 | 56 |
README.md
1# 使用隐私模式 2 3### 介绍 4 51. 实现对以下指南文档中 https://docs.openharmony.cn/pages/v5.0/zh-cn/application-dev/web/web-incognito-mode.md 示例代码片段的工程化，保证指南中示例代码与sample工程文件同源。 6 7### AllowGeolocation 8 9#### 介绍 10 111. 本示例主要介绍使用隐私模式，将可选参数incognitoMode设置为true，来开启Web组件的隐私模式，通过allowGeolocation设置隐私模式下的Web组件允许指定来源使用地理位置。 12 13#### 效果预览 14 15| 主页 | 16| ----------------------------------------------------------- | 17| <img src="screenshots\AllowGeolocation.png" width="360;" /> | 18 19使用说明 20 211. 将可选参数incognitoMode设置为true，来开启Web组件的隐私模式 222. 点击按钮通过allowGeolocation设置隐私模式下的Web组件允许指定来源使用地理位置。 23 24### ClearAllCookiesSync 25 26#### 介绍 27 281. 本示例主要介绍使用隐私模式，将可选参数incognitoMode设置为true，来开启Web组件的隐私模式，通过clearAllCookiesSync清除隐私模式下所有cookie。 29 30#### 效果预览 31 32| 主页 | 33| ------------------------------------------------------------ | 34| <img src="screenshots\ClearAllCookiesSync.png" width="360;" /> | 35 36使用说明 37 381. 将可选参数incognitoMode设置为true，来开启Web组件的隐私模式。 391. 点击按钮通过clearAllCookiesSync清除隐私模式下所有cookie。 40 41### ConfigCookieSync 42 43#### 介绍 44 451. 本示例主要介绍使用隐私模式，将可选参数incognitoMode设置为true，来开启Web组件的隐私模式，通过configCookieSync设置隐私模式下指定url的单个cookie的值。 46 47#### 效果预览 48 49| 主页 | 50| ----------------------------------------------------------- | 51| <img src="screenshots\ConfigCookieSync.png" width="360;" /> | 52 53使用说明 54 551. 将可选参数incognitoMode设置为true，来开启Web组件的隐私模式。 562. 点击按钮通过configCookieSync设置隐私模式下指定url的单个cookie的值。 57 58### DeleteAllData 59 60#### 介绍 61 621. 本示例主要介绍使用隐私模式，将可选参数incognitoMode设置为true，来开启Web组件的隐私模式，通过deleteAllData清除隐私模式下Web SQL当前使用的所有存储。 63 64#### 效果预览 65 66| 主页 | 67| -------------------------------------------------------- | 68| <img src="screenshots\DeleteAllData.png" width="360;" /> | 69 70使用说明 71 721，将可选参数incognitoMode设置为true，来开启Web组件的隐私模式。 73 742 , 点击按钮通过deleteAllData清除隐私模式下Web SQL当前使用的所有存储。 75 76### DeleteGeolocation 77 78#### 介绍 79 801. 本示例主要介绍使用隐私模式，将可选参数incognitoMode设置为true，来开启Web组件的隐私模式，通过deleteGeolocation清除隐私模式下指定来源的地理位置权限状态。 81 82#### 效果预览 83 84| 主页 | 85| ------------------------------------------------------------ | 86| <img src="screenshots\DeleteGeolocation.png" width="360;" /> | 87 88使用说明 89 901. 将可选参数incognitoMode设置为true，来开启Web组件的隐私模式。 912. 点击按钮通过deleteGeolocation清除隐私模式下指定来源的地理位置权限状态。 92 93### ExistCookie 94 95#### 介绍 96 971. 本示例主要介绍使用隐私模式，将可选参数incognitoMode设置为true，来开启Web组件的隐私模式，通过existCookie查询隐私模式下是否存在cookie。 98 99#### 效果预览 100 101| 主页 | 102| ------------------------------------------------------ | 103| <img src="screenshots\ExistCookie.png" width="360;" /> | 104 105使用说明 106 1071. 将可选参数incognitoMode设置为true，来开启Web组件的隐私模式。 1082. 点击按钮通过existCookie查询隐私模式下是否存在cookie。 109 110### FetchCookieSync 111 112#### 介绍 113 1141. 本示例主要介绍使用隐私模式，将可选参数incognitoMode设置为true，来开启Web组件的隐私模式，通过fetchCookieSync获取隐私模式下指定url对应cookie的值。 115 116#### 效果预览 117 118| 主页 | 119| ---------------------------------------------------------- | 120| <img src="screenshots\FetchCookieSync.png" width="360;" /> | 121 122使用说明 123 1241. 将可选参数incognitoMode设置为true，来开启Web组件的隐私模式。 1252. 点击按钮通过fetchCookieSync获取隐私模式下指定url对应cookie的值。 126 127### GetAccessibleGeolocation 128 129#### 介绍 130 1311. 本示例主要介绍使用隐私模式，将可选参数incognitoMode设置为true，来开启Web组件的隐私模式，通过getAccessibleGeolocation以回调方式异步获取隐私模式下指定源的地理位置权限状态。 132 133#### 效果预览 134 135| 主页 | 136| ------------------------------------------------------------ | 137| <img src="screenshots\GetAccessibleGeolocation.png" width="360;" /> | 138 139使用说明 140 1411. 将可选参数incognitoMode设置为true，来开启Web组件的隐私模式。 1422. 点击按钮通过getAccessibleGeolocation以回调方式异步获取隐私模式下指定源的地理位置权限状态。 143 144### IncognitoMode_one 145 146#### 介绍 147 1481. 本示例主要介绍使用隐私模式，将可选参数incognitoMode设置为true，来开启Web组件的隐私模式，当使用隐私模式时，浏览网页时的Cookie、 Cache Data等数据不会保存在本地的持久化文件，当隐私模式的Web组件被销毁时，Cookie、 Cache Data等数据将不被记录下来。 149 150#### 效果预览 151 152| 主页 | 153| ------------------------------------------------------------ | 154| <img src="screenshots\IncognitoMode_one.png" width="360;" /> | 155 156使用说明 157 1581. 将可选参数incognitoMode设置为true，创建隐私模式的Web组件。 159 160### IncognitoMode_two 161 162#### 介绍 163 1641. 本示例主要介绍使用隐私模式，通过isIncogntoMode判断当前Web组件是否是隐私模式。 165 166#### 效果预览 167 168| 主页 | 169| ------------------------------------------------------------ | 170| <img src="screenshots\IncognitoMode_two.png" width="360;" /> | 171 172使用说明 173 1741. 点击按钮通过isIncogntoMode判断当前Web组件是否是隐私模式。 175 176# 在新窗口中打开页面 177 178### OpenPageNewWin 179 180#### 介绍 181 1821. 本示例主要介绍在新窗口中打开页面，通过multiWindowAccess()接口来设置是否允许网页在新窗口打开。 1832. 实现对以下指南文档中 https://docs.openharmony.cn/pages/v5.0/zh-cn/application-dev/web/web-open-in-new-window.md 示例代码片段的工程化，保证指南中示例代码与sample工程文件同源。 184 185#### 效果预览 186 187| 主页 | 新窗口页面 | 188| ----------------------------------------------------------- | ----------------------------------------------------------- | 189| <img src="screenshots\OpenPageNewWin_1.png" width="360;" /> | <img src="screenshots\OpenPageNewWin_2.png" width="360;" /> | 190 191使用说明 192 1931. 通过multiWindowAccess()接口来设置是否允许网页在新窗口打开。 1941. 点击按钮在新窗口打开网页。 195 196# 管理位置权限 197 198### ManageLocPerms 199 200#### 介绍 201 2021. 本示例主要介绍管理位置权限，可以通过onGeolocationShow()接口对某个网站进行位置权限管理。Web组件根据接口响应结果，决定是否赋予前端页面权限。 2032. 实现对以下指南文档中 https://gitee.com/openharmony/docs/blob/OpenHarmony-5.0.1-Release/zh-cn/application-dev/web/web-geolocation-permission.md 示例代码片段的工程化，保证指南中示例代码与sample工程文件同源。 204 205#### 效果预览 206 207| 主页 | 提示框 | 208| ----------------------------------------------------------- | ----------------------------------------------------------- | 209| <img src="screenshots\ManageLocPerms_1.png" width="360;" /> | <img src="screenshots\ManageLocPerms_2.png" width="360;" /> | 210 211使用说明 212 2131. 通过onGeolocationShow()接口对某个网站进行位置权限管理。 2141. 点击按钮，Web组件通过弹窗的形式通知应用侧位置权限请求消息。 215 216# 设置深色模式 217 218### 介绍 219 2201. 实现对以下指南文档中 https://docs.openharmony.cn/pages/v5.0/zh-cn/application-dev/web/web-set-dark-mode.md 示例代码片段的工程化，保证指南中示例代码与sample工程文件同源。 221 222### DarkMode_one 223 224#### 介绍 225 2261. 本示例主要介绍对前端页面进行深色模式配置，使用darkMode()接口可以配置不同的深色模式。 227 228#### 效果预览 229 230| 主页 | 231| ------------------------------------------------------- | 232| <img src="screenshots\DarkMode_one.png" width="360;" /> | 233 234使用说明 235 2361. 使用darkMode()接口将页面深色模式配置为跟随系统。 237 238### DarkMode_two 239 240#### 介绍 241 2421. 本示例主要介绍对前端页面进行深色模式配置，通过forceDarkAccess()接口可将前端页面强制配置深色模式。 243 244#### 效果预览 245 246| 主页 | 247| ------------------------------------------------------- | 248| <img src="screenshots\DarkMode_two.png" width="360;" /> | 249 250使用说明 251 2521. 将深色模式配置成WebDarkMode.On，并通过forceDarkAccess()接口将页面强制配置为深色模式。 253 254## 工程目录 255 256``` 257entry/src/main/ 258|---ets 259|---|---entryability 260|---|---|---EntryAbility.ets 261|---|---pages 262|---|---|---Index.ets // 首页 263|---|---|---DarkMode_one.ets 264|---|---|---DarkMode_two.ets 265|---|---|---AllowGeolocation 266|---|---|---ClearAllCookiesSync 267|---|---|---ConfigCookieSync 268|---|---|---DeleteAllData 269|---|---|---DeleteGeolocation 270|---|---|---ExistCookie 271|---|---|---FetchCookieSync 272|---|---|---GetAccessibleGeolocation 273|---|---|---IncognitoMode_one 274|---|---|---IncognitoMode_two 275|---|---|---OpenPageNewWin.ets 276|---|---|---ManageLocPerms.ets 277|---resources // 静态资源 278|---ohosTest 279|---|---ets 280|---|---|---tests 281|---|---|---|---Ability.test.ets // 自动化测试用例 282``` 283 284## 相关权限 285 286[ohos.permission.INTERNET](https://docs.openharmony.cn/pages/v5.0/zh-cn/application-dev/security/AccessToken/permissions-for-all.md#ohospermissioninternet) 287 288[ohos.permission.LOCATION](https://docs.openharmony.cn/pages/v5.0/zh-cn/application-dev/security/AccessToken/permissions-for-all.md#ohospermissionlocation) 289 290[ohos.permission.APPROXIMATELY_LOCATION](https://docs.openharmony.cn/pages/v5.0/zh-cn/application-dev/security/AccessToken/permissions-for-all.md#ohospermissionapproximatelylocation) 291 292[ohos.permission.LOCATION_IN_BACKGROUND](https://docs.openharmony.cn/pages/v5.0/zh-cn/application-dev/security/AccessToken/permissions-for-all.md#ohospermissionlocationinbackground) 293 294## 依赖 295 296不涉及。 297 298## 约束与限制 299 3001. 本示例仅支持标准系统上运行，支持设备：RK3568。 3012. 本示例支持API14版本SDK，SDK版本号(API Version 14 Release)。 3023. 本示例需要使用DevEco Studio 版本号(5.0.1Release)才可编译运行。 303 304## 下载 305 306如需单独下载本工程，执行如下命令： 307 308``` 309git init 310git config core.sparsecheckout true 311echo code/DocsSample/ArkWeb/SetBasicAttrsEvts/SetBasicAttrsEvtsOne > .git/info/sparse-checkout 312git remote add origin https://gitee.com/openharmony/applications_app_samples.git 313git pull origin master 314``` 315
