Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
cf890b7e
D
Docs
项目概览
OpenHarmony
/
Docs
1 年多 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
未验证
提交
cf890b7e
编写于
2月 14, 2023
作者:
O
openharmony_ci
提交者:
Gitee
2月 14, 2023
浏览文件
操作
浏览文件
下载
差异文件
!14272 【web】删除已迁移的api9接口doc文档
Merge pull request !14272 from zhufenghao/master
上级
983ad64b
d4159176
变更
4
展开全部
隐藏空白更改
内联
并排
Showing
4 changed file
with
629 addition
and
1397 deletion
+629
-1397
zh-cn/application-dev/reference/apis/js-apis-webview.md
zh-cn/application-dev/reference/apis/js-apis-webview.md
+20
-147
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-web.md
...ication-dev/reference/arkui-ts/ts-basic-components-web.md
+39
-1248
zh-cn/release-notes/changelogs/OpenHarmony_3.2.10.7/changelog-web.md
...se-notes/changelogs/OpenHarmony_3.2.10.7/changelog-web.md
+285
-1
zh-cn/release-notes/changelogs/OpenHarmony_4.0.3.2/changelog-web.md
...ase-notes/changelogs/OpenHarmony_4.0.3.2/changelog-web.md
+285
-1
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-webview.md
浏览文件 @
cf890b7e
...
...
@@ -429,7 +429,7 @@ loadData(data: string, mimeType: string, encoding: string, baseUrl?: string, his
**系统能力:**
SystemCapability.Web.Webview.Core
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------ | ---- | ------------------------------------------------------------ |
...
...
@@ -448,7 +448,7 @@ loadData(data: string, mimeType: string, encoding: string, baseUrl?: string, his
| 17100001 | Init error. The WebviewController must be associated with a Web component. |
| 17100002 | Invalid url. |
**示例:**
**示例:**
```
ts
// xxx.ets
...
...
@@ -487,7 +487,7 @@ accessForward(): boolean
**系统能力:**
SystemCapability.Web.Webview.Core
**返回值:**
**返回值:**
| 类型 | 说明 |
| ------- | --------------------------------- |
...
...
@@ -501,7 +501,7 @@ accessForward(): boolean
| -------- | ------------------------------------------------------------ |
| 17100001 | Init error. The WebviewController must be associated with a Web component. |
**示例:**
**示例:**
```
ts
// xxx.ets
...
...
@@ -545,7 +545,7 @@ forward(): void
| -------- | ------------------------------------------------------------ |
| 17100001 | Init error. The WebviewController must be associated with a Web component. |
**示例:**
**示例:**
```
ts
// xxx.ets
...
...
@@ -638,7 +638,7 @@ backward(): void
| -------- | ------------------------------------------------------------ |
| 17100001 | Init error. The WebviewController must be associated with a Web component. |
**示例:**
**示例:**
```
ts
// xxx.ets
...
...
@@ -1088,7 +1088,7 @@ runJavaScript(script: string): Promise\<string>
| ------ | -------- | ---- | ---------------- |
| script | string | 是 | JavaScript脚本。 |
**返回值:**
**返回值:**
| 类型 | 说明 |
| --------------- | --------------------------------------------------- |
...
...
@@ -1480,7 +1480,7 @@ struct WebComponent {
**系统能力:**
SystemCapability.Web.Webview.Core
**返回值:**
**返回值:**
| 类型 | 说明 |
| ---------------------- | ----------------- |
...
...
@@ -1494,7 +1494,7 @@ struct WebComponent {
| -------- | ------------------------------------------------------------ |
| 17100001 | Init error. The WebviewController must be associated with a Web component. |
**示例:**
**示例:**
```
ts
// xxx.ets
...
...
@@ -1578,7 +1578,7 @@ struct WebComponent {
this
.
ports
=
this
.
controller
.
createWebMessagePorts
();
// 2、在应用侧的消息端口(如端口1)上注册回调事件。
this
.
ports
[
1
].
onMessageEvent
((
result
:
web_webview
.
WebMessage
)
=>
{
var
msg
=
'
Got msg from HTML:
'
;
let
msg
=
'
Got msg from HTML:
'
;
if
(
typeof
(
result
)
==
"
string
"
)
{
console
.
log
(
"
received string message from html5, string is:
"
+
result
);
msg
=
msg
+
result
;
...
...
@@ -2760,7 +2760,7 @@ hasImage(): Promise\<boolean>
**系统能力:**
SystemCapability.Web.Webview.Core
**返回值:**
**返回值:**
| 类型 | 说明 |
| ----------------- | --------------------------------------- |
...
...
@@ -3185,7 +3185,7 @@ static getCookie(url: string): string
| ------ | ------ | ---- | :------------------------ |
| url | string | 是 | 要获取的cookie所属的url。 |
**返回值:**
**返回值:**
| 类型 | 说明 |
| ------ | ------------------------- |
...
...
@@ -3332,7 +3332,7 @@ static saveCookieAsync(): Promise\<void>
**系统能力:**
SystemCapability.Web.Webview.Core
**返回值:**
**返回值:**
| 类型 | 说明 |
| ---------------- | ----------------------------------------- |
...
...
@@ -3420,7 +3420,7 @@ static isCookieAllowed(): boolean
**系统能力:**
SystemCapability.Web.Webview.Core
**返回值:**
**返回值:**
| 类型 | 说明 |
| ------- | -------------------------------- |
...
...
@@ -3499,7 +3499,7 @@ static isThirdPartyCookieAllowed(): boolean
**系统能力:**
SystemCapability.Web.Webview.Core
**返回值:**
**返回值:**
| 类型 | 说明 |
| ------- | -------------------------------------- |
...
...
@@ -3537,7 +3537,7 @@ static existCookie(): boolean
**系统能力:**
SystemCapability.Web.Webview.Core
**返回值:**
**返回值:**
| 类型 | 说明 |
| ------- | -------------------------------------- |
...
...
@@ -4270,133 +4270,6 @@ struct WebComponent {
}
```
## WebAsyncController
通过WebAsyncController可以控制Web组件具有异步回调通知的行为,一个WebAsyncController对象控制一个Web组件。
### 创建对象
```
ts
// xxx.ets
import
web_webview
from
'
@ohos.web.webview
'
@
Entry
@
Component
struct
WebComponent
{
controller
:
WebController
=
new
WebController
();
webAsyncController
:
web_webview
.
WebAsyncController
=
new
web_webview
.
WebAsyncController
(
this
.
controller
)
build
()
{
Column
()
{
Web
({
src
:
'
www.example.com
'
,
controller
:
this
.
controller
})
}
}
}
```
### constructor<sup>9+</sup>
constructor(controller: WebController)
WebAsyncController的创建需要与一个
[
WebController
](
../arkui-ts/ts-basic-components-web.md#webcontroller
)
进行绑定。
**系统能力:**
SystemCapability.Web.Webview.Core
**参数:**
| 参数名| 类型 | 必填 | 说明 |
| ----- | ---- | ---- | --- |
| controller |
[
WebController
](
../arkui-ts/ts-basic-components-web.md#webcontroller
)
| 是 | 所绑定的WebviewController。|
### storeWebArchive<sup>9+</sup>
storeWebArchive(baseName: string, autoName: boolean, callback: AsyncCallback
\<
string>): void
以回调方式异步保存当前页面。
**系统能力:**
SystemCapability.Web.Webview.Core
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | ----------------------------------- |
| baseName | string | 是 | 文件存储路径,该值不能为空。
| autoName | boolean | 是 | 决定是否自动生成文件名。
<br/>
如果为false,则将baseName作为文件存储路径。
<br/>
如果为true,则假定baseName是一个目录,将根据当前页的Url自动生成文件名。
| callback | AsyncCallback
\<
string> | 是 | 返回文件存储路径,保持网页失败会返回null。 |
**示例:**
```
ts
// xxx.ets
import
web_webview
from
'
@ohos.web.webview
'
@
Entry
@
Component
struct
WebComponent
{
controller
:
WebController
=
new
WebController
()
build
()
{
Column
()
{
Button
(
'
saveWebArchive
'
)
.
onClick
(()
=>
{
let
webAsyncController
=
new
web_webview
.
WebAsyncController
(
this
.
controller
)
webAsyncController
.
storeWebArchive
(
"
/data/storage/el2/base/
"
,
true
,
(
filename
)
=>
{
if
(
filename
!=
null
)
{
console
.
info
(
`save web archive success:
${
filename
}
`
)
}
})
})
Web
({
src
:
'
www.example.com
'
,
controller
:
this
.
controller
})
}
}
}
```
### storeWebArchive<sup>9+</sup>
storeWebArchive(baseName: string, autoName: boolean): Promise
\<
string>
以Promise方式异步保存当前页面。
**系统能力:**
SystemCapability.Web.Webview.Core
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | ----------------------------------- |
| baseName | string | 是 | 文件存储路径,该值不能为空。
| autoName | boolean | 是 | 决定是否自动生成文件名。
<br/>
如果为false,则将baseName作为文件存储路径。
<br/>
如果为true,则假定baseName是一个目录,将根据当前页的Url自动生成文件名。
**返回值:**
| 类型 | 说明 |
| ---------------------------------------- | ---------------------------------------- |
| Promise
<string>
| Promise实例,保存成功返回文件路径,保存失败返回null。 |
**示例:**
```
ts
// xxx.ets
import
web_webview
from
'
@ohos.web.webview
'
@
Entry
@
Component
struct
WebComponent
{
controller
:
WebController
=
new
WebController
();
build
()
{
Column
()
{
Button
(
'
saveWebArchive
'
)
.
onClick
(()
=>
{
let
webAsyncController
=
new
web_webview
.
WebAsyncController
(
this
.
controller
);
webAsyncController
.
storeWebArchive
(
"
/data/storage/el2/base/
"
,
true
)
.
then
(
filename
=>
{
if
(
filename
!=
null
)
{
console
.
info
(
`save web archive success:
${
filename
}
`
)
}
})
})
Web
({
src
:
'
www.example.com
'
,
controller
:
this
.
controller
})
}
}
}
```
## GeolocationPermissions
web组件地理位置权限管理对象。
...
...
@@ -4836,7 +4709,7 @@ getItemAtIndex(index: number): HistoryItem
| ------ | ------ | ---- | ---------------------- |
| index | number | 是 | 指定历史列表中的索引。 |
**返回值:**
**返回值:**
| 类型 | 说明 |
| --------------------------- | ------------ |
...
...
@@ -4854,7 +4727,7 @@ import image from "@ohos.multimedia.image"
struct
WebComponent
{
controller
:
web_webview
.
WebviewController
=
new
web_webview
.
WebviewController
();
@
State
icon
:
image
.
PixelMap
=
undefined
;
build
()
{
Column
()
{
Button
(
'
getBackForwardEntries
'
)
...
...
@@ -4862,8 +4735,8 @@ struct WebComponent {
try
{
let
list
=
this
.
controller
.
getBackForwardEntries
();
let
historyItem
=
list
.
getItemAtIndex
(
list
.
currentIndex
);
console
.
log
(
"
HistoryItem:
"
+
JSON
.
stringify
(
historyItem
));
this
.
icon
=
historyItem
.
icon
;
console
.
log
(
"
HistoryItem:
"
+
JSON
.
stringify
(
historyItem
));
this
.
icon
=
historyItem
.
icon
;
}
catch
(
error
)
{
console
.
error
(
`ErrorCode:
${
error
.
code
}
, Message:
${
error
.
message
}
`
);
}
...
...
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-web.md
浏览文件 @
cf890b7e
此差异已折叠。
点击以展开。
zh-cn/release-notes/changelogs/OpenHarmony_3.2.10.7/changelog-web.md
浏览文件 @
cf890b7e
...
...
@@ -180,4 +180,288 @@ getHitTest接口,在3.2.10.7版本及后续版本中无法继续正常使用
**适配指导**
在使用getHitTest接口的返回值时,请使用WebHitTestType类型替换HitTestTypeV9类型。
\ No newline at end of file
在使用getHitTest接口的返回值时,请使用WebHitTestType类型替换HitTestTypeV9类型。
## cl.web.6 WebMessagePort类迁移
WebMessagePort类迁移至@ohos.web.webview.d.ts,并新增错误码抛出。
**变更影响**
基于此前版本开发的应用,需注意d.ts位置的变更及import模块名的变更。现该类下接口支持错误码处理,需注意错误码处理的使用。
**关键的接口/组件变更**
-
涉及接口
postMessageEvent(message: WebMessageEvent): void;
onMessageEvent(callback: (result: string) => void): void;
-
变更前:
```
ts
postMessageEvent
(
message
:
WebMessageEvent
):
void
;
onMessageEvent
(
callback
:
(
result
:
string
)
=>
void
):
void
;
```
-
变更后:
```
ts
postMessageEvent
(
message
:
WebMessage
):
void
;
onMessageEvent
(
callback
:
(
result
:
WebMessage
)
=>
void
):
void
;
```
**适配指导**
原WebMessagePort类不需要import,现WebMessagePort类使用的是@ohos.web.webview,以下方式import:
```
ts
import
web_webview
from
'
@ohos.web.webview
'
;
```
## cl.web.7 HitTestValue类迁移
HitTestValue类迁移至@ohos.web.webview.d.ts,HitTestValue类变更为接口,getType,getExtra变更为属性。
**变更影响**
基于此前版本开发的应用,需注意d.ts位置的变更及import模块名的变更。
**关键的接口/组件变更**
-
涉及接口
getType(): HitTestType;
getExtra(): string;
-
变更前:
```
ts
getType
():
HitTestType
;
getExtra
():
string
;
```
-
变更后:
```
ts
type
:
WebHitTestType
;
extra
:
string
;
```
**适配指导**
原HitTestValue类不需要import,现HitTestValue类使用的是@ohos.web.webview,以下方式import:
```
ts
import
web_webview
from
'
@ohos.web.webview
'
;
```
## cl.web.8 WebCookie类下api9接口迁移
WebCookie类下api9接口迁移,WebCookie类下api9接口迁移到web.webview.webview.WebCookieManager。
并新增接口错误码抛出。
**变更影响**
基于此前版本开发的应用,需注意d.ts位置的变更及import模块名的变更。现该类下接口支持错误码处理,需注意错误码处理的使用。
该类方法变为静态方法。
**关键的接口/组件变更**
-
涉及接口
isCookieAllowed(): boolean;
isThirdPartyCookieAllowed(): boolean;
putAcceptCookieEnabled(accept: boolean): void;
putAcceptThirdPartyCookieEnabled(accept: boolean): void;
setCookie(url: string, value: string): boolean;
saveCookieSync(): boolean;
getCookie(url: string): string;
existCookie(): boolean;
deleteEntireCookie(): void;
deleteSessionCookie(): void;
-
变更前:
```
ts
isCookieAllowed
():
boolean
;
isThirdPartyCookieAllowed
():
boolean
;
putAcceptCookieEnabled
(
accept
:
boolean
):
void
;
putAcceptThirdPartyCookieEnabled
(
accept
:
boolean
):
void
;
setCookie
(
url
:
string
,
value
:
string
):
boolean
;
saveCookieSync
():
boolean
;
getCookie
(
url
:
string
):
string
;
existCookie
():
boolean
;
deleteEntireCookie
():
void
;
deleteSessionCookie
():
void
;
```
-
变更后:
```
ts
static
isCookieAllowed
():
boolean
;
static
isThirdPartyCookieAllowed
():
boolean
;
static
putAcceptCookieEnabled
(
accept
:
boolean
):
void
;
static
putAcceptThirdPartyCookieEnabled
(
accept
:
boolean
):
void
;
static
setCookie
(
url
:
string
,
value
:
string
):
void
;
static
saveCookieAsync
():
Promise
<
void
>
;
static
saveCookieAsync
(
callback
:
AsyncCallback
<
void
>
):
void
;
static
getCookie
(
url
:
string
):
string
;
static
existCookie
():
boolean
;
static
deleteEntireCookie
():
void
;
static
deleteSessionCookie
():
void
;
```
**适配指导**
原WebCookie类不需要import,现WebCookieManager使用的是@ohos.web.webview,以下方式import:
```
ts
import
web_webview
from
'
@ohos.web.webview
'
;
```
## cl.web.9 WebController类下api9接口迁移
WebController类下api9接口迁移至web.webview.webview.WebviewController,并新增接口错误码抛出。
**变更影响**
基于此前版本开发的应用,需注意d.ts位置的变更及import模块名的变更。现该类下接口支持错误码处理,需注意错误码处理的使用。
getDefaultUserAgent接口更名为getUserAgent。
**关键的接口/组件变更**
-
涉及接口
zoomIn(): boolean;
zoomOut(): boolean;
createWebMessagePorts(): Array
<WebMessagePort>
;
postMessage(options: { message: WebMessageEvent, uri: string}): void;
getHitTestValue(): HitTestValue;
getWebId(): number;
getDefaultUserAgent(): string;
getTitle(): string;
getPageHeight(): number;
backOrForward(step: number): void;
searchAllAsync(searchString: string): void;
clearMatches(): void;
searchNext(forward: boolean): void;
clearSslCache(): void;
clearClientAuthenticationCache(): void;
getUrl(): string;
-
变更前:
```
ts
zoomIn
():
boolean
;
zoomOut
():
boolean
;
createWebMessagePorts
():
Array
<
WebMessagePort
>
;
postMessage
(
options
:
{
message
:
WebMessageEvent
,
uri
:
string
}):
void
;
getHitTestValue
():
HitTestValue
;
getWebId
():
number
;
getDefaultUserAgent
():
string
;
getTitle
():
string
;
getPageHeight
():
number
;
backOrForward
(
step
:
number
):
void
;
searchAllAsync
(
searchString
:
string
):
void
;
clearMatches
():
void
;
searchNext
(
forward
:
boolean
):
void
;
clearSslCache
():
void
;
clearClientAuthenticationCache
():
void
;
getUrl
():
string
;
```
-
变更后:
```
ts
zoomIn
():
void
;
zoomOut
():
void
;
createWebMessagePorts
():
Array
<
WebMessagePort
>
;
postMessage
(
name
:
string
,
ports
:
Array
<
WebMessagePort
>
,
uri
:
string
):
void
;
getHitTestValue
():
HitTestValue
;
getWebId
():
number
;
getUserAgent
():
string
;
getTitle
():
string
;
getPageHeight
():
number
;
backOrForward
(
step
:
number
):
void
;
searchAllAsync
(
searchString
:
string
):
void
;
clearMatches
():
void
;
searchNext
(
forward
:
boolean
):
void
;
clearSslCache
():
void
;
clearClientAuthenticationCache
():
void
;
getUrl
():
string
;
```
**适配指导**
原WebController类不需要import,现WebviewController类使用的是@ohos.web.webview,以下方式import:
```
ts
import
web_webview
from
'
@ohos.web.webview
'
;
```
## cl.web.10 WebAsyncController类迁移
WebAsyncController类下接口迁移至web.webview.webview.WebviewController,并新增接口错误码抛出。
**变更影响**
基于此前版本开发的应用,需注意错误码处理的使用。
**关键的接口/组件变更**
-
涉及接口
storeWebArchive(baseName: string, autoName: boolean): Promise
<string>
;
storeWebArchive(baseName: string, autoName: boolean, callback : AsyncCallback
<string>
): void;
-
变更前:
```
ts
storeWebArchive
(
baseName
:
string
,
autoName
:
boolean
):
Promise
<
string
>
;
storeWebArchive
(
baseName
:
string
,
autoName
:
boolean
,
callback
:
AsyncCallback
<
string
>
):
void
;
```
-
变更后:
```
ts
storeWebArchive
(
baseName
:
string
,
autoName
:
boolean
):
Promise
<
string
>
;
storeWebArchive
(
baseName
:
string
,
autoName
:
boolean
,
callback
:
AsyncCallback
<
string
>
):
void
;
```
**适配指导**
使用示例:
```
ts
// xxx.ets
import
web_webview
from
'
@ohos.web.webview
'
@
Entry
@
Component
struct
WebComponent
{
controller
:
web_webview
.
WebviewController
=
new
web_webview
.
WebviewController
();
build
()
{
Column
()
{
Button
(
'
saveWebArchive
'
)
.
onClick
(()
=>
{
try
{
this
.
controller
.
storeWebArchive
(
"
/data/storage/el2/base/
"
,
true
,
(
error
,
filename
)
=>
{
if
(
error
)
{
console
.
info
(
`save web archive error: `
+
JSON
.
stringify
(
error
))
return
;
}
if
(
filename
!=
null
)
{
console
.
info
(
`save web archive success:
${
filename
}
`
)
}
});
}
catch
(
error
)
{
console
.
error
(
`ErrorCode:
${
error
.
code
}
, Message:
${
error
.
message
}
`
);
}
})
Web
({
src
:
'
www.example.com
'
,
controller
:
this
.
controller
})
}
}
}
```
\ No newline at end of file
zh-cn/release-notes/changelogs/OpenHarmony_4.0.3.2/changelog-web.md
浏览文件 @
cf890b7e
...
...
@@ -180,4 +180,288 @@ getHitTest接口,在4.0.3.2版本及后续版本中无法继续正常使用。
**适配指导**
在使用getHitTest接口的返回值时,请使用WebHitTestType类型替换HitTestTypeV9类型。
\ No newline at end of file
在使用getHitTest接口的返回值时,请使用WebHitTestType类型替换HitTestTypeV9类型。
## cl.web.6 WebMessagePort类迁移
WebMessagePort类迁移至@ohos.web.webview.d.ts,并新增错误码抛出。
**变更影响**
基于此前版本开发的应用,需注意d.ts位置的变更及import模块名的变更。现该类下接口支持错误码处理,需注意错误码处理的使用。
**关键的接口/组件变更**
-
涉及接口
postMessageEvent(message: WebMessageEvent): void;
onMessageEvent(callback: (result: string) => void): void;
-
变更前:
```
ts
postMessageEvent
(
message
:
WebMessageEvent
):
void
;
onMessageEvent
(
callback
:
(
result
:
string
)
=>
void
):
void
;
```
-
变更后:
```
ts
postMessageEvent
(
message
:
WebMessage
):
void
;
onMessageEvent
(
callback
:
(
result
:
WebMessage
)
=>
void
):
void
;
```
**适配指导**
原WebMessagePort类不需要import,现WebMessagePort类使用的是@ohos.web.webview,以下方式import:
```
ts
import
web_webview
from
'
@ohos.web.webview
'
;
```
## cl.web.7 HitTestValue类迁移
HitTestValue类迁移至@ohos.web.webview.d.ts,HitTestValue类变更为接口,getType,getExtra变更为属性。
**变更影响**
基于此前版本开发的应用,需注意d.ts位置的变更及import模块名的变更。
**关键的接口/组件变更**
-
涉及接口
getType(): HitTestType;
getExtra(): string;
-
变更前:
```
ts
getType
():
HitTestType
;
getExtra
():
string
;
```
-
变更后:
```
ts
type
:
WebHitTestType
;
extra
:
string
;
```
**适配指导**
原HitTestValue类不需要import,现HitTestValue类使用的是@ohos.web.webview,以下方式import:
```
ts
import
web_webview
from
'
@ohos.web.webview
'
;
```
## cl.web.8 WebCookie类下api9接口迁移
WebCookie类下api9接口迁移,WebCookie类下api9接口迁移到web.webview.webview.WebCookieManager。
并新增接口错误码抛出。
**变更影响**
基于此前版本开发的应用,需注意d.ts位置的变更及import模块名的变更。现该类下接口支持错误码处理,需注意错误码处理的使用。
该类方法变为静态方法。
**关键的接口/组件变更**
-
涉及接口
isCookieAllowed(): boolean;
isThirdPartyCookieAllowed(): boolean;
putAcceptCookieEnabled(accept: boolean): void;
putAcceptThirdPartyCookieEnabled(accept: boolean): void;
setCookie(url: string, value: string): boolean;
saveCookieSync(): boolean;
getCookie(url: string): string;
existCookie(): boolean;
deleteEntireCookie(): void;
deleteSessionCookie(): void;
-
变更前:
```
ts
isCookieAllowed
():
boolean
;
isThirdPartyCookieAllowed
():
boolean
;
putAcceptCookieEnabled
(
accept
:
boolean
):
void
;
putAcceptThirdPartyCookieEnabled
(
accept
:
boolean
):
void
;
setCookie
(
url
:
string
,
value
:
string
):
boolean
;
saveCookieSync
():
boolean
;
getCookie
(
url
:
string
):
string
;
existCookie
():
boolean
;
deleteEntireCookie
():
void
;
deleteSessionCookie
():
void
;
```
-
变更后:
```
ts
static
isCookieAllowed
():
boolean
;
static
isThirdPartyCookieAllowed
():
boolean
;
static
putAcceptCookieEnabled
(
accept
:
boolean
):
void
;
static
putAcceptThirdPartyCookieEnabled
(
accept
:
boolean
):
void
;
static
setCookie
(
url
:
string
,
value
:
string
):
void
;
static
saveCookieAsync
():
Promise
<
void
>
;
static
saveCookieAsync
(
callback
:
AsyncCallback
<
void
>
):
void
;
static
getCookie
(
url
:
string
):
string
;
static
existCookie
():
boolean
;
static
deleteEntireCookie
():
void
;
static
deleteSessionCookie
():
void
;
```
**适配指导**
原WebCookie类不需要import,现WebCookieManager使用的是@ohos.web.webview,以下方式import:
```
ts
import
web_webview
from
'
@ohos.web.webview
'
;
```
## cl.web.9 WebController类下api9接口迁移
WebController类下api9接口迁移至web.webview.webview.WebviewController,并新增接口错误码抛出。
**变更影响**
基于此前版本开发的应用,需注意d.ts位置的变更及import模块名的变更。现该类下接口支持错误码处理,需注意错误码处理的使用。
getDefaultUserAgent接口更名为getUserAgent。
**关键的接口/组件变更**
-
涉及接口
zoomIn(): boolean;
zoomOut(): boolean;
createWebMessagePorts(): Array
<WebMessagePort>
;
postMessage(options: { message: WebMessageEvent, uri: string}): void;
getHitTestValue(): HitTestValue;
getWebId(): number;
getDefaultUserAgent(): string;
getTitle(): string;
getPageHeight(): number;
backOrForward(step: number): void;
searchAllAsync(searchString: string): void;
clearMatches(): void;
searchNext(forward: boolean): void;
clearSslCache(): void;
clearClientAuthenticationCache(): void;
getUrl(): string;
-
变更前:
```
ts
zoomIn
():
boolean
;
zoomOut
():
boolean
;
createWebMessagePorts
():
Array
<
WebMessagePort
>
;
postMessage
(
options
:
{
message
:
WebMessageEvent
,
uri
:
string
}):
void
;
getHitTestValue
():
HitTestValue
;
getWebId
():
number
;
getDefaultUserAgent
():
string
;
getTitle
():
string
;
getPageHeight
():
number
;
backOrForward
(
step
:
number
):
void
;
searchAllAsync
(
searchString
:
string
):
void
;
clearMatches
():
void
;
searchNext
(
forward
:
boolean
):
void
;
clearSslCache
():
void
;
clearClientAuthenticationCache
():
void
;
getUrl
():
string
;
```
-
变更后:
```
ts
zoomIn
():
void
;
zoomOut
():
void
;
createWebMessagePorts
():
Array
<
WebMessagePort
>
;
postMessage
(
name
:
string
,
ports
:
Array
<
WebMessagePort
>
,
uri
:
string
):
void
;
getHitTestValue
():
HitTestValue
;
getWebId
():
number
;
getUserAgent
():
string
;
getTitle
():
string
;
getPageHeight
():
number
;
backOrForward
(
step
:
number
):
void
;
searchAllAsync
(
searchString
:
string
):
void
;
clearMatches
():
void
;
searchNext
(
forward
:
boolean
):
void
;
clearSslCache
():
void
;
clearClientAuthenticationCache
():
void
;
getUrl
():
string
;
```
**适配指导**
原WebController类不需要import,现WebviewController类使用的是@ohos.web.webview,以下方式import:
```
ts
import
web_webview
from
'
@ohos.web.webview
'
;
```
## cl.web.10 WebAsyncController类迁移
WebAsyncController类下接口迁移至web.webview.webview.WebviewController,并新增接口错误码抛出。
**变更影响**
基于此前版本开发的应用,需注意错误码处理的使用。
**关键的接口/组件变更**
-
涉及接口
storeWebArchive(baseName: string, autoName: boolean): Promise
<string>
;
storeWebArchive(baseName: string, autoName: boolean, callback : AsyncCallback
<string>
): void;
-
变更前:
```
ts
storeWebArchive
(
baseName
:
string
,
autoName
:
boolean
):
Promise
<
string
>
;
storeWebArchive
(
baseName
:
string
,
autoName
:
boolean
,
callback
:
AsyncCallback
<
string
>
):
void
;
```
-
变更后:
```
ts
storeWebArchive
(
baseName
:
string
,
autoName
:
boolean
):
Promise
<
string
>
;
storeWebArchive
(
baseName
:
string
,
autoName
:
boolean
,
callback
:
AsyncCallback
<
string
>
):
void
;
```
**适配指导**
使用示例:
```
ts
// xxx.ets
import
web_webview
from
'
@ohos.web.webview
'
@
Entry
@
Component
struct
WebComponent
{
controller
:
web_webview
.
WebviewController
=
new
web_webview
.
WebviewController
();
build
()
{
Column
()
{
Button
(
'
saveWebArchive
'
)
.
onClick
(()
=>
{
try
{
this
.
controller
.
storeWebArchive
(
"
/data/storage/el2/base/
"
,
true
,
(
error
,
filename
)
=>
{
if
(
error
)
{
console
.
info
(
`save web archive error: `
+
JSON
.
stringify
(
error
))
return
;
}
if
(
filename
!=
null
)
{
console
.
info
(
`save web archive success:
${
filename
}
`
)
}
});
}
catch
(
error
)
{
console
.
error
(
`ErrorCode:
${
error
.
code
}
, Message:
${
error
.
message
}
`
);
}
})
Web
({
src
:
'
www.example.com
'
,
controller
:
this
.
controller
})
}
}
}
```
\ No newline at end of file
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录