# WebUseObj

**Repository Path**: marychang/web-use-obj

## Basic Information

- **Project Name**: WebUseObj
- **Description**: 【鸿蒙 Harmony Next 示例 代码】本示例展示了通过registerJavaScriptProxy()实现Web侧调用应用传递的Object的功能。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-05-28
- **Last Updated**: 2025-05-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Web侧调用应用传递的Object

## 介绍

本示例展示了通过registerJavaScriptProxy()实现Web侧调用应用传递的Object的功能。

## 效果预览

![image](screenshots/ScreenShot.gif)

## 约束与限制

1.仅支持标准系统上运行，支持设备：华为手机或运行在DevEco Studio上的华为手机设备模拟器。  
2.支持 API Version 12 Release及以上版本。  
3.支持 HarmonyOS 5.0.0 Release SDK及以上版本。  
4.需要使用DevEco Studio 5.0.0 Release及以上版本进行编译运行。

## 使用说明

首先点击将对象注入到web端按钮，然后点击refresh按钮，最后点击调用按钮。

## 实现思路

1. 通过[registerJavaScriptProxy](https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V13/js-apis-webview-V13#registerjavascriptproxy)
   将对象注入到web端。
```typescript
Button('将对象注入到web端')
   .onClick(() => {
      try {
         this.webviewController.registerJavaScriptProxy(
            this.testObj,
            'testObjName',
            ['test']
         )
      } catch (error) {
         let e: business_error.BusinessError = error as business_error.BusinessError;
         hilog.error(0x0000, 'ErrorCode:', `${e.code}`, 'Message:', `${e.message}`)
      }
   })
   .margin({ bottom: '20vp' })
```
2. 执行refresh
```typescript
Button('refresh')
   .onClick(() => {
      try {
         this.webviewController.refresh();
      } catch (error) {
         let e: business_error.BusinessError = error as business_error.BusinessError;
         hilog.error(0x0000, 'ErrorCode:', `${e.code}`, 'Message:', `${e.message}`)
      }
   })
```
3. web组件加载本地CallArkTs04.html页面
```typescript
Web({ src: $rawfile('CallArkTs04.html'), controller: this.webviewController }).geolocationAccess(false)
   .fileAccess(false)
```

## 工程目录

```
entry/src/main/ets/
|---pages
|   |---Index.ets                            // 主页
```


## 参考文档

[registerJavaScriptProxy](https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V13/js-apis-webview-V13#registerjavascriptproxy)
## ChangeLog

| 修改内容   | 时间         |
|--------|------------|
| 第一次提交  | 2025.03.05 |


## 一份简单的问卷反馈

亲爱的Harmony Next开发者，您好！<br>
为了协助您高效开发，提高鸿蒙场景化示例的质量，希望您在浏览或使用后抽空填写一份简单的问卷，我们将会收集您的宝贵意见进行优化:heart:

[:arrow_right: **点击此处填写问卷** ](https://wj.qq.com/s2/19042938/95ab/)

<div style="text-align: left;">