このページは AI コーディングエージェントスキルの一部で、人間ではなくエージェント向けに書かれています。人間向けの Base44 ドキュメントはデベロッパードキュメントを参照してください。

関数の作成

Base44 の関数は Deno 上で実行されるサーバーレスバックエンド関数です。プロジェクト内でローカルに定義され、Base44 バックエンドにデプロイされます。

関数ディレクトリ

すべての関数定義はプロジェクトの base44/functions/ フォルダーに配置する必要があります。最もシンプルな関数は、entry.ts または entry.js ファイルを含むフォルダーです。構造の例:

my-app/
  base44/
    functions/
      process-order/
        entry.ts
      send-notification/
        entry.ts

関数の作成方法

base44/functions/ に関数名で新しいディレクトリを作成します (kebab-case を使用)
そのディレクトリに entry.ts (または entry.js) を作成します
CLI を使用して関数をデプロイします

関数の検出

CLI は entry.ts または entry.js ファイルから関数を検出します。それらのファイルのいずれかを含むフォルダーが関数です:

base44/
  functions/
    process-order/
      entry.ts

関数名は functions ルートからそのフォルダーまでのパスです。例:

ファイル	関数名
`base44/functions/process-order/entry.ts`	`process-order`
`base44/functions/orders/process/entry.ts`	`orders/process`

ルール:

entry.ts または entry.js は base44/functions/ 直下ではなく、名前付きサブフォルダー内にある必要があります
関数フォルダー内のすべての *.js、*.ts、*.json ファイルはデプロイ時に含まれます
パスセグメントにドットを含む関数パスは無視されます

エントリーポイントファイル

関数は Deno 上で実行され、Deno.serve() を使用してエクスポートする必要があります。npm パッケージには npm: プレフィックスを使用します。

import { createClientFromRequest } from "npm:@base44/sdk";

Deno.serve(async (req) => {
  // Get authenticated client from request
  const base44 = createClientFromRequest(req);
  
  // Parse input
  const { orderId, action } = await req.json();
  
  // Your logic here
  const order = await base44.entities.Orders.get(orderId);
  
  // Return response
  return Response.json({
    success: true,
    order: order
  });
});

Request オブジェクト

関数は標準の Deno Request オブジェクトを受け取ります:

req.json() - JSON ボディを解析
req.text() - 生のテキストボディを取得
req.headers - リクエストヘッダーにアクセス
req.method - HTTP メソッド

Response オブジェクト

JSON レスポンスには Response.json() を使用して返します:

// Success response
return Response.json({ data: result });

// Error response with status code
return Response.json({ error: "Something went wrong" }, { status: 400 });

// Not found
return Response.json({ error: "Order not found" }, { status: 404 });

完全な例

ディレクトリ構造

base44/
  functions/
    process-order/
      entry.ts

entry.ts

import { createClientFromRequest } from "npm:@base44/sdk";

Deno.serve(async (req) => {
  try {
    const base44 = createClientFromRequest(req);
    const { orderId } = await req.json();
    
    // Validate input
    if (!orderId) {
      return Response.json(
        { error: "Order ID is required" },
        { status: 400 }
      );
    }
    
    // Fetch and process the order
    const order = await base44.entities.Orders.get(orderId);
    if (!order) {
      return Response.json(
        { error: "Order not found" },
        { status: 404 }
      );
    }
    
    return Response.json({
      success: true,
      orderId: order.id,
      processedAt: new Date().toISOString()
    });
    
  } catch (error) {
    return Response.json(
      { error: error.message },
      { status: 500 }
    );
  }
});

サービスロールアクセスの使用

管理者レベルの操作には asServiceRole を使用します:

import { createClientFromRequest } from "npm:@base44/sdk";

Deno.serve(async (req) => {
  const base44 = createClientFromRequest(req);
  
  // Check user is authenticated
  const user = await base44.auth.me();
  if (!user) {
    return Response.json({ error: "Unauthorized" }, { status: 401 });
  }
  
  // Use service role for admin operations
  const allOrders = await base44.asServiceRole.entities.Orders.list();
  
  return Response.json({ orders: allOrders });
});

シークレットの使用

アプリダッシュボードで設定された環境変数にアクセス:

Deno.serve(async (req) => {
  // Access environment variables (configured in app settings)
  const apiKey = Deno.env.get("STRIPE_API_KEY");
  
  const response = await fetch("https://api.stripe.com/v1/charges", {
    headers: {
      "Authorization": `Bearer ${apiKey}`
    }
  });
  
  return Response.json(await response.json());
});

命名規則

ディレクトリ名: kebab-case を使用 (例: process-order, send-notification)
関数名: base44/functions/ の下のディレクトリパスから決まります
- 有効: process-order, orders/process, send_notification, myFunction
- 無効: process.order, send.notification.v2
エントリーファイル: entry.ts または entry.js を使用

関数のデプロイ

関数を作成したら、Base44 にデプロイします:

npx base44 functions deploy

デプロイの詳細は functions-deploy.md を参照してください。

注意事項

関数は Node.js ではなく Deno ランタイム上で実行されます
npm パッケージには npm: プレフィックスを使用します (例: npm:@base44/sdk)
呼び出し元の認証コンテキストを継承するクライアントを取得するには createClientFromRequest(req) を使用します
API キーは app ダッシュボードでシークレットを設定します
エラーを適切に処理し、適切な HTTP ステータスコードを返してください

よくある間違い

誤	正	理由
`base44/functions/myFunction.js` (単一ファイル)	`base44/functions/my-function/entry.ts`	関数は名前付きサブディレクトリに存在する必要があります
`base44/functions/entry.ts`	`base44/functions/my-function/entry.ts`	関数名はサブディレクトリパスから決まります
`import { ... } from "@base44/sdk"`	`import { ... } from "npm:@base44/sdk"`	Deno は npm パッケージに `npm:` プレフィックスを必要とします
`MyFunction` または `myFunction` ディレクトリ	`my-function` ディレクトリ	ディレクトリ名には kebab-case を使用します

このページは AI を使用して翻訳されました。最も正確で最新の情報については、英語版を参照してください。

Getting started

Building your app

Designing your app

Managing app data

Adding logic to your app

Selling on your app

Using on mobile

Domains

Securing your app

Measuring your app

Growing your app's reach

Superagents

Integrations

関数の作成

関数の作成

関数ディレクトリ

関数の作成方法

関数の検出

エントリーポイントファイル

Request オブジェクト

Response オブジェクト

完全な例

ディレクトリ構造

entry.ts

サービスロールアクセスの使用

シークレットの使用

命名規則

関数のデプロイ

注意事項

よくある間違い

​関数の作成

​関数ディレクトリ

​関数の作成方法

​関数の検出

​エントリーポイントファイル

​Request オブジェクト

​Response オブジェクト

​完全な例

​ディレクトリ構造

​entry.ts

​サービスロールアクセスの使用

​シークレットの使用

​命名規則

​関数のデプロイ

​注意事項

​よくある間違い

関数の作成

関数ディレクトリ

関数の作成方法

関数の検出

エントリーポイントファイル

Request オブジェクト

Response オブジェクト

完全な例

ディレクトリ構造

entry.ts

サービスロールアクセスの使用

シークレットの使用

命名規則

関数のデプロイ

注意事項

よくある間違い