stamatios
← Voltar ao feed
Mala sendo comprimida por prensa até sobrar só o essencial, metáfora da redução do clarity.js
Dev & Engenharia · Big Tech

Microsoft reduz clarity.js em 4,5% com mais de 50 experimentos automatizados

resumo de ~3 min

Contexto e método

O texto é um relato técnico do blog do Microsoft Clarity sobre como a equipe reduziu o tamanho do clarity.js, o script que roda nos sites que usam o Clarity e captura os dados comportamentais por trás das análises. Como o script carrega junto com o restante da página, seu tamanho importa: quanto menor, menos JavaScript o navegador precisa baixar. O desafio era reduzi-lo sem perder funcionalidade nem compatibilidade com a variedade de sites suportados.

A equipe transformou o trabalho em um experimento automatizado. O agente de programação com IA pi, usando o autoresearch, fazia uma alteração, compilava o script, media a saída comprimida, rodava a suíte de testes e então mantinha ou revertia a mudança conforme o resultado. Após mais de 50 experimentos, o clarity.js ficou 1.257 bytes gzip menor, uma redução de 4,5%, sem perda de funcionalidade. O processo também mostrou que muitas mudanças que parecem mais eficientes no código-fonte não reduzem o script após a compressão.

Por que o código limpo perde para o gzip

O gzip substitui sequências repetidas de bytes por referências curtas. Por isso, código repetitivo custa quase nada, enquanto cada nome de função, padrão novo ou string única vira uma nova entrada no dicionário e consome bytes reais.

Em um caso, quatro blocos idênticos de rastreamento de coordenadas foram extraídos para uma função auxiliar. O tamanho bruto caiu 264 bytes, mas o gzip aumentou 23, porque ele já comprimia bem as repetições e a função nova introduziu um nome, uma assinatura e novas chamadas. Outras tentativas seguiram o mesmo padrão: um helper para largura e altura (+13), arrays compartilhados movidos para o escopo do módulo (+2) e o operador ||= (+3). Sobre este último, o texto observa que a sintaxe é mais curta, mas o padrão x = x || valor aparece com frequência e já está no dicionário do gzip, então a versão moderna comprime pior.

O que reduziu o tamanho

A maior economia, de 444 bytes gzip (35% do total), veio da eliminação de imports de namespace. Quando import * as módulo é usado como valor, por exemplo em arrays ou passado como argumento, o Rollup cria um objeto de runtime que envolve todas as exportações. Se o acesso for apenas a propriedades diretas, as chamadas são incorporadas sem esse invólucro. A troca por imports nomeados rendeu 324 bytes só no arquivo data/index.ts, que tinha 13 imports de namespace em uma tabela de despacho.

A remoção de funções inteiras economizou 84 bytes. Um trecho de 12 linhas que lia manualmente um ReadableStream foi substituído por uma única chamada à API Response (-44), e um wrapper redundante de JSON.parse saiu, já que o chamador tinha seu próprio try/catch.

As opções do terser renderam 301 bytes. A equipe testou cada uma isoladamente; a maioria não teve efeito, e as que ajudaram foram passes: 3, hoist_vars: true e freeze: false nas saídas IIFE do Rollup. A mangling de propriedades causou problemas reais, porque os nomes minificados colidiram com nomes de propriedades do DOM.

Trocar template literals por concatenação economizou 110 bytes, pois, com alvo ES5, o TypeScript compila template literals em chamadas de método concat. Já blocos grandes e únicos, com 20 linhas ou mais, podem compensar a extração: substituir 27 linhas de cópia de propriedades por Object.assign economizou 109 bytes.

A otimização que não foi lançada

A maior economia encontrada, de 2.308 bytes gzip, veio de elevar o alvo do TypeScript de ES5 para ES2017, o que eliminou os polyfills __awaiter e __generator, somado a recursos do ES2020. A equipe não pôde publicar a mudança por requisitos de compatibilidade. O Clarity roda em aplicações Angular com Zone.js, que faz patch em Promise e espera a saída de async/await baseada em geradores ES5. Com async/await nativo, o Zone.js não consegue interceptar as chamadas, e a detecção de mudanças do Angular quebra silenciosamente.

Por que o ciclo funciona

Cada ciclo de build e medição leva cerca de 35 segundos, e o agente testa cerca de 100 ideias em menos de uma hora, com a suíte de testes rodando a cada uma. Segundo a equipe, o agente também testa abordagens que provavelmente não seriam tentadas manualmente, como as 15 opções do terser.

Ao final, o texto recomenda: revisar imports de namespace usados como valor; testar opções do minificador uma a uma; remover funções inteiras quando possível; não extrair pequenos helpers para "limpar" código repetido; medir o tamanho gzip, e não o bruto; e automatizar, já que ganhos de 5 bytes não compensam o tempo de uma pessoa, mas valem 35 segundos de experimento automatizado.