Documentation développeurs : API JavaScript
Assistant d’envoi
API JavaScript
Réduisez un PDF ou une image sous une taille limite depuis votre propre code avec PDFkind.fit(file, { max }), et gérez chaque cas de figure.
Le script ajoute un objet global PDFkind. Utilisez-le quand les fichiers proviennent d’une source que le mode automatique ne voit pas : collage, caméra, sélecteur personnalisé.
PDFkind.fit(file, options)
try {
const small = await PDFkind.fit(file, { max: '5MB' });
upload(small);
} catch (err) {
if (err.reason === 'too-big') alert('Ce fichier est trop volumineux, même réduit.');
else upload(file); // à défaut, envoyer l’original
}| Option | Type | Description |
|---|---|---|
max | chaîne ou nombre | Obligatoire. Même format que data-pdfkind-max : 5MB, 500KB ou un nombre d’octets. |
el | Element | Facultatif. Son attribut data-lang (ou celui d’un parent) détermine la langue de la fenêtre. |
La promesse est résolue avec un File : le fichier réduit, le JPG converti pour les photos HEIC, ou l’original s’il respecte déjà la limite (aucune fenêtre ne s’ouvre alors). Elle est rejetée avec une erreur dont la propriété reason vaut l’une des valeurs suivantes :
| reason | Signification |
|---|---|
too-big | Même réduit, le fichier dépasse la limite. |
unsupported | Ce n’est ni un PDF ni une image que l’assistant sait réduire. |
cancel | Le visiteur a fermé la fenêtre. |
unavailable | La fenêtre PDFkind ne s’est pas chargée en 8 secondes. |
timeout | Le traitement a duré plus de 3 minutes. |
failed | Le fichier est endommagé, ou une autre erreur s’est produite. |
bad-call | Appel sans File ou sans max. |
PDFkind.mount(root)
Transforme les éléments data-pdfkind-tool en outils. La fonction s’exécute d’elle-même au chargement de la page ; appelez-la de nouveau après avoir ajouté des outils, par exemple dans une application monopage. root est facultatif et vaut par défaut la page entière.
container.innerHTML = '<div data-pdfkind-tool="split-pdf"></div>';
PDFkind.mount(container);PDFkind.version
La version du script, actuellement 3. Pratique pour vérifier que le script est chargé : tapez PDFkind.version dans la console du navigateur.
Dernière mise à jour : 3 novembre 2026 · Des questions ? contact@pdfkind.com