PDFkind
Dokumentacja dla programistów: API JavaScript

Asystent przesyłania

API JavaScript

Zmniejszaj plik PDF lub obraz do limitu rozmiaru z własnego kodu za pomocą PDFkind.fit(file, { max }) i obsłuż każdy możliwy wynik.

Skrypt dodaje globalny obiekt PDFkind. Użyj go, gdy pliki pochodzą ze źródła, którego tryb automatyczny nie widzi: ze schowka, z aparatu lub z niestandardowego selektora.

PDFkind.fit(file, options)

JavaScript
try {
  const small = await PDFkind.fit(file, { max: '5MB' });
  upload(small);
} catch (err) {
  if (err.reason === 'too-big') alert('Ten plik jest za duży, nawet po zmniejszeniu.');
  else upload(file);   // w razie problemu prześlij oryginał
}
OpcjaTypOpis
maxstring lub numberWymagana. Ten sam format co data-pdfkind-max: 5MB, 500KB lub liczba bajtów.
elElementOpcjonalna. Jego atrybut data-lang (lub atrybut elementu nadrzędnego) określa język okna.

Zwraca obietnicę rozwiązywaną obiektem File: zmniejszonym plikiem, przekonwertowanym plikiem JPG w przypadku zdjęć HEIC albo oryginałem, jeśli już mieści się w limicie (wtedy okno się nie otwiera). Odrzucana jest z błędem, którego reason ma jedną z wartości:

reasonZnaczenie
too-bigNawet po zmniejszeniu plik przekracza limit.
unsupportedTo nie jest plik PDF ani obraz, który asystent potrafi zmniejszyć.
cancelOdwiedzający zamknął okno.
unavailableOkno PDFkind nie załadowało się w ciągu 8 sekund.
timeoutPrzetwarzanie trwało dłużej niż 3 minuty.
failedPlik jest uszkodzony lub wystąpił inny błąd.
bad-callWywołano bez obiektu File lub bez max.

PDFkind.mount(root)

Zamienia elementy z data-pdfkind-tool w narzędzia. Uruchamia się samoczynnie po załadowaniu strony; wywołaj ją ponownie po późniejszym dodaniu narzędzi, na przykład w aplikacji jednostronicowej (SPA). Parametr root jest opcjonalny, a domyślnie obejmuje całą stronę.

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

PDFkind.version

Wersja skryptu, obecnie 3. Przydatna do sprawdzenia, czy skrypt jest załadowany: wpisz PDFkind.version w konsoli przeglądarki.

WsteczWordPress i kreatory formularzyDalej Osadzanie narzędzia

Ostatnia aktualizacja: 3 listopada 2026 · Pytania: contact@pdfkind.com