Usando o pacote NPM

O pacote envia o build para a API do obfuscator.io, então precisa de uma chave de API (Pro, Team ou Business) passada como apiToken, ou --pro-api-token na CLI. A criação de chaves, as chaves de serviço da equipe e como mantê-las fora do código do navegador são explicadas na Referência da API.

Chaves de API

npm

production.json

Node.js (.mjs)

CLI

Cota

O javascript-obfuscator 5.9.0 ou mais recente lê o uso que ainda resta no seu plano com getProQuota, para que um build possa verificar se os seus arquivos cabem antes de começar, em vez de falhar no meio do caminho. Cada build contabiliza o tamanho do seu código-fonte em bytes (UTF-8), e no mínimo minBytesPerBuild; o tamanho da saída não conta. Quando um build é recusado porque um limite se esgotou, o ApiError lançado tem code definido como dailyLimit ou monthlyLimit, e o resetsAt dessa janela indica quando ela recomeça. Todos os campos estão descritos na Referência da API.

Node.js (.mjs) com uma verificação de cota

Predefinições personalizadas

Mantenha a configuração no painel em vez de em um arquivo de configuração: salve as opções atuais como predefinição personalizada, dê a ela um alias da API no diálogo de salvamento e defina optionsPreset com esse alias. O javascript-obfuscator 5.8.0 ou mais recente busca a predefinição antes de ofuscar, então alterá-la no painel altera o próximo build sem nenhum commit no repositório. As opções da predefinição são a base; qualquer outra opção da sua configuração as sobrescreve, do mesmo modo que as predefinições integradas são mescladas. Uma chave de serviço da equipe resolve as predefinições do proprietário da equipe. A chave de API de um membro resolve as predefinições dele mais as que o proprietário compartilhou com a equipe.

Node.js (.mjs) com uma predefinição

CLI com uma predefinição

"optionsPreset": "production" em production.json faz o mesmo para um build com --config. Nomes integrados como vm-default nunca são buscados como alias. Um alias que você não tem falha com HTTP 404 antes de qualquer código-fonte ser enviado, e uma predefinição personalizada sem nenhum recurso Pro ativado é ofuscada localmente com as suas opções.

A predefinição via REST

Uma integração REST direta pode indicar o mesmo alias no optionsPreset da requisição de ofuscação, e o servidor o resolve da mesma forma. Para ler as opções de uma predefinição sem ofuscar, use o endpoint de predefinições. Ambos estão documentados na Referência da API. O pacote javascript-obfuscator busca a predefinição uma vez por execução, e essa requisição conta no mesmo limite de requisições por usuário que as requisições de ofuscação.

Os limites de requisições e o comportamento de uploads grandes estão descritos na Referência da API, e os limites do seu plano são exibidos no painel; nos planos Team e Business, o pacote passa automaticamente a usar uploads temporários para códigos-fonte grandes.

Testes e CI · Referência da API