开发Node.js事件函数

约束与限制

• callback返回的第一个参数不为null，则认为函数执行失败，会返回定义在第二个参数的HTTP错误信息。
• 当使用APIG触发器时，函数返回必须使用示例中output的格式， 函数Body参数仅支持返回如下几种类型的值。
  • null：函数返回的HTTP响应Body为空。
  • []byte: 函数返回的HTTP响应Body内容为该字节数组内容。
  • string：函数返回的HTTP响应Body内容为该字符串内容。
• 通过APIG服务调用函数服务时，isBase64Encoded的值默认为true，表示APIG传递给FunctionGraph的请求体body已经进行Base64编码，需要先对body内容Base64解码后再处理。
  函数必须按以下结构返回字符串。

  {
      "isBase64Encoded": true|false,
      "statusCode": httpStatusCode,
      "headers": {"headerName":"headerValue",...},
      "body": "..."
  }

步骤一：创建Node.js函数工程

1. 打开本地文本编辑器，编写函数代码，将文件命名为“index.js”。
   • 以下代码为同步形式入口函数：

     exports.handler = function (event, context, callback) {
         const error = null;
         const output = {
             'statusCode': 200,
             'headers':
             {
                 'Content-Type': 'application/json'
             },
             'isBase64Encoded': false,
             'body': JSON.stringify(event),
         }
         callback(error, output);
     }

   • 以下代码为异步形式入口函数，运行时 8.10 及以上支持：

     exports.handler = async (event, context) => {
         const output =
         {
             'statusCode': 200,
             'headers':
             {
                 'Content-Type': 'application/json'
             },
             'isBase64Encoded': false,
             'body': JSON.stringify(event),
         }
         return output;
     }

     如果您的Node.js函数中包含异步任务，需使用Promise以确保该异步任务在当次调用执行，可以直接在return中声明Promise，也可以await执行该Promise。

     暂时不支持在函数响应请求后继续执行异步任务的能力。

     exports.handler =  async(event, context ) => {
         const output =
         {
             'statusCode': 200,
             'headers':
             {
                 'Content-Type': 'application/json'
             },
             'isBase64Encoded': false,
             'body': JSON.stringify(event),
         }
      
         const promise = new Promise((resolve, reject) => {
             setTimeout(() => {
                 resolve(output)
             }, 2000)
         })
         return promise
         // anthor way 
         // res = await promise;
         // return res 
     }

     异步执行函数说明：

     如果期望函数先响应，随后继续执行任务，即异步执行函数，可以通过SDK/API调用FunctionGraph的异步执行函数接口实现。

     如需使用APIG触发器，可以单击生成的APIG触发器名称，跳转到APIG服务页面，选择Asynchronous（异步）方式调用，具体操作步骤可参考配置函数的异步调用。

2. 打包函数工程。以使用异步形式入口为例。

   函数工程创建以后，会得到以下目录，选中工程所有文件，打包成Zip文件并命名为“fss_examples_nodejs.zip”。打包时请确保解压后，入口函数所在的文件位于根目录。

   您也可以直接下载打包好的Node.js函数样例工程包使用。

   图1 打包
   

步骤二：创建FunctionGraph函数

1. 登录函数工作流控制台，右上角单击“创建函数”。
2. 如图2所示，创建一个空白的Node.js事件函数，单击“立即创建”进入函数详情页。
   图2 创建Node.js函数
   

3. 如图3所示，单击“上传代码 > Zip文件”，上传步骤一：创建Node.js函数工程打包的fss_examples_nodejs.zip文件。
   上传的代码将在函数工作流控制台自动部署，如修改代码，请再次单击“部署代码”。

   图3 上传程序包
   

修改函数执行入口：

在FunctionGraph控制台左侧导航栏选择“函数 > 函数列表”，单击需要设置的“函数名称”进入函数详情页，选择“设置 > 常规设置”，配置“函数执行入口”参数，如图4所示。

图4 函数执行入口参数

• 函数执行入口中的index：与步骤一：创建Node.js函数工程中创建的函数文件名保持一致，通过该名称找到FunctionGraph函数所在文件。
• 函数执行入口中的handler：为执行函数名，与步骤一：创建Node.js函数工程中创建的index.js文件代码中的函数名保持一致。

步骤三：测试函数

1. 在“代码”页签下，单击“测试”，弹出“配置测试事件”弹窗，如图5所示配置测试事件“test”，单击“创建”。
   图5 配置测试事件
   
2. 选择已配置的测试事件“test”，单击“测试”。
3. 如图6所示，右侧出现“执行结果”窗口，可测试函数是否执行成功。
   图6 测试结果
   

函数执行结果说明

函数执行结果由3部分组成：函数返回、执行摘要和日志。

{
    "errorMessage": "", 
    "errorType":"", 
}

相关文档

• 使用Node.js运行时语言开发HTTP函数，可参考使用Node.js开发HTTP函数。
• 制作Node.js运行时的函数依赖包，可参考为Node.js函数制作依赖包。
• 关于函数开发的更多说明，如函数支持的运行时、函数支持的触发事件、函数工程打包规范以及如何在函数中引入动态链接库，请参见函数开发概述。