web子系统ChangeLog

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;

• 变更前：

setWebController(controller: WebController): void;

• 变更后：

setWebController(controller: WebviewController): void;

适配指导

示例代码如下： 变更前：

// 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)
      })
    }
  }
}

变更后：

// 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;

• 变更前：

getUnfilterendLinkUrl(): string;

• 变更后：

getUnfilteredLinkUrl(): string;

适配指导

基于此前版本开发的应用，需适配变更js接口名，使用新的接口名替换旧的接口名，否则会影响原有功能。