鸿蒙5.0开发进阶：NDK开发-使用Node-API接口进行object相关开发

本文链接：https://blog.csdn.net/Androidbye/article/details/143208850

往期鸿蒙全套实战文章必看：

使用Node-API接口进行object相关开发，处理ArkTS对象的基本操作的功能，例如创建对象、获取原型、冻结和密封对象，检查对象的类型等。这些操作是在处理ArkTS对象时非常常见的，提供了一种与ArkTS对象交互的方式。

在Node-API接口开发中，经常需要定义和操作对象。例如，创建一个API接口，该接口接受一个对象作为输入参数，对该对象执行某些操作，并返回一个结果对象。在这个过程中，需要确保接口的定义清晰、规范，并且与对象的属性和方法相兼容。

接口（API）：接口定义了组件之间的交互协议，包括输入参数、输出结果以及可能的错误处理。通过接口，组件可以相互调用和交换数据，而无需了解对方的内部实现细节。
对象（Object）：在ArkTS，对象是一种复合数据类型，允许存储多个不同类型的值作为一个单独的实体。对象是属性和方法的集合。属性是与对象相关联的值，而方法则是对象可以执行的操作。

以下Node-API接口主要用于操作和管理ArkTS对象，使用场景介绍：

接口	描述
napi_get_prototype	当需要获取一个ArkTS对象的原型时，可以使用这个接口。通过这个接口可以在C/C++中获取到这个原型对象。
napi_create_object	在Node-API模块中创建一个默认的ArkTS对象。
napi_object_freeze	当需要确保一个对象不会被修改时（immutable），可以使用这个接口来冻结该对象，使其属性不可更改。
napi_object_seal	类似于napi_object_freeze，napi_object_seal用于密封给定的对象，使其属性不可添加或删除，但可以修改属性的值。
napi_typeof	在处理传入的ArkTS值时，可以使用这个接口来获取其类型，以便进行相应的处理。
napi_instanceof	当需要在Node-API模块中确定一个对象是否为特定构造函数的实例时，可以使用这个接口。
napi_type_tag_object	可以将指针的特定值与ArkTS对象关联起来，这对于一些自定义的内部对象标记非常有用。
napi_check_object_type_tag	使用此接口可以检查给定的对象上是否关联了特定类型的标记。
napi_create_symbol	创建一个ArkTS Symbol对象。
napi_create_external	用于创建一个ArkTS外部对象，该对象可以用于将C/C++中的自定义数据结构或对象传递到ArkTS中，并且可以在ArkTS中访问其属性和方法。
napi_get_value_external	用于获得napi_create_external创建的绑定了外部数据的ArkTS值，此函数可以在ArkTS和C/C++之间传递数据。