API JavaScript

Riduci un PDF o un’immagine entro un limite di dimensione dal tuo codice con PDFkind.fit(file, { max }) e gestisci ogni esito.

Lo script aggiunge un oggetto globale PDFkind. Usalo quando i file arrivano da una fonte che la modalità automatica non vede: incolla, fotocamera, selettore personalizzato.

PDFkind.fit(file, options)

JavaScript

try {
  const small = await PDFkind.fit(file, { max: '5MB' });
  upload(small);
} catch (err) {
  if (err.reason === 'too-big') alert('Questo file è troppo grande, anche dopo la riduzione.');
  else upload(file);   // ripiega sul file originale
}

Opzione	Tipo	Descrizione
`max`	stringa o numero	Obbligatoria. Stesso formato di `data-pdfkind-max`: `5MB`, `500KB` o byte.
`el`	Element	Facoltativa. Il suo `data-lang` (o quello di un elemento padre) imposta la lingua della finestra.

Si risolve con un File: quello ridotto, il JPG convertito per le foto HEIC, oppure l’originale se è già entro il limite (in quel caso non si apre alcuna finestra). Viene rifiutata con un errore il cui reason è uno dei seguenti:

reason	Significato
`too-big`	Anche dopo la riduzione, il file supera il limite.
`unsupported`	Non è un PDF né un’immagine che l’assistente può ridurre.
`cancel`	Il visitatore ha chiuso la finestra.
`unavailable`	La finestra PDFkind non si è caricata entro 8 secondi.
`timeout`	L’elaborazione ha richiesto più di 3 minuti.
`failed`	Il file è danneggiato, oppure si è verificato un altro problema.
`bad-call`	Chiamata senza un File o senza max.

PDFkind.mount(root)

Trasforma gli elementi data-pdfkind-tool in strumenti. Viene eseguito da solo al caricamento della pagina; richiamalo dopo aver aggiunto altri strumenti in seguito, ad esempio in una single-page app. root è facoltativo e per impostazione predefinita corrisponde all’intera pagina.

JavaScript

container.innerHTML = '<div data-pdfkind-tool="split-pdf"></div>';
PDFkind.mount(container);

PDFkind.version

La versione dello script, attualmente 3. Utile per verificare che lo script sia caricato: digita PDFkind.version nella console del browser.

PrecedenteWordPress e form builder Successiva Incorporare uno strumento

Ultimo aggiornamento: 3 novembre 2026 · Domande: contact@pdfkind.com