输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
文档管理中心
全部文档
指南
API
开放能力API
开发与测试开放能力API应用服务Cloud Foundation Kit（云开发服务）云函数开发云函数开发函数Node.js

Node.js

更新时间: 2026-09-01 03:59
本文导读
展开章节

约束与限制

支持Phone、Tablet设备。并且从5.1.0(18)版本开始，新增支持Wearable设备；从5.1.1(19)版本开始，新增支持TV设备；从6.1.0(23)版本开始，新增支持PC/2in1设备。

入口方法

入口方法定义如下：

收起
自动换行
深色代码主题
复制
  1. module.exports.myHandler = function(event, context, callback, logger)

  • myHandler：入口方法名称。

  • event：调用方传递的事件对象，JSON格式。具体内容请参见event对象。

  • context：函数运行时上下文对象，封装了日志接口、回调接口、环境变量env对象等。

  • callback：事件处理结果。

  • logger：记录日志。

函数必须通过显式调用callback(object)将事件处理结果返回给AppGallery Connect（简称AGC），结果可以是任意对象，但必须与JSON.stringify兼容，AGC会将结果转换成JSON字符串后，返回给调用方。callback执行完成，函数即执行结束。

完整的Node.js 20.x云函数示例代码请参考函数示例。

日志记录

开发者可在代码中使用logger接口记录日志，后端已通过global.logger全局定义，目前支持四种级别：

  • logger.debug()

  • logger.error()

  • logger.warn()

  • logger.info()

获取环境变量

开发者可在代码中使用context.env.key访问环境变量，获取环境变量env1示例如下：

收起
自动换行
深色代码主题
复制
  1. let env1 = context.env.env1;

若环境变量未配置，则会返回环境变量为undefined。

异常处理

开发者可以在函数代码中捕获异常，封装成error对象返回给调用方。对于函数执行期间被平台捕获的异常，平台同样以error对象形式返回给调用方。error对象定义如下。

收起
自动换行
深色代码主题
复制
  1. let error = {
  2.     code: xxxxxx,
  3.     message: "xxxxxxxx"
  4. };

其中code为错误码，message为错误码的描述信息。

示例代码如下：

收起
自动换行
深色代码主题
复制
  1. try {
  2.     logger.info(JSON.stringify(event));
  3.     let result = { message: "success" };
  4.     callback(result);
  5. } catch (err) {
  6.     let error = {
  7.         code: 400,
  8.         message: err.message
  9.     };
  10.     callback(error);
  11. }

函数示例

示例函数如下：

说明

示例代码中入口方法myHandler()的返回值类型仅供参考，开发者可以根据实际需要定义。

收起
自动换行
深色代码主题
复制
  1. let myHandler = function (event, context, callback, logger) {
  2. 

  3.     let env1 = context.env.env1;
  4.     logger.info("Test info log");
  5.     logger.warn("Test warn log");
  6.     logger.debug("Test debug log");
  7.     logger.error("Test error log");
  8. 

  9.     logger.info("--------Start-------");
  10.     try {
  11.         let startTime = new Date().getTime();
  12.         let endTime = startTime;
  13.         let interval = 0;
  14.         startTime = process.uptime() * 1000;
  15. 

  16.         logger.info("request: " + JSON.stringify(event.request));
  17.         logger.info("env1: " + env1);
  18. 

  19.         endTime = process.uptime() * 1000;
  20.         interval = endTime - startTime;
  21.         logger.info("intervalTime: " + interval);
  22.         logger.info("--------Finished-------");
  23. 

  24.         let res = new context.HTTPResponse(context.env, {
  25.             "res-type": "context.env",
  26.             "faas-content-type": "json"
  27.         }, "application/json", "200");
  28.         res.body = { "intervalTime": interval };
  29.         callback(res);
  30.     } catch (error) {
  31.         logger.error("--------Error-------");
  32.         logger.error("error: " + error);
  33.         callback(error);
  34.     }
  35. };
  36. 

  37. module.exports.myHandler = myHandler;
handler.js

准备函数部署包

上传的Node.js函数部署包须使用如下结构，处理程序所在代码文件，例如示例中的handler.js，必须在zip包根目录下，依赖项放到node_modules目录下。

收起
自动换行
深色代码主题
复制
  1. my-function.zip
  2.   |---- handler.js
  3.   |---- node_modules
  4.     |----async
  5.     |----async-listener

可通过npm工具的相关命令，安装与管理依赖。例如npm install xxx命令（执行路径无限制）可将依赖xxx自动安装到根目录的node_modules文件夹下。

开发函数
创建函数
简体中文
华为开发者联盟 版权所有 ©2026
问题反馈
使用条款
华为开发者联盟用户协议
关于华为开发者联盟与隐私的声明
Cookies
开源软件声明
在 开发与测试 开放能力API 中进行搜索
请输入您想要搜索的关键词