harmony 鸿蒙# @ohos.net.ethernet (Ethernet Connection Management)

2025-06-12
浏览 (7)

# @ohos.net.ethernet (Ethernet Connection Management)

The ethernet module provides Ethernet management functions such as obtaining the network IP address.

NOTE The initial APIs of this module are supported since API version 10. Newly added APIs will be marked with a superscript to indicate their earliest API version.

Modules to Import

import { ethernet } from '@kit.NetworkKit';

HttpProxy

type HttpProxy = connection.HttpProxy;

Defines the network proxy configuration.

System capability: SystemCapability.Communication.NetManager.Ethernet

Type	Description
connection.HttpProxy	Network proxy configuration.

ethernet.getMacAddress¹⁴⁺

getMacAddress(): Promise<Array<MacAddressInfo>>

Obtains the names and MAC addresses of all Ethernet NICs. This API uses a promise to return the result.

Required permission: ohos.permission.GET_ETHERNET_LOCAL_MAC

System capability: SystemCapability.Communication.NetManager.Ethernet

Return value

Type	Description
Promise<Array<MacAddressInfo>>	Promise used to return the result.

Error codes

ID	Error Message
201	Permission denied.
2200002	Operation failed. Cannot connect to service.
2201005	Device information does not exist.

Example

import { ethernet } from '@kit.NetworkKit';
import { BusinessError } from '@kit.BasicServicesKit';

ethernet.getMacAddress().then((data: Array<ethernet.MacAddressInfo>) => {
  console.info("getMacAddress promise data = " + JSON.stringify(data));
}).catch((error: BusinessError) => {
  console.error("getMacAddress promise error = " + JSON.stringify(error));
});