Annonce de la version 3.0 du SDK jQuery

Nous vous avons récemment annoncé EN (English) que nous prenons désormais en charge les téléversements de fichiers avec reprise en production, grâce à tus⁠, et que nous allions progressivement déployer cette prise en charge dans nos SDK également.

Nous sommes heureux de vous annoncer que nous avons mis à niveau notre SDK jQuery⁠ de la version 2.8 vers la version 3.0, et qu’il prend en charge par défaut les téléversements avec reprise reposant sur tus.

Bien que nous recommandions à tous les utilisateurs de passer à cette nouvelle version majeure, nous vous conseillons aussi de vérifier si Uppy⁠, notre outil JavaScript de nouvelle génération pour le téléversement de fichiers, pourrait vous convenir. Uppy est open source, robuste, modulaire et riche en fonctionnalités (Instagram, webcam, React, S3). Vous pouvez utiliser Uppy sans Transloadit, et il ne dépend pas de jQuery.

Porter votre intégration jQuery vers Uppy peut demander un peu plus de travail que de simplement la mettre à niveau vers v3, mais nous pensons que cela en vaudra la peine pour vous !

Cela dit, notre SDK jQuery compte encore une base d’utilisateurs considérable, et nous estimons que ces utilisateurs méritent autant que nous tous des téléversements de fichiers fiables. C’est pourquoi nous avons décidé de publier une dernière mise à niveau majeure.

Outre la prise en charge des téléversements de fichiers avec reprise, le nouveau SDK jQuery apporte les changements suivants :

• Amélioration générale des performances
• Ajout de la prise en charge du glisser-déposer
• Ajout de la prise en charge des listes d’aperçu de fichiers
• Suppression de toutes les options liées à l’interrogation périodique (polling)
• Réduction du trafic réseau pour les mises à jour de l’Assembly Status
• Ajout du paramètre requireUploadMetaData, défini par défaut sur false, afin que nous n’attendions plus les métadonnées de téléversement des fichiers, ce qui améliore nettement la vitesse. Ce changement a également été rétroporté dans la dernière version de la série 2.x
• Ajout du paramètre maxNumberOfUploadedFiles, qui vous permet de limiter le nombre maximal de fichiers autorisés à être téléversés
• Ajout de deux nouveaux callbacks : onDisconnect() et onReconnect()

La version 3.0 du SDK est désormais officiellement sortie de bêta, et nous vous recommandons de commencer à l’utiliser dès que possible. Elle est disponible à l’adresse https://assets.transloadit.com/js/jquery.transloadit2-v3-latest.js. En conséquence, la version 2 du SDK est désormais dépréciée et, à partir du 1er janvier 2018, elle ne recevra plus que des mises à jour de sécurité.

Nous avons également décidé qu’à l’avenir, nous aimerions supprimer notre version jquery.transloadit2-latest.js. Celle-ci a toujours correspondu à la dernière version majeure, mais nous ne souhaitons plus faire passer automatiquement les utilisateurs d’une version majeure à l’autre, car cela entraîne inévitablement des problèmes de rétrocompatibilité. Sans utilisateurs sur cette version magique, nous pouvons apporter des changements qui rompent la rétrocompatibilité sans nous soucier des conséquences. En bref : le 1er janvier 2018, la version disponible à l’adresse https://assets.transloadit.com/js/jquery.transloadit2-latest.js sera marquée « fin de vie » et ne sera plus du tout maintenue.

Il n’y a qu’une poignée de changements qui rompent la rétrocompatibilité entre ces deux versions majeures. Il y a de fortes chances qu’il vous suffise de remplacer l’URL par celle de la nouvelle version majeure pour que tout continue de fonctionner. Cela dit, pensez à bien tester ! Pour vous faciliter la tâche, voici les changements rompant la rétrocompatibilité à surveiller :

• Le callback onExecuting() ne reçoit plus le tableau des téléversements. Veuillez utiliser le callback onUpload pour suivre les téléversements reçus
• Les callbacks onUpload() et onResult() ne reçoivent plus l’objet Assembly en paramètre
• Le paramètre formData a été supprimé, car tous les téléversements utilisent désormais XHR. Cela ne rompra la rétrocompatibilité pour vous que si vous utilisiez formData: <customFormDataObj>. Dans ce cas, vous devez désormais ajouter le contenu de vos données de formulaire personnalisées au formulaire sous forme de champs de saisie masqués
• Plusieurs nouvelles phrases ont été ajoutées, pour lesquelles vous devrez ajouter de nouvelles traductions si vous utilisiez une locale personnalisée. Veuillez consulter la documentation de localisation du SDK jQuery⁠ pour plus de détails
• Il existe désormais un nouveau paramètre translations à utiliser obligatoirement pour que votre locale personnalisée fonctionne

Comme toujours, vos retours sont les bienvenus ! Bonne utilisation !