Entwicklerdokumentation: JavaScript-API
Upload-Helfer
JavaScript-API
Verkleinern Sie ein PDF oder Bild aus Ihrem eigenen Code mit PDFkind.fit(file, { max }) auf ein Größenlimit und behandeln Sie jedes mögliche Ergebnis.
Das Script stellt ein globales PDFkind-Objekt bereit. Verwenden Sie es, wenn Dateien aus Quellen kommen, die der automatische Modus nicht erfasst: Zwischenablage, Kamera, eigene Dateiauswahl.
PDFkind.fit(file, options)
try {
const small = await PDFkind.fit(file, { max: '5MB' });
upload(small);
} catch (err) {
if (err.reason === 'too-big') alert('Diese Datei ist auch verkleinert zu groß.');
else upload(file); // auf das Original zurückgreifen
}| Option | Typ | Beschreibung |
|---|---|---|
max | String oder Zahl | Erforderlich. Gleiches Format wie data-pdfkind-max: 5MB, 500KB oder Bytes. |
el | Element | Optional. Sein data-lang (oder das eines übergeordneten Elements) bestimmt die Sprache des Fensters. |
Das Promise wird mit einem File erfüllt: der verkleinerten Datei, dem umgewandelten JPG bei HEIC-Fotos oder dem Original, wenn es bereits passt (dann öffnet sich kein Fenster). Andernfalls wird es mit einem Fehler abgelehnt, dessen reason einer der folgenden Werte ist:
| reason | Bedeutung |
|---|---|
too-big | Die Datei liegt auch verkleinert über dem Limit. |
unsupported | Kein PDF und kein Bild, das der Helfer verkleinern kann. |
cancel | Der Besucher hat das Fenster geschlossen. |
unavailable | Das PDFkind-Fenster wurde nicht innerhalb von 8 Sekunden geladen. |
timeout | Die Verarbeitung hat länger als 3 Minuten gedauert. |
failed | Die Datei ist beschädigt, oder ein anderer Fehler ist aufgetreten. |
bad-call | Aufruf ohne File oder ohne max. |
PDFkind.mount(root)
Wandelt data-pdfkind-tool-Elemente in Tools um. Die Funktion läuft beim Laden der Seite automatisch; rufen Sie sie erneut auf, wenn Sie später Tools hinzufügen, zum Beispiel in einer Single-Page-App. root ist optional und standardmäßig die gesamte Seite.
container.innerHTML = '<div data-pdfkind-tool="split-pdf"></div>';
PDFkind.mount(container);PDFkind.version
Die Version des Scripts, derzeit 3. Praktisch, um zu prüfen, ob das Script geladen ist: Geben Sie PDFkind.version in die Browser-Konsole ein.
Zuletzt aktualisiert am 3. November 2026 · Fragen: contact@pdfkind.com