Anunciamos la versión 3.0 del SDK de jQuery

Tim Koschützki

Cofundador · Berlín, Alemania · Mostrar bio

Hace poco compartimos la noticia de que ya admitimos subidas de archivos reanudables en producción, impulsadas por el protocolo tus⁠, y de que iremos habilitando gradualmente su compatibilidad también en nuestros SDK.

Nos complace contarte que ya actualizamos nuestro SDK de jQuery⁠ de la versión 2.8 a 3.0, y que admite de forma predeterminada subidas reanudables impulsadas por el protocolo tus.

Aunque recomendamos a todos los usuarios que actualicen a esta nueva versión mayor, también deberías comprobar si nuestra herramienta de subida de archivos en JavaScript de nueva generación, Uppy⁠, puede ser una buena opción para ti. Uppy es de código abierto, robusto, modular y rico en funciones (Instagram, Webcam, React, S3). Puedes usar Uppy sin Transloadit y no depende de jQuery.

Migrar tu integración de jQuery a Uppy puede requerir algo más de trabajo que simplemente actualizarla a v3, pero creemos que verás que vale la pena.

Dicho esto, nuestro SDK de jQuery todavía tiene una base de usuarios considerable, y sentimos que esos usuarios merecen subidas de archivos confiables tanto como el resto de nosotros. Por eso, decidimos lanzar una última actualización mayor.

Además de admitir subidas de archivos reanudables, el nuevo SDK de jQuery incluye los siguientes cambios:

• Rendimiento mejorado en todos los aspectos
• Se agregó compatibilidad con arrastrar y soltar
• Se agregó compatibilidad con listas de vista previa de archivos
• Se eliminaron todas las opciones relacionadas con el sondeo
• Se redujo la cantidad de tráfico de red para las actualizaciones de Assembly Status
• Se agregó el parámetro requireUploadMetaData con un valor predeterminado de false, de modo que ya no esperamos los metadatos de subida de archivos, lo que se traduce en una gran mejora de velocidad. Este cambio también se retroportó a la última versión de la serie 2.x
• Se agregó el parámetro maxNumberOfUploadedFiles, con el que puedes establecer un límite al número máximo de archivos que se permite subir
• Se agregaron dos nuevos callbacks: onDisconnect() y onReconnect()

La versión 3.0 del SDK ya salió oficialmente de la fase beta y te recomendamos empezar a usarla cuanto antes. Está disponible en https://assets.transloadit.com/js/jquery.transloadit2-v3-latest.js. En consecuencia, la versión 2 del SDK queda en desuso y, a partir del 1 de enero de 2018, solo recibirá actualizaciones de seguridad.

También decidimos que, en el futuro, queremos eliminar nuestra versión jquery.transloadit2-latest.js. Esta siempre ha apuntado a la última de las versiones mayores, pero ya no queremos actualizar automáticamente a los usuarios entre versiones mayores, porque eso genera inevitablemente problemas de compatibilidad con versiones anteriores. Que nadie use esta versión mágica nos permite hacer cambios que rompen la compatibilidad con versiones anteriores sin preocuparnos por las consecuencias. En resumen: el 1 de enero de 2018, la versión en https://assets.transloadit.com/js/jquery.transloadit2-latest.js se marcará como «End of Life» y quedará completamente fuera de mantenimiento.

Solo hay un puñado de cambios que rompen la compatibilidad entre ambas versiones mayores. Lo más probable es que puedas simplemente cambiar la URL a la nueva versión mayor y todo siga funcionando. Dicho esto, ¡asegúrate de probarlo! Para tu comodidad, estos son los problemas de compatibilidad a los que debes prestar atención:

• El callback onExecuting() ya no incluye el array de subidas. Por favor, usa el callback onUpload para hacer seguimiento de las subidas recibidas
• Los callbacks onUpload() y onResult() ya no reciben el objeto Assembly como parámetro
• Se eliminó el parámetro formData, porque ahora todas las subidas usan XHR. Esto solo romperá la compatibilidad para ti si usabas formData: <customFormDataObj>. En ese caso, ahora debes agregar el contenido de tus datos de formulario personalizados como campos de entrada ocultos en el formulario
• Se agregaron varias frases nuevas para las que tendrías que agregar nuevas traducciones si tenías una configuración regional personalizada. Por favor, consulta la documentación de localización del SDK de jQuery⁠ para más detalles
• Ahora hay un nuevo parámetro translations que debe usarse para que funcione tu configuración regional personalizada

Como siempre, ¡los comentarios son muy bienvenidos! ¡Que lo disfrutes!