1# web子系统ChangeLog
2
3OpenHarmony 3.2.9.1 sp8版本相较于OpenHarmony 3.2.8.1版本，web的API变更如下
4
5## cl.web.1 删除无用错误码
6
7web子系统webviewController接口存在变更：
8
9 - 去除forward，backward和backOrForward接口的@throws { BusinessError } 17100007 - Invalid back or forward operation.
10 - 去除zoom，zoomIn和zoomOut接口的@throws { BusinessError } 17100009 - Cannot zoom in or zoom out.
11
12开发者需要根据以下说明对应用进行适配。
13
14
15**变更影响**
16
17影响已发布的JS接口，应用无需进行适配即可在新版本SDK环境正常编译通过。
18
19**关键的接口/组件变更**
20
21涉及接口: forward, backward, backOrForward, zoom, zoomIn, zoomOut;
22涉及组件: web;
23
24**适配指导**
25
26无需适配
27
28## cl.web.2 setWebController入参修改
29
30已发布的部分web子系统controller迁移至webviewController，老的webController做废弃处理。从API9开始做出以下变更：
31setWebController入参由老controller替换为新的webviewController
32
33**变更影响**
34
35基于此前版本开发的应用，需适配变更js接口的入参，否则会影响原有功能。
36
37**关键的接口/组件变更**
38
39- 涉及接口
40
41  setWebController(controller: WebviewController): void;
42
43- 变更前：
44
45```js
46setWebController(controller: WebController): void;
47```
48
49- 变更后：
50
51```js
52setWebController(controller: WebviewController): void;
53```
54
55**适配指导**
56
57示例代码如下：
58变更前：
59```js
60// xxx.ets
61@Entry
62@Component
63struct WebComponent {
64  controller:WebController = new WebController()
65  build() {
66    Column() {
67      Web({ src:'www.example.com', controller: this.controller })
68      .multiWindowAccess(true)
69      .onWindowNew((event) => {
70        console.log("onWindowNew...")
71        var popController: WebController = new WebController()
72        event.handler.setWebController(popController)
73      })
74    }
75  }
76}
77```
78
79变更后：
80```js
81// xxx.ets
82@Entry
83@Component
84struct WebComponent {
85  controller: web_webview.WebviewController = new web_webview.WebviewController()
86  build() {
87    Column() {
88      Web({ src:'www.example.com', controller: this.controller })
89      .multiWindowAccess(true)
90      .onWindowNew((event) => {
91        console.log("onWindowNew...")
92        var popController: web_webview.WebviewController = new web_webview.WebviewController()
93        event.handler.setWebController(popController)
94      })
95    }
96  }
97}
98```
99
100## cl.web.3 getUnfilterendLinkUrl接口名修改
101
102getUnfilterendLinkUrl接口拼写错误，应改为getUnfilteredLinkUrl
103
104**变更影响**
105
106基于此前版本开发的应用，需适配变更js接口名，否则会影响原有功能。
107
108**关键的接口/组件变更**
109
110- 涉及接口
111
112  getUnfilteredLinkUrl(): string;
113
114- 变更前：
115
116```js
117getUnfilterendLinkUrl(): string;
118```
119
120- 变更后：
121
122```js
123getUnfilteredLinkUrl(): string;
124```
125
126**适配指导**
127
128基于此前版本开发的应用，需适配变更js接口名，使用新的接口名替换旧的接口名，否则会影响原有功能。