6.5. 开发 Node.js 功能

使用 Knative (kn) CLI 创建 Node.js 功能时，项目目录类似于典型的 Node.js 项目。唯一的例外是额外的 func.yaml 文件，用于配置函数。

http 和 event 触发器功能具有相同的模板结构：

.
├── func.yaml 1
├── index.js 2
├── package.json 3
├── README.md
└── test 4
    ├── integration.js
    └── unit.js

当使用 Knative (kn) CLI 创建功能项目时，您可以生成一个响应 CloudEvents 的项目，或者响应简单 HTTP 请求的项目。Knative 中的 CloudEvents 作为 POST 请求通过 HTTP 传输，因此两种功能类型都侦听并响应传入的 HTTP 事件。

Node.js 功能可以通过简单的 HTTP 请求调用。收到传入请求后，将通过 上下文 对象作为第一个参数来调用函数。

function handle(context, data)

// Expects to receive a CloudEvent with customer data
function handle(context, customer) {
  // process the customer
  const processed = handle(customer);
  return context.cloudEventResponse(customer)
    .source('/handle')
    .type('fn.process.customer')
    .response();
}

{
  "customerId": "0123456",
  "productId": "6543210"
}

function handle(context, data)

功能可以返回任何有效的 JavaScript 类型，或者没有返回值。当函数没有指定返回值且未指示失败时，调用者会收到 204 No Content 响应。

功能也可以返回 CloudEvent 或一个 Message 对象，以便将事件推送到 Knative Eventing 系统。在这种情况下，开发人员不需要了解或实施 CloudEvent 消息传递规范。使用响应提取并发送返回值中的标头和其他相关信息。

function handle(context, customer) {
  // process customer and return a new CloudEvent
  return new CloudEvent({
    source: 'customer.processor',
    type: 'customer.processed'
  })
}

function handle(context, customer) {
  // process customer and return custom headers
  // the response will be '204 No content'
  return { headers: { customerid: customer.id } };
}

function handle(context, customer) {
  // process customer
  if (customer.restricted) {
    return { statusCode: 451 }
  }
}

function handle(context, customer) {
  // process customer
  if (customer.restricted) {
    const err = new Error(‘Unavailable for legal reasons’);
    err.statusCode = 451;
    throw err;
  }
}

Node.js 功能可以在您的计算机上本地测试。在使用 kn func create 创建功能时创建的默认项目中，有一个 test 文件夹，其中包含一些简单的单元和集成测试。