Sharp: xử lý ảnh hiệu năng cao cho Node.js

Sharp là gì?

Sharp là một module Node.js cho xử lý ảnh tốc độ cao, xây trên thư viện C libvips thay vì JavaScript thuần. Sharp chuyển đổi và resize ảnh JPEG, PNG, WebP, GIF, AVIF và TIFF, và chạy được trên bất kỳ runtime JavaScript nào hỗ trợ Node-API v9, gồm Node.js từ bản 20.9.0 trở lên, Deno và Bun. Hầu hết hệ thống macOS, Windows và Linux hiện đại có thể chạy Sharp mà không cần cài thêm dependency native nào khác.

Định dạng hỗ trợ và các thao tác cốt lõi

• ✓Đọc và chuyển đổi JPEG, PNG, WebP, GIF, AVIF, TIFF, theo đúng danh sách định dạng mà README liệt kê
• ✓Resize dựa trên Lanczos resampling, nên chất lượng ảnh vẫn giữ được khi thu nhỏ kích thước
• ✓Xử lý đúng colour space, ICC profile nhúng trong ảnh, và kênh alpha transparency khi chuyển đổi
• ✓Ngoài resize còn có xoay ảnh, crop/extraction, composite và gamma correction
• ✓Nhận SVG làm input, hữu ích khi dùng làm mask hoặc overlay trong thao tác composite
• ✓Hoạt động như một stream, cho phép pipe một nguồn ảnh readable qua transform rồi ra writable output

Các use case phổ biến của Sharp

• •Tạo nhiều kích thước thumbnail cho pipeline upload trên web
• •Chuyển ảnh người dùng tải lên sang WebP hoặc AVIF trước khi lưu trữ để giảm dung lượng file
• •Resize ảnh sản phẩm ngay tại thời điểm gọi, phía sau một API route
• •Ghép overlay lên ảnh phía server, ví dụ mask bo góc hoặc watermark

Cài đặt Sharp

Chạy `npm install sharp`. Đó là toàn bộ đường cài đặt mà README thể hiện — không cần bước build hay file config nào cho use case thông thường. Với những gì nằm ngoài một câu lệnh đó, dự án dẫn sang một hướng dẫn cài đặt riêng trên trang docs thay vì viết chi tiết theo từng nền tảng ngay trong README.

Resize và chuyển đổi ảnh với ví dụ code

Import Sharp rồi chain các thao tác lại với nhau; cả ESM lẫn CommonJS đều dùng được. ```javascript // ESM import sharp from 'sharp'; // CJS const sharp = require('sharp'); ``` Resize và chuyển định dạng trong một lần gọi: ```javascript const output = await sharp('input.jpg') .autoOrient() .resize({ width: 200 }) .jpeg({ mozjpeg: true }) .toBuffer(); ``` Hoặc resize thẳng ra file với định dạng khác: ```javascript await sharp(inputBuffer) .resize({ width: 320, height: 240 }) .toFile('output.webp', (err, info) => { ... }); ``` Sharp cũng hoạt động như stream. Ví dụ bo góc trong README pipe một nguồn readable qua một lệnh `.composite()` dùng SVG mask rồi ra writable destination, không cần buffer toàn bộ ảnh trong bộ nhớ: ```javascript const roundedCorners = Buffer.from( '<svg><rect x="0" y="0" width="200" height="200" rx="50" ry="50"/></svg>' ); const roundedCornerResizer = sharp() .resize(200, 200) .composite([{ input: roundedCorners, blend: 'dest-in' }]) .png(); readableStream .pipe(roundedCornerResizer) .pipe(writableStream); ```

Lựa chọn thay thế cho Sharp

Khi nào nên chọn Sharp

Sharp phù hợp với đội đã dùng Node.js, Deno hoặc Bun và cần resize, chuyển đổi hoặc nén ảnh ngay trong luồng xử lý request của mình — một handler upload, một job tạo thumbnail, một API xử lý ảnh theo thời gian thực — và muốn việc đó chạy ngay trong tiến trình thay vì gọi ra binary ImageMagick. Sharp không hợp nếu bạn cần một thư viện xử lý ảnh JavaScript thuần, không phụ thuộc native, chẳng hạn cho một môi trường deploy giới hạn không cho phép biên dịch hay đóng gói binary native.

Câu hỏi thường gặp

Vấn đề mà Sharp giải quyết

Resize hoặc chuyển đổi ảnh trong một tiến trình Node.js thường nghĩa là gọi ra binary ImageMagick và chịu chi phí khởi động của nó, hoặc dùng một bộ giải mã thuần JavaScript vốn chậm hẳn với ảnh lớn hơn kích thước thumbnail. Chi phí đó tăng nhanh khi có nhiều request thật. Sharp bọc trực tiếp libvips trong một module Node-API native, nên resize, chuyển định dạng và ghép ảnh diễn ra ngay trong tiến trình với tốc độ của libvips, thay vì qua một tiến trình con hay một codec JS thuần chậm chạp.

Repo liên quan