From 38cd07c2e5724766cd2dfdff2c885bd30e472da5 Mon Sep 17 00:00:00 2001
From: zhufenghao <zhufenghao2@huawei.com>
Date: Sat, 17 Dec 2022 14:43:32 +0800
Subject: [PATCH] =?UTF-8?q?=E5=A2=9E=E5=8A=A0web=20API=20changelog?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: zhufenghao <zhufenghao2@huawei.com>
---
 .../OpenHarmony_3.2.9.1/changelog-web.md      | 128 ++++++++++++++++++
 1 file changed, 128 insertions(+)
 create mode 100644 zh-cn/release-notes/changelogs/OpenHarmony_3.2.9.1/changelog-web.md

diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_3.2.9.1/changelog-web.md b/zh-cn/release-notes/changelogs/OpenHarmony_3.2.9.1/changelog-web.md
new file mode 100644
index 0000000000..92a0328779
--- /dev/null
+++ b/zh-cn/release-notes/changelogs/OpenHarmony_3.2.9.1/changelog-web.md
@@ -0,0 +1,128 @@
+# web子系统ChangeLog
+
+OpenHarmony 3.2.9.1 sp8版本相较于OpenHarmony 3.2.8.1版本，web的API变更如下
+
+## cl.web.1 删除无用错误码
+
+web子系统webviewController接口存在变更：
+
+ - 去除forward，backward和backOrForward接口的@throws { BusinessError } 17100007 - Invalid back or forward operation.
+ - 去除zoom，zoomIn和zoomOut接口的@throws { BusinessError } 17100009 - Cannot zoom in or zoom out.
+
+开发者需要根据以下说明对应用进行适配。
+
+
+**变更影响**
+
+影响已发布的JS接口，应用无需进行适配即可在新版本SDK环境正常编译通过。
+
+**关键的接口/组件变更**
+
+涉及接口: forward, backward, backOrForward, zoom, zoomIn, zoomOut;
+涉及组件: web;
+
+**适配指导**
+
+无需适配
+        
+## cl.web.2 setWebController入参修改
+
+已发布的部分web子系统controller迁移至webviewController，老的webController做废弃处理。从API9开始做出以下变更：
+setWebController入参由老controller替换为新的webviewController
+
+**变更影响**
+
+基于此前版本开发的应用，需适配变更js接口的入参，否则会影响原有功能。
+
+**关键的接口/组件变更**
+
+- 涉及接口
+
+  setWebController(controller: WebviewController): void;
+
+- 变更前：
+
+```js
+setWebController(controller: WebController): void;
+```
+
+- 变更后：
+
+```js
+setWebController(controller: WebviewController): void;
+```
+
+**适配指导**
+
+示例代码如下：
+变更前：
+```js
+// xxx.ets
+@Entry
+@Component
+struct WebComponent {
+  controller:WebController = new WebController()
+  build() {
+    Column() {
+      Web({ src:'www.example.com', controller: this.controller })
+      .multiWindowAccess(true)
+      .onWindowNew((event) => {
+        console.log("onWindowNew...")
+        var popController: WebController = new WebController()
+        event.handler.setWebController(popController)
+      })
+    }
+  }
+}
+```
+
+变更后：
+```js
+// xxx.ets
+@Entry
+@Component
+struct WebComponent {
+  controller: web_webview.WebviewController = new web_webview.WebviewController()
+  build() {
+    Column() {
+      Web({ src:'www.example.com', controller: this.controller })
+      .multiWindowAccess(true)
+      .onWindowNew((event) => {
+        console.log("onWindowNew...")
+        var popController: web_webview.WebviewController = new web_webview.WebviewController()
+        event.handler.setWebController(popController)
+      })
+    }
+  }
+}
+```
+
+## cl.web.3 getUnfilterendLinkUrl接口名修改
+
+getUnfilterendLinkUrl接口拼写错误，应改为getUnfilteredLinkUrl
+
+**变更影响**
+
+基于此前版本开发的应用，需适配变更js接口名，否则会影响原有功能。
+
+**关键的接口/组件变更**
+
+- 涉及接口
+
+  getUnfilteredLinkUrl(): string;
+
+- 变更前：
+
+```js
+getUnfilterendLinkUrl(): string;
+```
+
+- 变更后：
+
+```js
+getUnfilteredLinkUrl(): string;
+```
+
+**适配指导**
+
+基于此前版本开发的应用，需适配变更js接口名，使用新的接口名替换旧的接口名，否则会影响原有功能。
\ No newline at end of file
-- 
GitLab