Azure Functions の Node.js プログラミング モデルのバージョン 4 に移行する

バージョン 4 は、最初の引数としてトリガー入力を取得する以下の方法のみをサポートしています。

async function httpTrigger1(request, context) {
  const onlyOption = request;

async function httpTrigger1(request: HttpRequest, context: InvocationContext): Promise<HttpResponseInit> {
  const onlyOption = request;

バージョン 3 は、トリガー入力を取得する複数の方法をサポートしています。

async function httpTrigger1(context, request) {
    const option1 = request;
    const option2 = context.req;
    const option3 = context.bindings.req;

async function httpTrigger1(context: Context, req: HttpRequest): Promise<void> {
    const option1 = request;
    const option2 = context.req;
    const option3 = context.bindings.req;

バージョン 4 は、戻り値を介してプライマリ出力を設定する方法のみをサポートしています。

return { 
  body: `Hello, ${name}!` 
};

async function httpTrigger1(request: HttpRequest, context: InvocationContext): Promise<HttpResponseInit> {
    // ...
    return { 
      body: `Hello, ${name}!` 
    };
}

バージョン 3 は、プライマリ出力を設定する複数の方法をサポートしています。

// Option 1
context.res = {
    body: `Hello, ${name}!`
};
// Option 2, but you can't use this option with any async code:
context.done(null, {
    body: `Hello, ${name}!`
});
// Option 3, but you can't use this option with any async code:
context.res.send(`Hello, ${name}!`);
// Option 4, if "name" in function.json is "res":
context.bindings.res = {
    body: `Hello, ${name}!`
}
// Option 5, if "name" in function.json is "$return":
return {
    body: `Hello, ${name}!`
};

context.log('This is an info log');
context.error('This is an error');
context.warn('This is an error');

context.log('This is an info log');
context.log.error('This is an error');
context.log.warn('This is an error');

const testInvocationContext = new InvocationContext({
  functionName: 'testFunctionName',
  invocationId: 'testInvocationId'
});

サポートできません。

• 本文。 受け取る型に応じたメソッドを使って、本文にアクセスできます。

  const body = await request.text();
  const body = await request.json();
  const body = await request.formData();
  const body = await request.arrayBuffer();
  const body = await request.blob();
  

• ヘッダー:

  const header = request.headers.get('content-type');
  

• クエリ パラメーター:

  const name = request.query.get('name');
  

• 本文。 本文にアクセスする方法はいくつかありますが、戻り値の型は必ずしも一定ではありません。

  // returns a string, object, or Buffer
  const body = request.body;
  // returns a string
  const body = request.rawBody;
  // returns a Buffer
  const body = request.bufferBody;
  // returns an object representing a form
  const body = await request.parseFormBody();
  

• ヘッダー。 ヘッダーは、次のような方法で取得できます。

  const header = request.get('content-type');
  const header = request.headers.get('content-type');
  const header = context.bindingData.headers['content-type'];
  

• クエリ パラメーター:

  const name = request.query.name;
  

• 状態:

  return { status: 200 };
  

• 本文:

  string や Buffer などのほとんどの型を返すには、"body" プロパティを使用します:

  return { body: "Hello, world!" };
  

  JSON 応答を返す最も簡単な方法として、 jsonBody プロパティを使用します:

  return { jsonBody: { hello: "world" } };
  

• ヘッダー。 ヘッダーは HttpResponse クラスと HttpResponseInit インターフェイスのどちらを使うかに応じて、2 つの方法で設定できます。

  const response = new HttpResponse();
  response.headers.set('content-type', 'application/json');
  return response;
  

  return {
    headers: { 'content-type': 'application/json' }
  };
  

• Status。 状態は、次のような方法で設定できます。

  context.res.status(200);
  context.res = { status: 200}
  context.res = { statusCode: 200 };
  return { status: 200};
  return { statusCode: 200 };
  

• 本文。 本文は複数の方法で設定できます。本文の種類 (string、Buffer、JSON オブジェクトなど) に関係なく同じです:

  context.res.send("Hello, world!");
  context.res.end("Hello, world!");
  context.res = { body: "Hello, world!" };
  return { body: "Hello, world!" };
  

• ヘッダー。 ヘッダーは、次のような方法で設定できます。

  response.set('content-type', 'application/json');
  response.setHeader('content-type', 'application/json');
  response.headers = { 'content-type': 'application/json' }
  context.res = {
    headers: { 'content-type': 'application/json' }
  };
  return {
    headers: { 'content-type': 'application/json' }
  };