Documentazione
/
Offuscamento VM
/

Utilizzo del pacchetto NPM

Utilizzo del pacchetto NPM

Pro

Guarda

Using the Obfuscator.io API: API Keys, npm Package, CLI and Custom Presets

Guarda su YouTube

Il pacchetto invia la build all'API di obfuscator.io, quindi richiede una chiave API (Pro, Team o Business) passata come apiToken, oppure --pro-api-token nella CLI. La creazione delle chiavi, le chiavi di servizio del team e come tenerle fuori dal codice del browser sono descritte nel Riferimento API.

Chiavi API

npm

Bash

production.json

JSON

Node.js (.mjs)

Codice

CLI

Codice

Quota

javascript-obfuscator 5.9.0 o successivo legge l'utilizzo che resta al tuo piano con getProQuota, così una build può verificare che i suoi file ci stiano prima di iniziare, invece di fallire a metà. Per ogni build si conteggia la dimensione del sorgente in byte (UTF-8), e almeno minBytesPerBuild; la dimensione dell'output non conta. Quando una build viene rifiutata perché un limite è esaurito, l'errore ApiError lanciato ha code impostato su dailyLimit o monthlyLimit, e il resetsAt di quella finestra indica quando ricomincia. Tutti i campi sono descritti nel Riferimento API.

Node.js (.mjs) con un controllo della quota

JavaScript

Preset personalizzati

Tieni la configurazione nella dashboard invece che in un file di configurazione: salva le opzioni correnti come preset personalizzato, assegnagli un alias API nella finestra di salvataggio e imposta optionsPreset su quell'alias. javascript-obfuscator 5.8.0 o successivo recupera il preset prima dell'offuscamento, quindi modificarlo nella dashboard modifica la build successiva senza alcun commit nel repository. Le opzioni del preset sono la base; tutto il resto della tua configurazione le sovrascrive, come per i preset integrati. Una chiave di servizio del team risolve i preset del proprietario del team. La chiave API di un membro risolve i suoi preset più quelli che il proprietario ha condiviso con il team.

Node.js (.mjs) con un preset

Codice

CLI con un preset

Codice

"optionsPreset": "production" in production.json fa lo stesso per una build con --config. I nomi integrati come vm-default non vengono mai cercati come alias. Un alias che non possiedi fallisce con HTTP 404 prima che venga inviato qualsiasi sorgente, e un preset personalizzato senza alcuna funzione Pro attiva viene offuscato localmente con le sue opzioni.

Il preset via REST

Un'integrazione REST diretta può indicare lo stesso alias in optionsPreset della richiesta di offuscamento, e il server lo risolve allo stesso modo. Per leggere le opzioni di un preset senza offuscare, usa l'endpoint dei preset. Entrambi sono documentati nel Riferimento API. Il pacchetto javascript-obfuscator recupera il preset una volta per esecuzione, e quella richiesta rientra nello stesso limite di frequenza per utente delle richieste di offuscamento.

I limiti di frequenza e il comportamento dei caricamenti di grandi dimensioni sono descritti nel Riferimento API, e i limiti del tuo piano sono mostrati nella dashboard; con i piani Team e Business il pacchetto passa automaticamente ai caricamenti temporanei per i sorgenti di grandi dimensioni.

Test e CI · Riferimento API