# WebCrossDomain

**Repository Path**: harmonyos_samples/WebCrossDomain

## Basic Information

- **Project Name**: WebCrossDomain
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 2
- **Created**: 2025-09-03
- **Last Updated**: 2026-01-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Cross-Domain Web Page Access Based on ArkWeb Interceptors and Cookie Management Capabilities

## Overview

This sample demonstrates how to use ArkWeb interceptors and cookie management capabilities to implement typical cross-domain web page scenarios, including local resource access, remote requests, cookie configuration, and web page access via a custom protocol. Through this sample, you will understand cross-domain principles and efficiently resolve cross-domain issues in real-world projects.

## Preview

<table>
  <tr>
    <td align="center">Home Page</td>
    <td align="center">Local Resource Access Page</td>
    <td align="center">Remote Request Page</td>
  </tr>
  <tr>
    <td align="center"><img src="./screenshots/Screenshot_homePage_en.png" alt="Home Page" width=320></td>
    <td align="center"><img src="./screenshots/Screenshot_LocalResource_en.png" alt="Local Resource Cross-Domain" width=320></td>
    <td align="center"><img src="./screenshots/Screenshot_RemoteRequest_en.png" alt="Remote Request Cross-Domain" width=320></td>
  </tr>
  <tr>
    <td align="center">Cookies Settings Page</td>
    <td align="center">Custom Protocol Page</td>
    <td></td>
  </tr>
  <tr>
    <td align="center"><img src="./screenshots/Screenshot_CookiesSettings_en.png" alt="Cross-Domain Cookie Setting" width=320></td>
    <td align="center"><img src="./screenshots/Screenshot_CustomProtocol_en.png" alt="Custom Protocol Cross-Domain" width=320></td>
    <td></td>
  </tr>
</table>

## Procedure

1. Open the project in DevEco Studio, click Terminal in the root directory, and run the hvigorw startServer command to start the local server.

   ![Screenshot_terminal](./screenshots/Screenshot_terminal.png)

2. Wait for the compilation to finish.
3. To restart the local server, run the hvigorw restartServer command.
4. To stop the local server, run the hvigorw stopServer command.

## How to Use

1. On the local resource access page, tap the button to send a request. The request result will be displayed in the log area.
2. On the remote request page, tap the button to send a request. The request result will be displayed in the log area.
3. On the cookies settings page, when the page loads, the system automatically sends a request to domain A, sets cookies, and shows the result in the log area.
4. Then you can tap the button to obtain cookies of domain A, pass them to domain B, load domain B's page, and send a request to domain B. The request result will be displayed in the log area.
5. On the custom protocol page, tap the button to send a request. A dialog box will pop up with "Custom protocol has been intercepted".

## Project Directory

```
├── entry/src/main/ets                              
│  ├── common
│  │  ├── Constants.ets                  // Static constants
│  │  ├── HttpProxy.ets                  // Network request proxy
│  │  ├── Logger.ets                     // Log file
│  │  └── PageLoadError.ets              // Web loading error page
│  ├── component                  
│  │  ├── CardItem.ets                   // List item on the home page
│  │  └── Header.ets                     // Header of the details page 
│  ├── entryability  
│  │  └── EntryAbility.ets               // Entry ability
│  ├── pages                                     
│  │  └── Index.ets                      // Home page
│  └── view
│     ├── CookiesSettings.ets            // Cookies settings page
│     ├── CustomProtocol.ets             // Custom protocol page
│     ├── LocalResource.ets              // Local resource access page
│     └── RemoteRequest.ets              // Remote request page
├── entry/src/main/resources             // Static resources
├── LocalVue                             // HTML5 pages
├── LocalServer                          // Local server
└── scripts/commandTask.ts               // Command file
```

## How to Implement

1. For local resource access across domains, call setPathAllowingUniversalAccess() to configure a path list, enabling access to local files via the file protocol.
2. For remote requests across domains, set up a WebSchemeHandler interceptor in the WebView to intercept web page requests. Use an RCP request as a cross-domain proxy, and forward it to the target remote server. Since communication between the proxy request and remote server is not restricted by the browser, server responses can be received. However, cross-domain response headers still need to be configured to resolve cross-domain issues when results are sent back to the WebView.
3. For cookie configuration, use putAcceptCookieEnabled() to allow the WebCookieManager instance to send and receive cookies. Retrieve cookies for domain A with fetchCookiesync(), and set cookies for domain B using configCookiesync(). These cookies will be automatically included in requests sent to domain B.
4. For web page access via a custom protocol, configure a WebSchemeHandler interceptor in the WebView to intercept requests, call system capabilities, and display a system dialog.

## Required Permissions

ohos.permission.INTERNET: allows an application to access the Internet.

## Constraints

1. This sample is only supported on Huawei phones running standard systems.
2. The HarmonyOS version must be HarmonyOS 5.0.5 Release or later.
3. The DevEco Studio version must be DevEco Studio 5.0.5 Release or later.
4. The HarmonyOS SDK version must be HarmonyOS 5.0.5 Release SDK or later.