jQuery SDK バージョン 3.0 リリースのお知らせ
先日、お知らせしたとおり、tus による再開可能なファイルアップロードが本番環境で利用できるようになりました。各 SDK でも順次対応を進める予定です。
このたび、jQuery SDK をバージョン 2.8 から 3.0 にアップグレードしました。tus による再開可能なアップロードがデフォルトで有効になっています。

すべてのユーザーに今回のメジャーバージョンへのアップグレードをお勧めしますが、次世代の JavaScript ファイルアップローダー Uppy が用途に合うかどうかも、ぜひご検討ください。Uppy はオープンソースで、堅牢かつモジュール式です。Instagram、Webcam、React、S3 など、豊富な機能を備えています。Uppy は Transloadit なしでも利用でき、jQuery にも依存しません。
既存の jQuery 連携を Uppy に移行するには、単に v3 にアップグレードするより少し手間がかかるかもしれませんが、それだけの価値があると考えています。
とはいえ、jQuery SDK には今も多くのユーザーがいます。その方々にも、ほかのユーザーと同じように信頼性の高いファイルアップロードを利用していただきたいと考え、最後のメジャーアップグレードをリリースすることにしました。
新しい jQuery SDK では、再開可能なファイルアップロードへの対応に加え、以下の変更を行いました。
- 全体的なパフォーマンスの向上
- ドラッグ&ドロップへの対応
- ファイルプレビューリストへの対応
- ポーリング関連の全オプションの削除
- Assembly Status の更新に伴うネットワーク通信量の削減
requireUploadMetaDataパラメーターの追加。デフォルト値をfalseとし、ファイルアップロードのメタデータを待たなくなったことで、処理速度が大幅に向上しました。この変更は2.x系列の最終バージョンにもバックポートしましたmaxNumberOfUploadedFilesパラメーターの追加。アップロードを許可するファイル数の上限を設定できます- 新しいコールバック
onDisconnect()とonReconnect()の二つの追加
SDK のバージョン 3.0 は正式にベータを終了しました。都合がつき次第、このバージョンの利用を開始することをお勧めします。https://assets.transloadit.com/js/jquery.transloadit2-v3-latest.js から入手できます。これに伴い、SDK のバージョン 2 は非推奨となり、2018年1月1日以降はセキュリティ更新のみを提供します。
また、今後は jquery.transloadit2-latest.js バージョンを廃止する方針を決めました。これは常に最新のメジャーバージョンを指していましたが、メジャーバージョン間の自動更新は後方互換性の問題を避けられないため、今後は行わないことにしました。この特殊なバージョンの利用をなくすことで、影響を心配せずに後方互換性を損なう変更を行えるようになります。つまり、2018年1月1日をもって、https://assets.transloadit.com/js/jquery.transloadit2-latest.js のバージョンは「サポート終了」となり、メンテナンスを完全に終了します。
両メジャーバージョン間で後方互換性を損なう変更は、わずかです。URL を新しいメジャーバージョンのものに変更するだけで、そのまま動作する可能性は高いですが、必ずテストしてください。確認しやすいように、注意が必要な非互換の変更を以下にまとめました。
onExecuting()コールバックには、アップロードの配列が含まれなくなりました。受信したアップロードの追跡には onUpload コールバックを使用してくださいonUpload()とonResult()のコールバックは、Assembly オブジェクトを引数として受け取らなくなりました- すべてのアップロードで XHR を使用するようになったため、
formDataパラメーターを削除しました。この変更が後方互換性に影響するのは、formData: <customFormDataObj>を使用していた場合のみです。その場合は、カスタムフォームデータの内容をフォームの非表示入力フィールドとして追加してください - 新しい文言をいくつか追加しました。カスタムロケールを使用している場合は、それらの翻訳を追加する必要があります。詳しくは、jQuery SDK のローカライズに関するドキュメントを確認してください
- カスタムロケールを動作させるには、新しい
translationsパラメーターを使用する必要があります
いつもどおり、フィードバックをお待ちしています。ぜひご活用ください!
