Wir stellen Version 3.0 des jQuery SDK vor

Tim Koschützki

Mitgründer · Berlin, Deutschland · Bio anzeigen

Vor Kurzem haben wir Ihnen die Neuigkeit mitgeteilt, dass wir fortsetzbare Datei-Uploads jetzt produktiv unterstützen – ermöglicht durch tus⁠ – und dass wir die Unterstützung dafür nach und nach auch in unseren SDKs ausrollen werden.

Wir freuen uns, Ihnen mitteilen zu können, dass wir unser jQuery SDK⁠ von Version 2.8 auf 3.0 aktualisiert haben und es standardmäßig fortsetzbare Uploads auf Basis von tus unterstützt.

Wir empfehlen zwar allen Nutzern das Upgrade auf diese neue Hauptversion, Sie sollten aber auch prüfen, ob unser JavaScript-Dateiuploader der nächsten Generation Uppy⁠ gut zu Ihnen passt. Uppy ist Open Source, robust, modular und funktionsreich (Instagram, Webcam, React, S3). Sie können Uppy auch ohne Transloadit einsetzen, und es hat keine Abhängigkeit von jQuery.

Ihre jQuery-Integration auf Uppy zu portieren, ist womöglich etwas mehr Aufwand als ein reines Upgrade auf v3, aber wir sind überzeugt, dass sich die Mühe lohnt!

Dennoch hat unser jQuery SDK weiterhin eine beachtliche Nutzerbasis, und wir finden, dass diese Nutzer genauso zuverlässige Datei-Uploads verdienen wie alle anderen. Deshalb haben wir uns entschieden, ein letztes großes Upgrade zu veröffentlichen.

Neben der Unterstützung für fortsetzbare Datei-Uploads bringt das neue jQuery SDK die folgenden Änderungen mit:

• Durchgängig verbesserte Performance
• Unterstützung für Drag and Drop hinzugefügt
• Unterstützung für Dateivorschaulisten hinzugefügt
• Alle Optionen rund um Polling entfernt
• Netzwerkverkehr für Aktualisierungen im Assembly Status reduziert
• Den Parameter requireUploadMetaData mit dem Standardwert false hinzugefügt, sodass wir nicht mehr auf Metadaten des Datei-Uploads warten, was eine deutliche Geschwindigkeitssteigerung bringt. Diese Änderung wurde auch auf die letzte Version der Reihe 2.x zurückportiert
• Den Parameter maxNumberOfUploadedFiles hinzugefügt, mit dem Sie die maximal zulässige Anzahl hochzuladender Dateien begrenzen können
• Zwei neue Callbacks hinzugefügt: onDisconnect() und onReconnect()

Version 3.0 des SDK ist jetzt offiziell aus der Beta-Phase heraus, und wir empfehlen Ihnen, möglichst bald auf diese Version umzusteigen. Sie ist unter https://assets.transloadit.com/js/jquery.transloadit2-v3-latest.js verfügbar. Entsprechend gilt Version 2 des SDK nun als veraltet und erhält ab dem 1. Januar 2018 nur noch Sicherheitsupdates.

Außerdem haben wir beschlossen, unsere Version jquery.transloadit2-latest.js künftig zu entfernen. Sie verwies immer auf die jeweils neueste Hauptversion, aber wir möchten Nutzer nicht länger automatisch zwischen Hauptversionen aktualisieren, da dies unweigerlich zu Problemen mit der Abwärtskompatibilität führt. Wenn niemand mehr diese magische Version verwendet, können wir Änderungen vornehmen, die die Abwärtskompatibilität brechen, ohne uns um die Folgen sorgen zu müssen. Kurz gesagt: Am 1. Januar 2018 wird die Version unter https://assets.transloadit.com/js/jquery.transloadit2-latest.js als „End of Life“ markiert und komplett aus der Wartung genommen.

Zwischen beiden Hauptversionen gibt es nur eine Handvoll Änderungen, die die Abwärtskompatibilität brechen. Wahrscheinlich können Sie einfach die URL auf die neue Hauptversion ändern, und alles funktioniert weiterhin. Testen Sie das aber unbedingt! Der Einfachheit halber finden Sie hier die Punkte, die die Abwärtskompatibilität brechen und auf die Sie achten sollten:

• Der Callback onExecuting() enthält das Array der Uploads nicht mehr. Bitte verwenden Sie den onUpload-Callback, um empfangene Uploads zu verfolgen
• Die Callbacks onUpload() und onResult() erhalten das Assembly-Objekt nicht mehr als Parameter
• Der Parameter formData wurde entfernt, da jetzt alle Uploads XHR verwenden. Das bricht die Abwärtskompatibilität für Sie nur, wenn Sie formData: <customFormDataObj> verwendet haben. In diesem Fall sollten Sie die Inhalte Ihrer eigenen Formulardaten nun als versteckte Eingabefelder zum Formular hinzufügen
• Es wurden mehrere neue Sätze hinzugefügt, für die Sie neue Übersetzungen ergänzen müssen, wenn Sie ein eigenes Locale verwenden. Details finden Sie in der Dokumentation zur Lokalisierung des jQuery SDK⁠
• Es gibt jetzt einen neuen Parameter translations, der verwendet werden muss, damit Ihr eigenes Locale funktioniert

Wie immer ist Feedback sehr willkommen! Viel Spaß!