Anunciando a versão 3.0 do SDK jQuery

Recentemente, compartilhamos a novidade EN (English) de que agora oferecemos suporte a uploads de arquivos retomáveis em produção, com a tecnologia do tus⁠, e que também vamos adicionar esse suporte gradualmente aos nossos SDKs.

Temos o prazer de contar que atualizamos nosso SDK jQuery⁠ da versão 2.8 para a 3.0, e ele agora oferece, por padrão, uploads retomáveis com a tecnologia do tus.

Embora recomendemos que todos os usuários atualizem para esta nova versão principal, vale a pena verificar se o Uppy⁠, nosso uploader de arquivos JavaScript de nova geração, pode ser uma boa opção para você. O Uppy é de código aberto, robusto, modular e repleto de recursos (Instagram, Webcam, React, S3). Você pode usar o Uppy sem a Transloadit, e ele não depende do jQuery.

Migrar sua integração com jQuery para o Uppy pode dar um pouco mais de trabalho do que simplesmente atualizá-la para a v3, mas achamos que você vai ver que vale a pena!

Dito isso, nosso SDK jQuery ainda tem uma base considerável de usuários, e achamos que eles merecem uploads de arquivos confiáveis tanto quanto todos nós. Por isso, decidimos lançar uma última atualização principal.

Além do suporte a uploads de arquivos retomáveis, o novo SDK jQuery também traz as seguintes mudanças:

• Desempenho aprimorado de forma geral
• Adicionado suporte a arrastar e soltar
• Adicionado suporte a listas de pré-visualização de arquivos
• Removidas todas as opções relacionadas a polling
• Reduzida a quantidade de tráfego de rede nas atualizações do Assembly Status
• Adicionado o parâmetro requireUploadMetaData, com padrão false, para que não esperemos mais pelos metadados de upload dos arquivos, o que resulta em uma grande melhoria de velocidade. Essa mudança também foi portada para a última versão da série 2.x
• Adicionado o parâmetro maxNumberOfUploadedFiles, com o qual você pode definir um limite para o número máximo de arquivos permitidos no upload
• Adicionados dois novos callbacks: onDisconnect() e onReconnect()

A versão 3.0 do SDK saiu oficialmente da fase beta, e recomendamos que você comece a usá-la o quanto antes. Ela está disponível em https://assets.transloadit.com/js/jquery.transloadit2-v3-latest.js. Consequentemente, a versão 2 do SDK agora está obsoleta e, a partir de 1º de janeiro de 2018, receberá apenas atualizações de segurança.

Também decidimos que, no futuro, gostaríamos de remover nossa versão jquery.transloadit2-latest.js. Ela sempre correspondeu à mais recente das versões principais, mas não queremos mais atualizar automaticamente os usuários entre versões principais, já que isso inevitavelmente causa problemas de compatibilidade retroativa. Sem usuários nessa versão mágica, podemos fazer mudanças que quebram a compatibilidade retroativa sem nos preocupar com as consequências. Resumindo: em 1º de janeiro de 2018, a versão em https://assets.transloadit.com/js/jquery.transloadit2-latest.js será marcada como “fim de vida” e deixará completamente de receber manutenção.

Há apenas algumas mudanças que quebram a compatibilidade retroativa (BC) entre as duas versões principais. É bem provável que você só precise trocar a URL pela da nova versão principal e tudo continue funcionando. Ainda assim, não deixe de testar! Para sua conveniência, estes são os pontos de quebra de BC aos quais você deve ficar atento:

• O callback onExecuting() não recebe mais o array de uploads. Use o callback onUpload para acompanhar os uploads recebidos
• Os callbacks onUpload() e onResult() não recebem mais o objeto da Assembly como parâmetro
• O parâmetro formData foi removido, porque agora todos os uploads usam XHR. Isso só vai quebrar a compatibilidade para você se você usava formData: <customFormDataObj>. Nesse caso, agora você deve adicionar o conteúdo dos seus dados de formulário personalizados ao formulário como campos de entrada ocultos
• Foram adicionadas várias frases novas, para as quais você precisaria adicionar traduções caso tivesse um locale personalizado. Consulte a documentação de localização do SDK jQuery⁠ para mais detalhes
• Agora existe um novo parâmetro translations, que deve ser usado para que seu locale personalizado funcione

Como sempre, seu feedback é muito bem-vindo! Aproveite!