動的評価
${file.meta.width} のようなプレースホルダー変数だけではアプリケーションのロジックを実装できない場合は、モダン JavaScript の全機能を使って、動的な Assembly の処理設定を作成できます。これらのスクリプトは当社のインフラストラクチャ上で実行され、すべての
Assembly Variables にアクセスできます。これには、Transloadit が自動的に取得するファイルのメタデータ、Assembly の実行環境に関する基本情報、開発者が Assembly の作成時に値を設定できるフィールドが含まれます。
たとえば、黄金比というデザイン原則に沿って、画像をリサイズできます。
{
"robot": "/image/resize",
"height": "${file.meta.width / ((1 + Math.sqrt(5)) / 2)}",
"resize_strategy": "crop"
}
また、S3 へのアップロード時に、出力ファイル名を大文字に変換することもできます。
{
"robot": "/s3/store",
"path": "my-folder/${file.name.toUpperCase()}"
}
${...} 内のすべてが評価されます。スクリプトが非同期処理を行わない限り、JavaScript のすべての言語機能を利用できます。たとえば、Math、Date、String
などのメソッドを使えます。
変数の参照
${file.name} や ${file.meta.faces[0]} のように、単純に変数を参照するだけの動的評価は無料です。
${Math.max(10, file.meta.width)} のような、より複雑な評価には料金がかかります。これは、JavaScript を解釈するために 🤖/script/run を呼び出すためです。マシンへの負荷が増し、処理も数ミリ秒遅くなりますが、本格的なプログラミング言語を使える分、より強力な処理を実現できます。