PDFkind
Tài liệu cho nhà phát triển: API JavaScript

Trợ lý tải lên

API JavaScript

Giảm dung lượng PDF hoặc ảnh xuống dưới giới hạn ngay từ code của bạn với PDFkind.fit(file, { max }), và xử lý mọi kết quả trả về.

Script thêm một đối tượng toàn cục PDFkind. Hãy dùng nó khi file đến từ những nguồn mà chế độ tự động không theo dõi: dán, camera, trình chọn file tùy chỉnh.

PDFkind.fit(file, options)

JavaScript
try {
  const small = await PDFkind.fit(file, { max: '5MB' });
  upload(small);
} catch (err) {
  if (err.reason === 'too-big') alert('File này quá lớn, kể cả sau khi đã giảm dung lượng.');
  else upload(file);   // quay về dùng file gốc
}
Tùy chọnKiểuMô tả
maxstring hoặc numberBắt buộc. Cùng định dạng với data-pdfkind-max: 5MB, 500KB hoặc số byte.
elElementKhông bắt buộc. Thuộc tính data-lang của phần tử này (hoặc của phần tử cha) quyết định ngôn ngữ cửa sổ.

Hàm resolve với một File: file đã giảm dung lượng, file JPG đã chuyển đổi với ảnh HEIC, hoặc file gốc nếu đã vừa giới hạn (khi đó không mở cửa sổ nào). Hàm reject với một lỗi có reason là một trong các giá trị:

reasonÝ nghĩa
too-bigKể cả sau khi giảm, file vẫn vượt giới hạn.
unsupportedKhông phải PDF hoặc ảnh mà trợ lý có thể giảm dung lượng.
cancelKhách truy cập đã đóng cửa sổ.
unavailableCửa sổ PDFkind không tải được trong vòng 8 giây.
timeoutQuá trình xử lý mất hơn 3 phút.
failedFile bị hỏng, hoặc đã xảy ra lỗi khác.
bad-callHàm được gọi mà không có File hoặc không có max.

PDFkind.mount(root)

Biến các phần tử data-pdfkind-tool thành công cụ. Hàm tự chạy khi tải trang; hãy gọi lại sau khi thêm công cụ về sau, ví dụ trong ứng dụng một trang (SPA). root không bắt buộc, mặc định là toàn bộ trang.

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

PDFkind.version

Phiên bản script, hiện là 3. Tiện để kiểm tra script đã được tải chưa: gõ PDFkind.version trong console của trình duyệt.

Cập nhật lần cuối 3 tháng 11, 2026 · Câu hỏi: contact@pdfkind.com