Samuel Arendt

WordPress 7.2 traz o jQuery Migrate 3.6.0 e começa a preparação para o jQuery 4

O WordPress 7.2, com lançamento marcado para 8 de dezembro de 2026, vai sair com o jQuery Migrate 3.6.0. A equipe do core anunciou a mudança em 17 de novembro, no blog Make WordPress Core, como o primeiro passo para trocar o jQuery 3 pelo jQuery 4. O próprio jQuery continua na versão 3.7.1 nesta versão do WordPress, segundo o script-loader.php do repositório de desenvolvimento.

O plano da equipe do core em três versões

O anúncio descreve três etapas:

  1. No WordPress 7.2 (8 de dezembro), o jQuery Migrate 3.6.0, para que autores de temas e plugins vejam avisos sobre recursos que deixam de existir no jQuery 4.
  2. No WordPress 7.3, atualização para a versão mais recente do jQuery e do jQuery Migrate, além do jQuery UI e de outras bibliotecas que dependem do jQuery. O post chama esse passo de provisório e condicionado ao resultado dos testes.
  3. No fim de 2027 (WordPress 7.5 ou 7.6), o jQuery Migrate deixa de vir ligado por padrão, também sujeito a testes e a uma pesquisa sobre o impacto no ecossistema.

O jQuery 4.0.0 saiu em janeiro de 2026, e a versão 4.1.0 foi publicada no npm em 17 de novembro. A última troca de versão principal no WordPress, para o jQuery 3, foi feita em 2020 ao longo de várias versões, e a etapa final, desligar o Migrate por padrão, nunca chegou a acontecer. Desta vez o calendário já põe essa etapa no papel.

Quem precisa olhar para isso

O jQuery Migrate é uma camada de compatibilidade: ele devolve APIs que o jQuery removeu e, na versão de desenvolvimento, registra no console do navegador cada uso de API removida ou depreciada. Enquanto ele estiver carregado, código antigo tende a continuar funcionando, e o risco se concentra no momento em que ele deixar de vir ligado.

Quem mais depende dele são sites com tema próprio ou plugins escritos há anos, painéis administrativos customizados e plugins comerciais que ninguém atualiza mais. A lista de avisos do Migrate 3.x mostra o tipo de código afetado: jQuery.isArray, jQuery.trim, jQuery.parseJSON, jQuery.type, jQuery.isFunction, jQuery.now, .bind() e .unbind(), além de valores numéricos passados para .css() sem unidade.

Agências e times que mantêm muitos sites WordPress são os mais expostos, porque o problema se repete em cada combinação de tema e plugin.

O que fazer antes da 7.3

No dia 8 de dezembro nada deve quebrar por causa disso: o jQuery segue na série 3 e o Migrate continua ativo. O que muda é que agora existe uma ferramenta oficial para medir o tamanho do problema.

O detalhe prático é que a versão minificada do Migrate, a que roda em produção, não mostra os avisos. O WordPress carrega os arquivos de desenvolvimento quando a constante SCRIPT_DEBUG está ligada no wp-config.php. Então o levantamento precisa ser feito num ambiente de homologação com o 7.2 (o RC1 já está disponível) e SCRIPT_DEBUG ativo, navegando pelo site e pelo painel e anotando os avisos JQMIGRATE no console, por tema e por plugin.

Com essa lista, a decisão fica mais concreta: corrigir o código próprio, cobrar o fornecedor do plugin comercial ou trocar o plugin abandonado. Essa é a mesma escolha de manter uma versão suportada sem adiar a decisão de migração: o prazo real é o fim de 2027, mas o custo de corrigir cresce se o levantamento só começar quando o Migrate já tiver sido desligado.

Para quem atualiza o WordPress automaticamente, vale testar a 7.3 em homologação antes de liberar, já que ela pode trazer o jQuery 4 e um novo jQuery UI na mesma versão.

O que ainda não está definido

A data da 7.3 não foi anunciada, e a entrada do jQuery 4 nela depende dos testes. O post não diz qual versão do jQuery 4 será usada. O desligamento do Migrate está previsto para a 7.5 ou 7.6, sem data, e depende de uma pesquisa de impacto que ainda não foi publicada. Também não há, por enquanto, informação sobre algum mecanismo oficial para religar o Migrate depois que ele sair do padrão. O acompanhamento está no ticket 60478 do Trac do WordPress.

Se a sua empresa está avaliando algo parecido, me chama no LinkedIn ou no WhatsApp.

Referências

Estrutura de vigas metálicas brancas entrelaçadas vista de baixo contra o céu azul

Foto de Adrian Duenas no Unsplash

#Operações, #Qualidade de Software, #Radar