O admin do seu WordPress carrega 5 MB de JavaScript que você provavelmente nunca usa

Since WordPress 6.9, every admin screen loads about 40 block editor scripts for a Command Palette you may never open

Cada tela clássica do wp-admin pode ficar cerca de duas vezes mais rápida. Desde o WordPress 6.9, cada uma delas carrega uns 40 scripts do editor de blocos antes que você consiga clicar em qualquer coisa: React, a biblioteca de componentes, o editor de blocos, a camada de dados e mais. Eles estão lá por um único recurso, a Paleta de comandos, a caixa de busca que abre com Ctrl/Cmd+K. A paleta é útil. Mas ela só precisa desses scripts quando alguém a abre, e na maioria das visualizações de páginas do admin ninguém abre.

Já fazia um tempo que o wp-admin me parecia mais lento desde o 6.9, mas eu nunca tinha medido. Então medi, na página de admin de um plugin em um site de produção. 42 dos seus 59 scripts eram da paleta. Foi aí que decidi corrigir isso no núcleo do WordPress.

Meu patch carrega a paleta só quando ela é aberta. A paleta funciona exatamente como antes. Todo o resto fica mais rápido.

Os números

Medi Configurações > Geral e o Painel em uma instalação local do wordpress-develop (7.2-beta4) com Chromium headless. Cada valor é a mediana de 8 execuções pelo fluxo de login real, incluindo o pré-carregamento de recursos da tela de login.

WordPress hojeCom o patch
Scripts em Configurações > Geral8039
Baixado para o Painel após o login6,7 MB1,4 MB
Painel logo após o login282 ms155 ms
Configurações, todos os scripts já em cache98 ms49 ms
Painel logo após o login, CPU 4× mais lenta696 ms226 ms
Configurações, todos os scripts em cache, CPU 4× mais lenta362 ms123 ms

Os tempos são DOMContentLoaded, o momento em que a página está pronta para uso.

As linhas com cache foram as que mais me surpreenderam. Seria natural esperar que o cache do navegador resolvesse o problema. Não resolve. O cache evita o download, mas o navegador ainda precisa analisar, compilar e executar cada um desses scripts em todas as telas do admin. Em um notebook mais lento ou em um celular mais antigo, é aí que o tempo vai embora.

Também dá para ver isso. Nesta gravação, o botão Ajuda em Configurações > Geral é clicado a cada 150 ms enquanto a página carrega. À direita, sem a paleta carregada de antemão, o painel de Ajuda abre depois de cerca de 880 ms. À esquerda, o WordPress de hoje, a página só reage depois de cerca de 1.740 ms.

Teste separado, não faz parte da tabela acima: cache vazio, Chromium com CPU limitada em 4×, 20 Mbit/s e 40 ms de latência, em tempo real.

O que o patch faz

  • As telas do admin recebem um carregador de 1,4 KB em vez da paleta inteira.
  • Os scripts e estilos da paleta ficam aguardando em um <template> inerte no final da página.
  • No primeiro Ctrl/Cmd+K ou num clique no botão da barra de ferramentas, o carregador os adiciona e abre a paleta. A primeira abertura leva de 100 a 250 ms. Depois disso ela abre na hora, como antes.
  • O editor de posts e o editor do site carregam esses scripts de qualquer forma, então mantêm a paleta carregada de antemão, sem mudanças.
  • Plugins que adicionam seus próprios comandos ganham uma nova action enqueue_command_palette_assets, para que os comandos deles carreguem junto com a paleta. Isso surgiu de um comentário de revisão no pull request. Obrigado a todos que testaram.

A mudança vem com testes PHPUnit e testes end-to-end e está em revisão:

Se você mantém sites WordPress, pode ajudar. Teste o patch com o link do WordPress Playground no pull request e deixe seus resultados no ticket.

O que vem a seguir

O patch é um primeiro passo, não o fim. Mesmo com ele, abrir o Painel logo após o login ainda baixa 1,4 MB. Isso é muito para uma tela do admin. É o que vou analisar a seguir, para que o wp-admin fique mais rápido para todos.

Como manter o WordPress rápido?

Não se trata de culpa. A Paleta de comandos foi criada por bons motivos, por pessoas que se importam com o WordPress, e passou por revisão como qualquer outra mudança. Ela passou despercebida porque nada no processo mede o que acontece no navegador nas telas do admin.

O núcleo do WordPress já roda testes de desempenho em cada pull request. No wp-admin, eles medem a rapidez com que o servidor responde, não o que o navegador precisa carregar e executar depois. Uma mudança que adiciona dezenas de scripts a cada tela do admin é invisível para eles.

Vale a pena fechar essa lacuna, então propus uma mudança nos testes de desempenho do core. Eles passam a medir também o que o navegador carrega no wp-admin: o número e o tamanho dos scripts e folhas de estilo, e quando a página fica pronta. Uma verificação de orçamento compara cada pull request com o seu alvo. Se uma tela fica mais lenta e essa mesma tela também carrega mais código, a verificação falha. Mais código por si só não bloqueia uma mudança, porque recursos precisam de código, mas os revisores veem o crescimento na hora. Uma lentidão sem crescimento gera apenas um aviso, porque os tempos variam nos runners de CI. Se um custo é intencional e foi revisado, um rótulo o marca como aceito, e a decisão fica visível no pull request. Na mudança da Paleta de comandos, a verificação falha em todas as telas medidas.

Performance budget check failing for the Command Palette change because the screens got slower and loaded more scripts
O que a verificação proposta aponta na mudança da Paleta de comandos.

O objetivo: nenhuma versão do WordPress deve deixar o WordPress mais lento.

A discussão está no ticket, e a mudança está em um pull request:

O WordPress roda uma grande parte da web. Cada milissegundo economizado no wp-admin é economizado para milhões de pessoas todos os dias. Vamos garantir que ele só fique mais rápido.

Rene Hermenau

Autor: Rene Hermenau

Sobre o autor: René Hermenau é o fundador do WP STAGING. Ele trabalha com backups do WordPress, ambientes de staging, migrações, gestão de bases de dados e fluxos de implantação seguros.